Gmail 概览
Gmail 技能通过 Maton 网关的托管 OAuth，为 AI 代理提供完整 Gmail API 访问能力。
无需手动管理 OAuth Token，即可读取/发送邮件、管理线程与标签、创建草稿并执行高级搜索。
工作原理
1步骤 1 - 一次性授权
在 Maton 控制台创建 Google OAuth 连接并在浏览器中授权。
2步骤 2 - 通过网关调用
请求通过 `https://gateway.maton.ai/google-mail/{native-api-path}`，Token 自动注入。
3步骤 3 - 切换账号
通过设置 Maton-Connection 头部来选择具体 OAuth 连接。
4步骤 4 - 调用 Gmail API
使用标准 Gmail API 端点完成读取、发送、标签与搜索。
核心功能
托管 OAuth
无需手动刷新 Token 或处理 OAuth 流程。
完整 Gmail API
支持邮件/线程/标签/草稿的读取、发送与管理。
高级搜索
支持 `is:unread`、`from:`、`subject:`、`has:attachment` 等语法。
多账号支持
连接多个 Gmail 账号，并通过 Maton-Connection 切换。
连接管理
通过 Maton 控制台 API 创建、查看与删除连接。
草稿管理
程序化创建草稿并发送。
环境要求
- 无需虚拟机。
- 需要 Maton API Key（在 maton.ai 设置页获取）。
- 需要 Google OAuth 连接（在 ctrl.maton.ai 创建并授权）。
使用场景
邮件分拣
扫描未读邮件并自动摘要或排序。
自动回复
根据上下文生成并发送回复。
邮件搜索
按发件人、主题、时间范围或附件状态定位邮件。
标签管理
自动添加或移除标签进行分类。
草稿准备
生成草稿，人工审核后发送。
安装方式
npx clawhub@latest install gmail在终端运行命令，或点击页面顶部安装按钮一键完成。
常见问题
如何获取 Maton API Key？
登录 maton.ai，在设置页复制 Maton API Key。
如何连接 Gmail 账号？
在 ctrl.maton.ai 创建 Gmail OAuth 连接并完成授权。
支持多个 Gmail 账号吗？
支持，创建多个连接后通过 Maton-Connection 选择账号。
有哪些速率限制？
网关约为每个连接每秒 10 次请求。
需要手动管理 OAuth Token 吗？
不需要，Maton 网关会自动注入 Token。
可以调用哪些 Gmail API？
所有标准 Gmail API 端点均可通过网关访问。