OpenClaw Composio Plugin

共有チャンネルのすべてのユーザーに、Composio の Tool Router を通じて、各自専用の認証済みツール（Gmail、Outlook、Notion、GitHub、Sentry、…）を提供します。ユーザーごとの OAuth はすべてチャット内で処理されます。

信頼されたメッセージ送信者ごとに、専用の Composio Tool Router セッションが割り当てられ、リクエスタースコープの MCP サーバーとしてエージェントに配信されます。あるユーザーの接続済みアカウントが、別のユーザーのターンからアクセスされることは決してありません。検証済みの送信者がない実行（cron、サブエージェント、ハートビート）には、Composio ツールは一切提供されません。

コミュニティプラグイン — 公式の @openclaw/* パッケージではありません。obviyus オーナースコープで ClawHub に公開されています。

インストール（ワークスペース管理者、一度だけ）

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 の設定、ログ、トランスクリプトに触れることはありません。

• リクエスタースコープの MCP 接続（registerMcpServerConnectionResolver）を備えた OpenClaw リリースが必要です。

• ユーザーごとのセッションは、ホストがプラグインにキー付きストアを許可した場合（バンドル版または信頼された公式インストール）のみ、再起動後も保持されます。サイドロードの場合、インメモリキャッシュにフォールバックし、再起動時にセッションは再生成されますが、ユーザーが再認証する必要はありません。

開発とリリース

ソースは 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

一度だけの設定：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 の破壊的変更に注意してください。