面向 OpenClaw + Telegram 场景的 Gmail 告警监控 Skill。支持 Gmail API OAuth、规则匹配、金额提取、JSON 输出、中文预警文案生成,以及 OpenClaw 单入口执行。
当你需要:
就可以使用这个 Skill。
这个 Skill 用于把 Gmail 中的告警邮件检测结果,通过 OpenClaw 自动推送到 Telegram。
rules.json)生产环境推荐直接使用:
npm run openclaw:send:json
脚本职责:
openclaw:check:json:检测 Gmail 告警openclaw:dispatch:json:输出 OpenClaw 可消费的调度结果openclaw:send:json:在有新告警时自动调用 OpenClaw 发送 Telegram.env 打包或提交state/notified.json 打包或提交已支持:
messageId 的去重当前版本暂未直接内置:
scripts/auth-test.js测试 Gmail OAuth 是否可用。
scripts/check-alert.js执行 Gmail 邮件检测并输出结构化 JSON。
scripts/debug-search.js调试真实邮箱中的邮件搜索结果。
scripts/build-alert-message.js把检测结果转换成适合 Telegram 使用的中文预警文案。
scripts/run-openclaw-check.js给 OpenClaw 使用的统一入口脚本。
功能:
NO_ALERT--json 输出结构化契约,供 OpenClaw 调度层读取.env 配置文件rules.json 规则文件.env 和 rules.jsonnpm installnpm run auth:testnpm run openclaw:check 或 npm run openclaw:check:json.envGMAIL_CLIENT_ID=...
GMAIL_CLIENT_SECRET=...
GMAIL_REFRESH_TOKEN=...
GMAIL_USER_ID=me
ALERT_NOTIFY_ENABLED=true
ALERT_NOTIFY_CHANNEL=telegram
ALERT_NOTIFY_TO=7600789277
ALERT_STATE_FILE=./state/notified.json
rules.json{
"version": 1,
"rules": [
{
"name": "gptproto-low-balance",
"enabled": true,
"from": ["[email protected]"],
"subjectIncludes": ["balance", "dropped"],
"bodyIncludes": [
"account balance has dropped",
"recharge your account",
"billing section"
],
"threshold": 20,
"currency": "USD",
"search": {
"maxResults": 10,
"newerThanDays": 7
}
}
]
}
推荐职责拆分:
当前版本不建议:
docs/oauth-setup.mddocs/usage.mddocs/openclaw-integration.mddocs/troubleshooting.md