第4天：让AI助手连接你的世界 — 工具接入实战

AI助手的"手"在哪里？

前两天你的助手已经会聊天了，也有了个性。但它现在还像一个被困在对话框里的天才——只能说话，不能做事。

今天，我们要给这个大脑装上手。

在怡途Claw中，"手"就是工具（Tools）——AI助手可以调用的外部服务和API。通过工具系统，你的助手可以：

• 读取和发送邮件
• 查看和管理日历
• 搜索互联网
• 读写文件
• 调用任意API
• 执行数据库查询

---

工具系统的工作原理

当你说"帮我查一下今天有没有收到张三的邮件"时，背后发生了什么：

1. AI理解你的意图 → "需要查询Gmail"
2. AI调用 gmail_search 工具，参数 { from: "张三", after: "today" }
3. 工具返回查询结果
4. AI把结果整理成人话回复你

整个过程不到2秒。你不需要知道Gmail的API怎么调——AI助手帮你做了翻译。

---

接入Gmail（10分钟）

Step 1：获取Gmail API凭证

1. 打开 Google Cloud Console
2. 创建新项目 → 启用Gmail API
3. 创建OAuth 2.0客户端ID → 下载credentials.json

Step 2：在怡途Claw中配置

进入Agent详情 → 工具管理 → 添加工具 → 选择"Gmail"：

工具名称：gmail
权限范围：
  ✅ 读取邮件（gmail.readonly）
  ✅ 发送邮件（gmail.send）
  ✅ 搜索邮件（gmail.search）

上传credentials.json，完成OAuth授权流程。

Step 3：测试

给你的助手发一条消息：

查一下我最近3天的未读邮件，按重要性排序。

如果配置成功，它会返回一个格式化的邮件摘要。

---

接入Google Calendar（5分钟）

同样的流程：

1. Google Cloud Console → 启用Google Calendar API
2. 在怡途Claw中添加Calendar工具
3. 授权后即可使用

测试一下：

我明天有什么安排？

如果下周三下午3点有空，帮我安排一个"产品评审"会议，提前15分钟提醒我。

---

接入网页搜索（2分钟）

搜索工具不需要额外的API授权：

在怡途Claw工具管理中直接开启"网页搜索"开关即可。

测试：

帮我搜一下2026年AI Agent行业的最新趋势，用中文总结3个要点。

---

自定义API工具（进阶）

除了预置工具外，你还可以添加任何REST API作为工具：

在工具管理 → 添加自定义工具：

{
  "name": "get_stock_price",
  "description": "查询股票实时价格",
  "method": "GET",
  "url": "https://api.example.com/stock/{symbol}",
  "parameters": {
    "symbol": "股票代码，如 AAPL"
  }
}

配置好后，你的助手就能直接调用这个API了。

---

工具使用的安全原则

在给助手赋予工具能力时，请遵循以下原则：

1. 最小权限原则：只开必要的权限。比如Gmail只需要读权限的场景，就不要开发邮件权限
2. 操作确认：对于写操作（发送邮件、删除文件、修改日历），建议开启"需人工确认"模式
3. 用量监控：在怡途Claw仪表盘可以看到每个工具的调用量和耗时
4. 定期审计：每月检查一下助手都调用了哪些工具，有没有异常

---

今日任务

• 至少接入一个工具（推荐从搜索或邮件开始）
• 测试工具调用：发一条需要工具才能完成的消息
• 检查工具调用日志，确认调用成功
• 规划：列出你最希望助手帮你自动化的3个外部操作

工具是AI助手价值的分水岭。有了手的大脑，才能从"聊天"变成"办事"。