🎨

Gmail

通过托管 OAuth 的 Gmail API 集成,让你的 AI 代理直接读取、发送、搜索、打标签并管理邮件、会话与草稿。

作者

byungkyu

设计与媒体生产力自动化API
安装
npx clawhub@latest install gmail
Star 数

52

下载次数

20.4k

当前安装数

651

累计安装数

144

版本

v1.0.6

更新时间

Feb 26, 2026

使用要求

Maton API Key · Google OAuth 连接

查看源码

ClawHub

Gmail 介绍

Gmail 通过 Maton 网关的托管 OAuth 认证,为你的 AI 代理提供完整的 Gmail API 访问能力。

你可以读取与发送邮件、管理会话与标签、创建并发送草稿、将邮件移入垃圾箱,并使用 Gmail 查询语法搜索收件箱,而无需手动管理 OAuth Token。

工作原理

1Step 1 - 一次授权

在 Maton 控制台创建 Google OAuth 连接,并在浏览器中完成授权。

2Step 2 - 通过 Maton 转发

请求通过 Maton 网关 `https://gateway.maton.ai/google-mail/{native-api-path}`,自动注入 Token。

3Step 3 - 管理连接

通过 Maton-Connection 头切换指定 OAuth 连接,实现多账号支持。

4Step 4 - 调用 Gmail API

使用标准 Gmail API 端点执行读取、发送、打标签、草稿与搜索操作。

关键特性

托管 OAuth

无需手动刷新 Token 或处理 OAuth 流程,Maton 网关自动完成认证。

完整 Gmail API

列出、读取、发送、删除与修改邮件,管理会话、标签与草稿。

查询语法

支持 Gmail 搜索语法,如 `is:unread`、`from:`、`subject:`、`has:attachment` 与时间范围。

多账号支持

通过 Maton-Connection 头连接并切换多个 Gmail 账号。

连接管理

在 Maton 控制台 API 中创建、列出并删除 OAuth 连接。

草稿管理

创建草稿并以编程方式发送。

使用要求

  • 无需 VM。
  • Maton API Key:用于认证,在 maton.ai 设置页获取。
  • Google OAuth 连接:通过 ctrl.maton.ai 创建 Gmail OAuth 连接并授权。

使用场景

邮件分诊

让 AI 代理扫描未读邮件并进行摘要或优先级排序。

自动回复

根据邮件内容和上下文生成并发送回复。

邮件搜索

按发件人、主题、日期范围或附件状态定位特定邮件。

标签管理

自动应用或移除标签以组织邮件。

草稿准备

先生成草稿供人工审核,再发送。

如何安装

npx clawhub@latest install gmail

在终端运行上述命令,或点击页面顶部的安装按钮完成一键安装。

常见问题

如何获取 Maton API Key?

登录 maton.ai,进入设置页并复制你的 Maton API Key。

如何连接 Gmail 账号?

在 Maton 控制台(ctrl.maton.ai)创建 Gmail OAuth 连接,然后打开授权链接完成 OAuth。

可以使用多个 Gmail 账号吗?

可以。创建多个连接,并使用 Maton-Connection 头选择目标账号。

请求速率限制是多少?

网关大约限制为每个连接每秒 10 次请求。

需要手动管理 OAuth Token 吗?

不需要。Maton 网关会自动为每个请求注入 OAuth Token。

可以调用哪些 Gmail API 端点?

通过 Maton 网关的 URL 模式即可访问所有标准 Gmail API 端点。