核心用法
mail-agent 是一款运行于 OpenClaw 生态内的 Gmail 监控插件，通过 Google Cloud Pub/Sub 建立实时推送通道，将重要邮件经 AI 分类后推送至 Telegram。用户需依次完成 gog 认证、GCP 项目配置、API 启用、Pub/Sub 主题订阅创建、插件安装与配置六大步骤，最后通过重启网关激活服务。
显著优点
- 实时性强：基于 Pub/Sub 推送而非轮询，延迟可控制在秒级
- AI 智能过滤：支持接入 LLM（如 GPT-4o-mini）自动判断邮件紧急程度，减少噪音
- 基础设施整合：深度绑定 OpenClaw 与 gog 生态，适合已采用该技术栈的用户
- 端到端可控：从 Gmail → GCP → OpenClaw → Telegram 全链路自建，无第三方 SaaS 依赖
潜在缺点与局限性
- 门槛较高：需同时掌握 gog、GCP、gcloud、OpenClaw 四套工具链，对非技术用户极不友好
- 成本隐性：GCP Pub/Sub 与 Gmail API 调用产生云服务费用，LLM 分类增加额外 token 成本
- 单点故障风险：依赖 Google 服务可用性、GCP 配额、Telegram Bot 稳定性任一环节中断即失效
- 安全面扩大：需向插件暴露 Gmail 访问权限、GCP 凭据、LLM API Key，密钥管理复杂度高
- 生态锁定：专为 OpenClaw 设计，无法独立运行或迁移至其他平台
适合人群
- 已部署 OpenClaw 网关的技术运维团队
- 需要 7×24 小时关键邮件告警的 SRE/DevOps 工程师
- 熟悉 GCP 基础设施、偏好自建而非采购 SaaS 监控方案的组织
常规风险
| 风险类型 | 具体表现 |
|---------|---------|
| 凭据泄露 | gcloud ADC、gog 凭据、LLM API Key 均以明文或本地文件形式存储 |
| 权限过度 | Gmail API 授权范围较宽，插件理论上可读取全部邮件内容 |
| 推送失效 | Telegram 网络受限地区可能出现消息丢失 |
| 费用失控 | Pub/Sub 消息堆积或高频邮件场景下产生意外账单 |