OpenClaw Skills 邮件管理(Gmail)技能使用参考手册

OpenClaw Skills 邮件管理(Gmail)技能使用参考手册

Gmail 是用于让 OpenClaw 通过 Gmail API 与 Gmail 平台交互的 OpenClaw 技能,该技能支持邮件的读取、发送、管理,以及线程、标签和草稿的管理,通过 Maton 平台的网关进行 OAuth 认证管理,无需手动处理复杂的 OAuth 流程。

该技能可以帮助用户在 OpenClaw 中直接访问和操作 Gmail 平台的功能,适合需要在 AI 助手中集成 Gmail 功能的场景,例如邮件内容搜索、邮件自动回复、邮件分类管理等。

  • 名称:gmail
  • 描述:通过 Gmail API 实现邮件的读取、发送、管理,以及线程、标签和草稿的管理,使用 Maton 平台的网关进行 OAuth 认证管理,无需手动处理复杂的 OAuth 流程。
  • 版本:1.0.6
  • 作者:maton
  • 许可证:MIT License
  • 依赖
    • 需要网络访问权限
    • 需要有效的 Maton API Key(MATON_API_KEYopenclaw)
  • 触发词:”Gmail 邮件管理”、”Gmail 邮件搜索”、”Gmail 邮件发送”、”Gmail 邮件分类”、”Gmail 草稿管理”

在你的工作目录中运行以下命令列出邮件:



将替换为实际的 Gmail API 端点路径。网关会将请求代理到,并自动注入你的 OAuth 令牌。

所有请求都需要在 Authorization 头中包含 Maton API 密钥:


环境变量:将你的 API 密钥设置为环境变量:


  1. 访问maton.ai注册或登录账户
  2. 进入maton.ai/settings页面
  3. 复制你的 API 密钥

你可以在管理你的 Google OAuth 连接。




响应


在浏览器中打开返回的以完成 OAuth 授权。


如果你有多个 Gmail 连接,可以通过头指定使用哪个连接:


如果省略,网关将使用默认(最早的)活动连接。


带查询过滤器:



仅获取元数据:











在参数中使用:

  • – 未读邮件
  • – 已标星邮件
  • – 来自特定发件人
  • – 发送给特定收件人
  • – 主题包含关键词
  • – 特定日期之后的邮件
  • – 特定日期之前的邮件
  • – 包含附件的邮件



  • 对于已认证的用户,使用作为 userId
  • 邮件正文在字段中以 base64url 编码
  • 常见标签:、、、、、
  • 重要提示:使用 curl 命令时,如果 URL 包含括号(、、),请使用以禁用 glob 解析
  • 重要提示:当将 curl 输出通过管道传递给或其他命令时,在某些 shell 环境中,等环境变量可能无法正确展开,可能会出现 “无效 API 密钥” 错误

  1. 检查环境变量是否已设置:

  1. 通过列出连接验证 API 密钥是否有效:

  1. 确保你的 URL 路径以开头。例如:
  • 正确:
  • 错误:

  • Gmail API 概述
  • 列出邮件
  • 获取邮件
  • 发送邮件
  • 列出线程
  • 列出标签
  • 创建草稿
  • Maton 社区
  • Maton 支持

该技能采用 MIT License,完整的许可条款如下:


该技能的元数据信息如下:


版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:Ai探索者,转载请注明出处:https://javaforall.net/257184.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 上午10:29
下一篇 2026年3月13日 上午10:29


相关推荐

关注全栈程序员社区公众号