📧 Gmail 邮箱枢纽

通信流转 · 自动化助理 · 邮件收发

将世界上最庞大的邮箱网络变作 AI 智能体的收发室！零阻力打通内部大模型与外部人员协作，赋予其阅读、起草、甚至自动回复往来信件的强悍自治能力。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install gmail

⭐ 收藏点赞	☁️ 总计调用	👥 当前活跃	🎯 稳定版本
890	23.4w	3,210	v1.6.0

接入官方的 Gmail API 后，我们将其重写为了最契合大模型解析逻辑的工具包：

📨 双向邮件读写管道：不仅可以利用大模型优异的行文功底进行外发投递，更能监听特定收件箱的未读状态。Agent 可以把长篇大论的来信阅读后总结成一句话塞回给您的终端。
🧠 意图感知的自动归档与草稿：支持创建待发草稿而不仅仅是直接莽撞发送。机器人在处理涉及金钱/商务的重要回信时，可以在 Drafts 中留痕，等待人类在手机端最后划走确认。
🧹 脱水版 MIME 解析：原生邮件源码中往往充斥着海量的恶心 Base64 签名档、表格样式与不可见字符。本模块内置强力净化器，将它们统统洗净，仅供出富含语义的纯文本交由大语言模型，极大地挽救了宝贵的 Token 额度。
🔐 多重 OAuth2 鉴权与隐私合规：采用谷歌官方最高标准的 User-Consent 授权管线，保证模型运行时所依赖的凭证受到端侧硬件级严密保护。

当外部客户通过官网名片向您发起产品报价邮件时。您的智能体可以在 10 秒内捕获该信件，阅读其中的上下文寻找对应的 SKU 报价库，随即用非常符合人类温度的礼貌语气撰写出一封携带详细价格表的草稿回覆，它甚至可以自动 cc（抄送）到您的销售部总监那里。

如果您苦于推销信件淹没重要线索，可以让 AI 每天早晨 8 点帮您"扫盲"。它会批量拉取 INBOX，依靠其强悍的语义理解能力区分"广告"与"真实人类来信"。然后直接操作 API 把毫无用处的商业推广全部移入 Trash 并标记已读。

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

自动拉取收件箱中最顶部的 5 封未读邮件并做核心要素总结：

clawhub execute gmail action="read" \
  query="is:unread in:inbox" max-results=5 \
  intent="Summarize the core topics for me"

指挥大模型根据您的草稿思想撰写一封委婉的拒绝投资回信：

clawhub execute gmail action="draft" \
  to="[email protected]" \
  intent="Politely decline their 1M funding offer but keep in touch for next round"

直接利用发送通道投放定点通知（可搭配其他监控工具组合）：

clawhub execute gmail action="send" \
  to="[email protected]" subject="Daily Server Report" \
  body="$(cat report.txt)"

🔑 凭证拉取：首次使用必须在您的本地终端进行一次浏览器跳转。当运行 npx clawhub install gmail 后，控制台会生成一个 OAuth 链接，您需要使用谷歌账号登陆并授予 https://mail.google.com/ 的全读写访问权。
🔒 凭证缓存加密：生成的 token.json 将会被静态存储在您的宿主机 ~/.clawhub/credentials 目录中。请绝对不要将此文件 Push 到任何公共代码库中。