OpenClaw Composio 플러그인

공유 채널의 모든 사용자에게 Composio의 Tool Router를 통해 자신만의 인증된 도구(Gmail, Outlook, Notion, GitHub, Sentry, …)를 제공하세요 — 사용자별 OAuth는 전적으로 채팅에서 처리됩니다.

신뢰할 수 있는 각 메시지 발신자는 전용 Composio Tool Router 세션을 받으며, 이 세션은 요청자 범위(requester-scoped) MCP 서버로 에이전트에 전달됩니다. 한 사용자의 연결된 계정은 다른 사용자의 턴에서는 절대 접근할 수 없습니다. 검증된 발신자가 없는 실행(cron, 하위 에이전트, 하트비트)에는 Composio 도구가 전혀 제공되지 않습니다.

커뮤니티 플러그인 — 공식 @openclaw/* 패키지가 아닙니다. ClawHub에 obviyus 소유자 범위로 게시되었습니다.

설치(워크스페이스 관리자, 1회)

openclaw plugins install clawhub:@obviyus/composio

로컬 개발 시에는 대신 사이드로드하세요. plugins.load.paths가 이 리포지토리의 클론을 가리키게 하고 composio를 활성화하세요.

그런 다음 조직 수준 Composio API 키(Composio 대시보드에서 얻을 수 있음)를 COMPOSIO_API_KEY 환경 변수 또는 구성에서 제공하세요:

{
  "plugins": {
    "entries": {
      "composio": { "enabled": true, "config": { "apiKey": "ak_..." } }
    }
  },
  "mcp": {
    "servers": {
      // Identity declaration; the connection is resolved per user at run time.
      "composio": { "transport": "streamable-http", "url": "https://composio.invalid/unresolved" }
    }
  }
}

Related MCP server: Google Workspace MCP Server

사용법(최종 사용자, 구성 불필요)

에이전트에게 Composio로 접근할 수 있는 모든 것을 요청하세요: "내 Gmail 확인해 줘", "내 Sentry 대기열에 뭐가 있어?". 처음 사용하면 에이전트가 개인 OAuth 링크로 응답합니다. 연결한 후에는 도구가 작동합니다 — 해당 사용자에게만 바인딩됩니다. 계정 연결을 해제하면(Composio 대시보드 또는 채팅에서) 약 5분 이내에 적용됩니다.

Composio가 반환한 파일은 서명된 URL이 만료되거나 삭제되기 전에 OpenClaw의 보호된 미디어 저장소를 통해 다운로드됩니다. 에이전트는 답변에 첨부할 수 있는 관리형 MEDIA: 참조를 받습니다.

참고 사항

• 조직 API 키는 최종 사용자나 채팅에 절대 도달하지 않습니다. 사용자별 자격 증명은 Composio에 저장되며 OpenClaw 구성, 로그 또는 대화 기록에는 절대 닿지 않습니다.

• 요청자 범위(requester-scoped) MCP 연결(registerMcpServerConnectionResolver)을 지원하는 OpenClaw 릴리스가 필요합니다.

• 사용자별 세션은 호스트가 플러그인에 키 저장소(keyed store)를 부여한 경우에만(번들 또는 공식 신뢰 설치) 재시작 후에도 유지됩니다. 사이드로드된 경우 메모리 내 캐시로 대체됩니다 — 세션은 재시작 시 다시 발급되며 사용자가 다시 인증할 필요는 없습니다.

개발 및 릴리스

소스는 index.ts + src/에 있습니다. 테스트는 소스와 같은 위치에 있습니다(*.test.ts). dist/는 빌드 출력물이며 gitignore 처리됩니다. npm files 화이트리스트가 이를 게시 아티팩트에 포함합니다. ClawHub는 컴파일된 출력물(원시 .ts는 거부됨)을 요구하며, openclaw/* 임포트는 외부로 남겨둡니다(호스트가 런타임에 플러그인 SDK를 제공합니다).

릴리스는 태그 푸시입니다. 버전을 올리고, 태그를 달고, 푸시하세요 — GitHub Actions(.github/workflows/publish.yml)가 dist/를 빌드하고 ClawHub에 게시합니다:

# bump "version" in package.json, commit
git tag v0.1.2 && git push origin v0.1.2

1회 설정: CLAWHUB_TOKEN 리포지토리 시크릿을 추가하세요(ClawHub API 토큰 — ClawHub 설정에서 생성하거나 clawhub token으로 현재 토큰을 출력할 수 있습니다):

gh secret set CLAWHUB_TOKEN --repo obviyus/openclaw-composio

대신 수동으로 게시하려면(로컬에서도 빌드됩니다):

bun build ./index.ts --outdir ./dist --target node --format esm --external 'openclaw/*'
clawhub package publish . --source-repo obviyus/openclaw-composio --source-commit "$(git rev-parse HEAD)" --dry-run
clawhub package publish . --source-repo obviyus/openclaw-composio --source-commit "$(git rev-parse HEAD)"

유지보수자를 위한 참고 사항:

• openclaw.compat.pluginApi는 최소 호스트 버전을 제한합니다 — registerMcpServerConnectionResolver가 포함된 첫 OpenClaw 릴리스로 유지하세요.

• openclaw.build.openclawVersion과 컴파일된 dist/는 ClawHub 게시 검증에 필요합니다.

• Composio Tool Router API는 버전이 관리됩니다(/api/v3.1/...). Composio가 버전을 올릴 때 src/tool-router.ts의 호환성이 깨지는 변경 사항을 주의하세요.