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 任务工具 (17)

• GOOGLETASKS_INSERT_TASK- 创建任务
• GOOGLETASKS_LIST_TASKS- 列出任务
• 列出所有任务- 列出所有列表中的所有任务
• 更新任务- 更新任务
• 删除任务- 删除任务
• 创建任务列表- 创建任务列表
• 批量插入任务- 批量创建任务
• 以及10+ 更多...

📝 使用示例

列出可用工具

export COMPOSIO_API_KEY="ak_AXxQjyexBuSiJXTYOTPB"
node scripts/list-tools.mjs gmail        # Gmail tools only
node scripts/list-tools.mjs googletasks  # Google Tasks tools
node scripts/list-tools.mjs              # All tools (paginated)

执行工具

获取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":"My Task","notes":"Task details"}'

发送邮件：

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{"to":"recipient@example.com","subject":"Hello","body":"Hi there!"}'

🔧 实现细节

基础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       # List available tools
├── execute-tool.mjs     # Execute any tool
└── (future scripts)

🎯 常见使用场景

早晨邮件摘要

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":"Follow up: Email subject","notes":"From: sender@example.com"}'

发送跟进邮件

node scripts/execute-tool.mjs GMAIL_SEND_EMAIL ca_0cxayHx2BME1 '{
  "to":"client@example.com",
  "subject":"Re: Your inquiry",
  "body":"Thank you for reaching out..."
}'

🔄 添加新应用

要连接更多应用（日历、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
• - 列出工具- 获取工具模式
• POST /api/v3/tools/execute/:slug- 执行工具
• GET /api/v3/connected_accounts- 列出连接

✅ 已测试且正常工作

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

🚀 下一步

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

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