OpenClaw Composio Plugin

让共享频道中的每个用户都拥有自己的认证工具（Gmail、Outlook、Notion、GitHub、Sentry 等），通过 Composio 的 Tool Router 实现——每个用户的 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 仪表板或在聊天中）大约五分钟内生效。

Composio 返回的文件会在其签名 URL 过期或被编辑之前，通过 OpenClaw 的受保护媒体存储下载。代理会收到一个受管理的 MEDIA: 引用，可以附加到回复中。

备注

• 组织 API 密钥永远不会到达最终用户或聊天；每个用户的凭据存储在 Composio 中，永远不会触及 OpenClaw 配置、日志或记录。

• 需要具有请求者作用域 MCP 连接的 OpenClaw 版本（registerMcpServerConnectionResolver）。

• 仅当主机授予插件键控存储（捆绑或受信任的官方安装）时，每个用户的会话才会在重启后持续存在。侧载时，它会回退到内存缓存——会话在重启时重新生成，用户无需重新认证。

开发与发布

源代码位于 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 中的破坏性更改。