Gmail

工作原理

/add-gmail 技能将 NanoClaw 连接到你的 Gmail 账户。与消息通道技能不同，Gmail 提供两种截然不同的模式——你可以在设置时选择适合自己工作流的模式。

工具模式赋予智能体按需读取、发送、搜索和起草邮件的能力。智能体不会自动监控你的收件箱，而是由你从消息通道中触发邮件操作：“查看我的收件箱”、“给 Sarah 发一封关于会议的邮件”或”搜索上个月的发票”。此模式所需的代码改动最少——它将你的 Gmail 凭据挂载到容器中，并添加一个 MCP 服务器为智能体提供邮件工具。

通道模式则更进一步。Gmail 成为一个完整的 NanoClaw 通道，就像 WhatsApp 或 Telegram 一样。智能体会轮询你的收件箱，查找符合特定条件的新消息，并可以直接回复。你可以设置定时任务，如”每天早上8点总结我的未读邮件”，或让智能体自动处理特定类型的邮件。此模式会应用完整的技能引擎，并将 GmailChannel 类添加到代码库中。

OAuth 设置

两种模式都需要通过 Google Cloud Platform 进行 OAuth 2.0 认证。技能会引导你创建 GCP 项目、启用 Gmail API 并下载 OAuth 客户端凭据。然后你通过浏览器授权 NanoClaw 访问你的 Gmail 账户。

凭据存储在本地的 ~/.gmail-mcp/ 目录中，并挂载到容器内。凭据包含刷新令牌，因此很少需要重新认证。MCP 服务器（@gongrzhe/server-gmail-autoauth-mcp）会自动处理令牌刷新。

智能体能做什么

Gmail 设置完成后，智能体可以使用以下功能：

• 读取邮件 — 获取最近的消息、阅读特定会话线程、查看未读数量。
• 发送邮件 — 撰写并发送新邮件或回复。
• 搜索 — 使用 Gmail 的搜索语法查找特定邮件。
• 起草 — 创建草稿而不发送，供你审阅。

在通道模式下，智能体还可以接收收到的邮件作为触发，并在线程中回复。

使用建议

• 如果你只是需要偶尔从 WhatsApp 或 Telegram 访问邮件，工具模式是更轻量的选择。通道模式适合希望智能体主动管理邮件的用户。
• 处于”测试”模式的 GCP 项目将 OAuth 限制为 100 个用户，但由于这是你的个人智能体，所以不存在问题。你无需发布应用。
• Gmail API 的日配额对大多数项目为 10 亿配额单位。正常的个人使用远远不会达到此上限。
• 如果长时间不活跃后出现认证错误，刷新令牌可能已过期。重新运行 OAuth 流程即可获取新令牌。