connect

连接

使用 Composio CLI 将 Codex 连接到任何应用。别再生成你能做什么的文字——直接从 Shell 执行。

何时使用此技能

当你需要 Codex 执行以下操作时，请使用此技能：

• 发送那封邮件，而不是起草邮件
• 创建那个问题，而不是描述它
• 发布那条消息，而不是提出建议
• 更新那个数据库，而不是解释方法

有何不同

不使用 Connect	使用 Connect
“这是邮件草稿……”	发送邮件
“你应该创建一个问题……”	创建问题
“把这条内容发到 Slack……”	发布内容
“把这个添加到 Notion……”	添加内容

支持的应用

包含 1000 多种集成，例如：

• 邮件： Gmail、Outlook、SendGrid
• 聊天： Slack、Discord、Teams、Telegram
• 开发： GitHub、GitLab、Jira、Linear
• 文档： Notion、Google Docs、Confluence
• 数据： Sheets、Airtable、PostgreSQL
• CRM： HubSpot、Salesforce、Pipedrive
• 存储： Drive、Dropbox、S3
• 社交： Twitter、LinkedIn、Reddit

设置

1. 安装 Composio CLI

curl -fsSL https://composio.dev/install | bash

2. 登录

composio login
composio whoami

这会打开浏览器进行身份验证，并让你选择默认组织和项目。在自动化流程中使用 -y 可跳过提示。

3. 连接所需的工具包

composio link github
composio link gmail
composio link slack

每个命令都会引导你完成一次 OAuth，之后连接会持续有效。

完成。现在，Codex 可以从 Shell 操作任何已连接的应用。

核心工作流

1. 知道工具的 slug？ → composio execute
2. 不知道 slug？ → composio search
3. 需要确认输入？ → composio execute --get-schema 或 --dry-run
4. 工具包尚未连接？ → composio link <toolkit>，然后重试
5. 需要多个步骤？ → 工作流使用 composio run，原始 API 调用使用 composio proxy

示例

查找工具

composio search "create a github issue"
composio search "send an email" --toolkits gmail

调用前检查输入

composio tools info GITHUB_CREATE_ISSUE
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

发送邮件

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "[email protected]",
  "subject": "Shipped!",
  "body": "v2.0 is live, let me know if issues"
}'

创建 GitHub 问题

composio execute GITHUB_CREATE_ISSUE -d '{
  "owner": "my-org",
  "repo": "repo",
  "title": "Mobile timeout bug",
  "labels": ["bug"]
}'

发布到 Slack

composio execute SLACK_SEND_MESSAGE -d '{
  "channel": "engineering",
  "text": "Deploy complete - v2.4.0 live"
}'

并行运行调用

composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

使用 composio run 串联操作

composio run '
  const issues = await search("github issues labeled bug this week");
  const summary = issues.map(i => `- ${i.title}`).join("\n");
  await execute("SLACK_SEND_MESSAGE", {
    channel: "bugs",
    text: `This week’s bugs:\n${summary}`
  });
'

从文件加载可复用的工作流：

composio run --file ./workflow.ts -- --repo composiohq/composio

原始 API 访问（proxy）

没有专用工具时，直接调用经过身份验证的 API：

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile \
  --toolkit gmail

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts \
  --toolkit gmail -X POST -H 'content-type: application/json' \
  -d '{"message":{"raw":"..."}}'

工作原理

1. 你提出请求，让 Codex 执行某项操作
2. Codex 通过 composio search 或已有知识选择 slug
3. CLI 检查连接，若未连接，则提示运行 composio link
4. 执行操作，调用真实 API，并将 JSON 返回到标准输出

配置

全局标志：

• --log-level <all|trace|debug|info|warning|error|fatal|none>
• --help 查看各命令的文档

环境变量：

• COMPOSIO_API_KEY - 身份验证凭据（用于非交互式场景）
• COMPOSIO_BASE_URL - 自定义 API 端点
• COMPOSIO_SESSION_DIR - 覆盖制品存储位置
• COMPOSIO_DISABLE_TELEMETRY=true - 选择退出遥测

类型安全 SDK（可选）

如果你想从应用而非 Shell 调用工具，可以生成带类型的客户端代码：

composio generate ts    # TypeScript types
composio generate py    # Python types

标志：-o <dir>、--toolkits <list>、--compact、--transpiled、--type-tools。

故障排除

• Not logged in → 运行 composio login
• Connection required for <toolkit> → 运行 composio link <toolkit>
• 未知 slug → 运行 composio search "<what you want>" 或 composio tools list <toolkit>
• 输入有误 → 运行 composio execute <SLUG> --get-schema，然后运行 --dry-run
• 操作失败 → 检查目标应用中的权限

完整参考：docs.composio.dev/docs/cli

---

加入 20,000 多名开发者，共同打造可交付成果的智能体