Composio 集成技能

通过 Composio 的统一 API 访问 600+ 应用与服务。当前已连接：Gmail 和 Google Tasks。

🔑 API 密钥位置

安全存储于： /home/sidharth/clawd/memory/composio-credentials.md
同时位于： ~/.bashrc (第 135 行) - 终端启动时自动加载

API 密钥： ak_AXxQjyexBuSiJXTYOTPB

📦 已连接账户

Gmail (ca_0cxayHx2BME1)

• 邮箱： sonukumar5fr@gmail.com
• 状态： 活跃 ✅
• 功能： 读取/发送邮件、管理标签、草稿、联系人

Google Tasks (ca_kSNnWG4OHngG)

• 邮箱： sonukumar5fr@gmail.com
• 状态： 活跃 ✅
• 功能： 创建/更新/删除任务和任务列表

🛠️ 可用工具

Gmail 工具 (20+)

• GMAIL_FETCH_EMAILS - 获取邮件
• GMAIL_SEND_EMAIL - 发送邮件
• GMAIL_CREATE_EMAIL_DRAFT - 创建草稿
• GMAIL_REPLY_TO_THREAD - 回复邮件
• GMAIL_SEARCH_EMAILS - 搜索收件箱
• GMAIL_ADD_LABEL_TO_EMAIL - 管理标签
• GMAIL_DELETE_MESSAGE - 删除邮件
• 以及其他 13+ 个工具...

Google Tasks 工具 (17)

• GOOGLETASKS_INSERT_TASK - 创建任务
• GOOGLETASKS_LIST_TASKS - 列出任务
• GOOGLETASKS_LIST_ALL_TASKS - 列出所有列表中的任务
• GOOGLETASKS_UPDATE_TASK - 更新任务
• GOOGLETASKS_DELETE_TASK - 删除任务
• GOOGLETASKS_CREATE_TASK_LIST - 创建任务列表
• GOOGLETASKS_BULK_INSERT_TASKS - 批量创建任务
• 以及其他 10+ 个工具...

📝 使用示例

列出可用工具

export COMPOSIO_API_KEY="ak_AXxQjyexBuSiJXTYOTPB"
node scripts/list-tools.mjs gmail        # 仅 Gmail 工具
node scripts/list-tools.mjs googletasks  # 仅 Google Tasks 工具
node scripts/list-tools.mjs              # 所有工具（分页显示）

执行工具

获取 Gmail 邮件：

node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":5}'

创建 Google 任务：

node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"我的任务","notes":"任务详情"}'

发送邮件：

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{"to":"recipient@example.com","subject":"你好","body":"你好！"}'

🔧 实现细节

基础 URL (v3 API)

https://backend.composio.dev/api/v3/

认证

所有请求使用以下请求头：

x-api-key: ak_AXxQjyexBuSiJXTYOTPB

用户 ID

所有工具执行使用：

user_id: pg-test-228260f1-217f-40f6-a08a-41fdd0b8d8e6

脚本位置

/home/sidharth/clawd/skills/composio-integration/scripts/
├── list-tools.mjs       # 列出可用工具
├── execute-tool.mjs     # 执行任何工具
└── (未来脚本)

🎯 常见用例

早晨邮件摘要

node scripts/execute-tool.mjs GMAIL_FETCH_EMAILS ca_0cxayHx2BME1 '{"maxResults":10,"labelIds":["INBOX"]}'

从邮件添加任务

1. 获取邮件
2. 提取关键信息
3. 创建任务：

node scripts/execute-tool.mjs GOOGLETASKS_INSERT_TASK ca_kSNnWG4OHngG '{"title":"跟进：邮件主题","notes":"发件人：sender@example.com"}'

发送跟进邮件

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{
  "to":"client@example.com",
  "subject":"回复：您的咨询",
  "body":"感谢您的联系..."
}'

🔄 添加新应用

要连接更多应用（日历、Notion、Slack 等）：

1. 访问：https://app.composio.dev/apps
2. 在所需应用上点击“连接”
3. 完成 OAuth 流程
4. 记下 connected_account_id
5. 与 execute-tool.mjs 配合使用

📚 API 参考

完整 v3 API 文档： https://docs.composio.dev/rest-api/

使用的关键端点：
- GET /api/v3/tools - 列出工具
- GET /api/v3/tools/:slug - 获取工具模式
- POST /api/v3/tools/execute/:slug - 执行工具
- GET /api/v3/connected_accounts - 列出连接

✅ 已测试并正常工作

• ✅ API 密钥认证
• ✅ Gmail 邮件获取
• ✅ 工具发现 (600+ 应用)
• ✅ 连接账户管理
• ✅ v3 API 兼容性（无已弃用端点）

🚀 后续步骤

• [ ] 为常见任务创建包装函数
• [ ] 添加 Google 日历集成
• [ ] 构建邮件到任务的自动化流程
• [ ] 创建早晨摘要生成器
• [ ] 添加错误处理与重试逻辑

最后更新： 2026-01-20
状态： ✅ 完全正常运行
集成耗时： ~30 分钟