mail-agent 是一款面向 OpenClaw 平台的 Gmail 监控插件，核心功能是通过 Google Cloud Pub/Sub 实现 Gmail 收件箱的实时推送监听，再由配置的大语言模型（LLM）对邮件内容进行重要性分类，最终将筛选后的关键邮件转发至用户指定的 Telegram 聊天。
核心用法
用户需依次完成八大步骤：前置检查 gog 认证与 Google Cloud 登录、创建/选择 GCP 项目、启用 Gmail 与 Pub/Sub API、创建主题与订阅并授权 Gmail 服务账号发布、安装插件、配置 Telegram chat ID 与 GCP 项目等参数、可选配置 LLM API 密钥用于智能分类、重启 OpenClaw 网关并验证日志。整个流程涉及命令行工具链的密集交互，对用户的 DevOps 基础有一定要求。
显著优点
- 实时推送：基于 Pub/Sub 的推送机制优于传统轮询，延迟低且节省 API 配额
- AI 过滤：支持 GPT-4o-mini 等模型自动判断邮件紧急程度，减少信息噪音
- 生态整合：深度嵌入 OpenClaw，与现有 Telegram 通知体系无缝衔接
- 开源可控：源码公开，可自行审计与定制分类逻辑
潜在局限
- 配置复杂度高：需同时维护 gog、GCP、OpenClaw、Telegram 四类凭据，任一环失效即中断
- Vendor Lock-in：强依赖 Google Cloud 与 OpenClaw 特定版本
- 隐私权衡：邮件内容需经过第三方 LLM 服务商，敏感场景需谨慎评估
- 无内置加密：传输依赖各平台 TLS，无额外端到端加密
适合人群
技术型用户、运维团队、自由开发者，以及需要将 Gmail 关键通知实时同步至 Telegram 工作流的重度效率工具使用者。
常规风险
- 凭据泄露：GCP 服务账号密钥与 LLM API 密钥存储于本地配置，需防范文件权限与备份泄露
- API 费用：GCP Pub/Sub 与 LLM 调用产生持续成本，高流量邮箱可能超出免费额度
- 服务中断：Google 或 OpenClaw 任一平台策略变更均可能导致功能失效
- 误判漏报：LLM 分类存在概率性错误，关键邮件可能被过滤