ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

用 connect-apps 技能把 Claude 接入 1000+ 应用:Composio CLI 实战指南

用 connect-apps 技能把 Claude 接入 1000+ 应用:Composio CLI 实战指南 用 connect-apps 技能把 Claude 接入 1000 应用Composio CLI 实战指南【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills导读本指南基于 awesome-codex-skills 仓库中的 connect-apps 技能系统讲解如何通过 Composio CLI 让 Claude/Codex 真正操作 Gmail、Slack、GitHub、Notion 等 1000 外部服务——发邮件、建 Issue、发消息而不是只生成一段关于如何做的文字。读完本文你将掌握从安装登录、链接应用、执行工具到多步工作流、原始 API 代理、故障排查的完整实战闭环并能结合仓库内 issue-triage、pr-review-ci-fix、datadog-logs 等同族技能看到它在真实场景中的落地方式。connect-apps 是什么connect-apps是 awesome-codex-skills 仓库中用于应用连接的 Codex 技能之一。它的核心定位是把 AI Agent 与外部应用之间的最后一公里打通。技能的 frontmatter 明确给出了触发时机与能力边界name: connect-apps description: Connect Claude to external apps via the Composio CLI. Use this skill when the user wants to send emails, create issues, post messages, or take actions across Gmail, Slack, GitHub, Notion, and 1000 services from the terminal.一句话概括当用户说给 sarah 发一封关于发布的邮件、在 GitHub 上建一个修复登录 Bug 的 Issue、往 Slack 的 #general 发一条部署完成的消息时Codex/Claude 就应触发该技能把自然语言诉求翻译成一条条 Composio CLI 命令直接在终端里执行真实操作。在仓库的 README 技能清单 中它与connect/面向 Codex 的姊妹技能并列于Productivity Collaboration分类两者共享同一套 Composio CLI 底座区别仅在于触发主体与文档侧重connect面向 Codex 用户connect-apps面向 Claude 用户。快速上手四步完成连接第 1 步安装 Composio CLIcurl -fsSL https://composio.dev/install | bash这是官方一键安装脚本会在当前环境安装composio命令。仓库内所有基于 Composio CLI 的技能issue-triage、pr-review-ci-fix、datadog-logs 等都以这一行为前置条件。第 2 步登录composio login composio whoamicomposio login会打开浏览器完成认证随后提示你选择默认的组织org和项目project。composio whoami用于验证当前登录身份与上下文是否就绪。在脚本化、无人值守的场景中可加-y跳过所有交互式提示或用环境变量COMPOSIO_API_KEY完成非交互认证详见下文配置一节。第 3 步链接你需要的应用composio link gmail composio link slack composio link github每个composio link toolkit命令会走一次 OAuth 授权流程授权成功后连接会持久化保存之后无需重复授权。注意这里的参数是工具包toolkit而非单个动作——一个 toolkit 对应一个外部应用的全部工具集合。第 4 步试跑一个动作composio execute GMAIL_SEND_EMAIL -d { recipient_email: YOUR_EMAILexample.com, subject: Composio test, body: Hello from the CLI }如果收件箱里收到了这封测试邮件说明整条链路CLI → 认证 → 应用 API已完全打通。这一步是整个技能可用性的验收标准能真正把邮件发出去而不是生成一封邮件的草稿文本。能力对照从建议到执行技能的核心理念可以用一个对比表直观呈现——同样的诉求在没有连接能力与有连接能力时的差异对 Claude 说Claude 执行的真实操作给 sarahacme.com 发送关于发布的邮件composio execute GMAIL_SEND_EMAIL -d {...}创建 GitHub Issue修复登录 Bugcomposio execute GITHUB_CREATE_ISSUE -d {...}往 Slack #general 发部署完成composio execute SLACK_SEND_MESSAGE -d {...}把会议纪要加入 Notioncomposio execute NOTION_CREATE_PAGE -d {...}姊妹技能 connect/SKILL.md 中的 What Changes 对照表把这层含义说得更直白没有 Connect 时Agent 只会给出这是邮件草稿……、你应该建一个 Issue……有了 ConnectAgent 直接发送邮件、创建 Issue、发布消息、写入 Notion。从生成文字到采取行动就是这套技能存在的全部意义。核心工作流五步决策法connect-apps文档提炼了一个在任何场景下都适用的核心决策流程知道工具 slug→composio execute SLUG -d {...}直接执行不知道 slug→composio search 你想做的事搜索发现不确定入参结构→composio execute SLUG --get-schema或--dry-run先探查应用未连接→composio link toolkit链接后重试需要多步编排→composio run跑 JS/TS 工作流composio proxy访问原始 API这套流程在仓库的其他技能中得到了反复印证。例如 issue-triage 明确建议先用--get-schema确认字段形状Linear 使用嵌套对象、Jira 使用 JQL 字符串pr-review-ci-fix 也要求首次使用前务必composio execute SLUG --get-schema。这说明**先探查再执行不是可选项而是这套 CLI 体系的约定俗成**。常用命令速查发现与探查工具# 按意图搜索工具 composio search create a github issue composio search send an email --toolkits gmail # 限定在某个 toolkit 内搜索 # 列出某个 toolkit 的全部工具 composio tools list gmail # 查看某个工具的元信息 composio tools info GITHUB_CREATE_ISSUE执行前的安全检查# 查看 GITHUB_CREATE_ISSUE 的入参 schema字段名、类型、必填项 composio execute GITHUB_CREATE_ISSUE --get-schema # 干跑不真正执行只校验输入是否合法 composio execute GITHUB_CREATE_ISSUE --dry-run -d {owner:acme,repo:app,title:Bug}--get-schema与--dry-run是坏输入类故障的第一道防线前者告诉你参数长什么样后者在不动真实数据的前提下验证你给出的 JSON 是否合规。并行执行多个动作composio execute --parallel \ GMAIL_FETCH_EMAILS -d {max_results: 2} \ GITHUB_GET_THE_AUTHENTICATED_USER -d {}--parallel把多个独立动作一次性发出适合拉取收件箱 获取当前用户信息这类互不依赖的批量任务。但要注意 pr-review-ci-fix 的告诫对同一仓库的写操作要避免--parallel防止速率限制批量编辑场景建议在composio run循环中插入 250ms 的 sleep见 issue-triage。多步工作流composio run当单条命令无法表达先查询、再加工、后发送的链路时用composio run编写 JS/TS 脚本composio run const issue await execute(GITHUB_CREATE_ISSUE, { owner: acme, repo: app, title: Bug, body: ... }); console.log(issue); connect/SKILL.md 给出了一个更贴近实战的链式示例——拉取本周 bug 列表并汇总发到 Slackcomposio 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仓库对此的实践非常充分issue-triage 的scripts/triage-linear.ts用execute(LINEAR_LIST_ISSUES)拉取积压 Issue、本地过滤出 14 天未动的条目、再逐个LINEAR_CREATE_COMMENT催办并SLACK_SEND_MESSAGE汇报结果datadog-logs 的dd-incident.ts则用-- --service checkout传入服务名参数一次查询采样日志、一次做聚合统计。这些文件展示了composio run在真实技能中的标准写法。原始 API 代理composio proxy当某个外部应用没有对应的专用工具slug时composio proxy让你直接调用已认证的原始 API# GET 请求读取 Gmail 用户资料 composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile \ --toolkit gmail # POST 请求创建一封草稿 composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts \ --toolkit gmail -X POST -H content-type: application/json \ -d {message:{raw:...}}--toolkit参数指定使用哪个已链接应用的认证凭据-X、-H、-d与 curl 语义一致。它的典型用法包括调用 SDK 尚未封装的接口、流式下载大体积日志后在本地 grep见 pr-review-ci-fix、以及构造自定义请求体。支持的应用矩阵connect-apps文档列举了按场景划分的应用覆盖1000 集成Email邮件Gmail、Outlook、SendGridChat聊天Slack、Discord、Teams、TelegramDev开发GitHub、GitLab、Jira、LinearDocs文档Notion、Google Docs、ConfluenceData数据Sheets、Airtable、PostgreSQL还有 1000 更多……姊妹技能 connect/SKILL.md 补充了更多分类CRMHubSpot、Salesforce、Pipedrive、StorageDrive、Dropbox、S3、SocialTwitter、LinkedIn、Reddit。值得注意的是这套矩阵在本仓库中几乎一技能一应用地落地了composio-skills/目录下存放着数百个*-automation技能如gmail-automation/、slackbot-automation/、github-automation/外加 issue-triageLinear/Jira、datadog-logsDatadog等复合技能。connect-apps是这些细分技能的通用基座——先学会它再上手任何具体应用都会一通百通。典型实战示例发送一封邮件composio execute GMAIL_SEND_EMAIL -d { recipient_email: sarahacme.com, subject: Shipped!, body: v2.0 is live, let me know if issues }创建 GitHub Issuecomposio 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 }真实技能中的组合用法在 pr-review-ci-fix 中一次完整的 PR 评审包含拉取 PR 元数据、列出变更文件、发布带行内评论的评审意见composio execute GITHUB_GET_A_PULL_REQUEST \ -d {owner:acme,repo:app,pull_number:482} composio execute GITHUB_LIST_PULL_REQUESTS_FILES \ -d {owner:acme,repo:app,pull_number:482} composio execute GITHUB_CREATE_A_REVIEW_FOR_A_PULL_REQUEST -d { owner:acme,repo:app,pull_number:482, event:COMMENT, body:Overall LGTM with 2 blocking notes., comments:[ {path:src/auth.ts,line:42,body:Missing null check on session}, {path:src/auth.ts,line:88,body:Token TTL is hardcoded; move to config} ] }在 datadog-logs 中查询结果以 JSON 输出到 stdout可直接管道给jq做本地聚合composio execute DATADOG_SEARCH_LOGS -d { filter: {query:service:api status:error,from:now-30m,to:now}, page:{limit:500} } | jq -r .data[].attributes.message | sort | uniq -c | sort -rn | head配置项说明环境变量变量作用COMPOSIO_API_KEY非交互场景的认证凭据脚本、CI 中替代composio loginCOMPOSIO_BASE_URL自定义 API 端点私有化部署或代理场景COMPOSIO_SESSION_DIR覆盖工件artifact存储目录COMPOSIO_DISABLE_TELEMETRYtrue关闭遥测上报全局标志--log-level all|trace|debug|info|warning|error|fatal|none控制日志输出粒度排查问题时建议开到trace或debug--help查看每条子命令的详细帮助类型安全 SDK可选进阶当需要从应用程序代码而非 shell中调用工具时可生成类型化的客户端代码composio generate ts # TypeScript 类型 composio generate py # Python 类型支持标志-o dir输出目录、--toolkits list限定工具包、--compact、--transpiled、--type-tools。这是把同一套工具能力嵌入到自研应用中的桥梁。故障排查速查表症状处理方式Not logged in运行composio loginConnection required for toolkit运行composio link toolkit未知 slugcomposio search 目标或composio tools list toolkit入参错误先composio execute SLUG --get-schema再--dry-run验证动作执行失败检查目标应用侧的权限配置仓库内各技能还在这一基础表上补充了具体应用的坑位值得一并收藏issue-triageLinear 返回 403 → 用正确的 workspace 重新composio link linearJira 自定义字段缺失 → 在fields数组中显式请求批量写入被限流 → 循环内加 250ms sleep。pr-review-ci-fix日志下载过大 → 用composio proxy流式拉取 本地 grep速率限制 → 串行化调用、降低轮询频率。datadog-logs空结果 → 确认env:/service:标签且站点区域正确403 → APP key 缺少logs_read权限需重新生成并重新链接。如何把该技能装入你的 Codex/Claude 环境connect-apps是仓库中的标准技能目录结构与仓库内所有技能一致——每个技能目录下都有一个带 YAML frontmatternamedescription的SKILL.mdCodex/Claude 依据 frontmatter 中的 description 决定何时触发该技能加载正文后才占用上下文保持对话精简见 README.md。安装方式有两种Skill Installer推荐使用仓库自带的 skill-installer 脚本将技能安装到$CODEX_HOME/skills默认为~/.codex/skills安装完成后重启 Codex 即可生效。手动安装把connect-apps/目录复制到$CODEX_HOME/skills/下重启 Codex然后在会话中自然描述需求如帮我发封邮件Codex 会依据description自动触发该技能。安装后配合技能正文中的命令你就拥有了一个会动手的 Agent在终端里向 Claude/Codex 描述意图它自动执行composio link、composio execute、composio run把真实世界的操作闭环起来。小结connect-apps技能的价值可以浓缩为一句话用一条命令把 AI 从文字生成器升级为行动执行器。它通过 Composio CLI 提供了安装、登录、链接、执行、搜索、探查、并行、编排、代理、配置、排障的完整工具链并已被仓库内 issue-triage、pr-review-ci-fix、datadog-logs 等十数个技能作为公共底座反复使用。无论你是要自动化邮件、Issue 管理、CI 修复还是日志排查从这篇指南出发再结合对应细分技能文档即可快速上手真实应用的操作自动化。【免费下载链接】awesome-codex-skillsA curated list of practical Codex skills for automating workflows across the Codex CLI and API.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-codex-skills创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表