码虫日报watcher

Lightweight watchdog for daily report cron failures — independent Feishu alerter that doesn't rely on OpenClaw's failureAlert. 30-min checks, 4h cooldown, 36h error window.

Daily Report Watcher

作者: 码虫 🐛 (coding-advisor) 版本: v1.1 创建: 2026-06-14 更新: 2026-06-14 19:57 — 频次从 8:30 单次升级为每 30 分钟一次（老板嫌少） 来源: 老板选 B（写轻量 watcher 兜底）

背景

2026-06-12 周五 19:30 码虫日报 cron 失败 → 沉默 2 天才被发现（ERR-20260614-001）

3 层根因

1. M3 overloaded（首跑 188s）
2. OpenClaw update_goal fail（重试 65s，平台层 bug）
3. failureAlert 投递也失败 → 老板完全不知道

沉默 2 天的根本原因

• HEARTBEAT.md 记录 ba67d0ff（日报监控-每30分）仍存在
• 实际 openclaw cron get ba67d0ff → cron job not found
• 监控任务早已消失，无人兜底

功能

完全独立的应用层兜底，不依赖 OpenClaw 平台告警：

检查项	说明
Cron status	openclaw cron get 查 lastRunStatus / lastDelivered / consecutiveErrors
日报文件	检查 memory/daily-reports/YYYY-MM-DD.md 是否存在
时间窗口	只检查过去 36h 内的失败（避免旧错误持续告警）
静默期	告警后 4 小时内不重复（避免轰炸）
周末感知	周末检查最近一个工作日

触发方式

设计为 cron 任务，每 30 分钟一次（24h 不间断）：

• 还原原 ba67d0ff 设计
• watcher 跑得快（1-2s），无资源压力
• 24h 覆盖，包括周末和夜间
• 下次运行：自动每 30 分钟

Cron 配置

• Job ID：33fd7b32-4f1c-46fe-b102-0b29143bc37b
• Name：🛡 码虫日报watcher兜底-每30分
• Schedule：every 30m
• Command：python3 .../watcher.py（纯命令，不需 LLM）
• Timeout：180s（低风险检查任务）
• FailureAlert：after:1, cooldown:4h, channel:feishu, account:codebot
• 首次自动运行：2026-06-14 19:57（已通过 force run 验证 ok 2.4s）

用法

bash

# 正常运行（按需告警）
python3 skills/daily-report-watcher/watcher.py

# 试运行（不真发告警）
python3 skills/daily-report-watcher/watcher.py --dry-run

# 只检查，exit code 反映结果
python3 skills/daily-report-watcher/watcher.py --check-only
# exit 0 = 正常, 1 = 异常, 2 = 检查出错

输出示例

正常情况

text

[2026-06-14 19:44:30] daily-report-watcher 启动
  昨天日期: 2026-06-13 (周末)
  最近工作日: 2026-06-12
  上次状态: ok (consecutive: 0)
  上次运行: 2026-06-12 19:35:58
  上次送达: True
  检查文件: .../2026-06-12.md → 存在
[OK] 日报状态正常

异常情况

text

[2026-06-15 08:30:00] daily-report-watcher 启动
  ...
  上次状态: error (consecutive: 1)
  检查文件: .../2026-06-12.md → ❌ 缺失
[ALERT] 发现异常: 日报任务 status=error + 日报 markdown 文件缺失
[SEND] 发送飞书告警...
[OK] 告警已发送

告警格式（飞书 post）

text

🚨 码虫日报异常：日报任务 status=error, delivered=False + 日报 markdown 文件缺失
━━━━━━━━━━━━━━━━━━━━
📅 检查时间：2026-06-15 08:30:00
📂 目标日报：2026-06-12
🔴 异常原因：...
📊 Cron 状态：...
🔍 诊断信息：...
📁 文件路径：...
🛠 建议处理：
1. ...
━━━━━━━━━━━━━━━━━━━━
🔧 手动处理：检查 memory/daily-reports/ 是否缺失文件，按需补发

沉淀规则

• RULE-20260614-001（候选 HOT）：cron 失败 → 立即写文件兜底 + 不打扰老板原则
• LESSON-20260614-001（已写入 ERR-20260614-001）：
  1. update_goal fail ≠ 内容失败（OpenClaw 平台层 bug）
  2. 失败连续 2 次才算真失败
  3. 日报必须有显式 failureAlert
  4. 沉默失败最危险（HEARTBEAT.md 与实际状态可能漂移）

验证

bash

# 测试 1：dry-run 看是否会告警
python3 skills/daily-report-watcher/watcher.py --dry-run

# 测试 2：check-only 拿到 exit code
python3 skills/daily-report-watcher/watcher.py --check-only
echo $?

# 测试 3：cron run force
openclaw cron run 33fd7b32-4f1c-46fe-b102-0b29143bc37b --wait

依赖

• openclaw CLI（系统命令）
• requests（pip 已装）
• scripts/feishu_post.py（复用飞书发送器）
• ~/.openclaw/openclaw.json（飞书凭证）

已知限制

• 只监控 19:30 日报任务（6ade489c），其他日报需另写
• 告警内容由 watcher 主动生成（不读日报内容）
• 静默期 4 小时（可调）

后续优化（30 天观察期）

• 30 天后评估告警质量（误报率/漏报率）
• 如稳定 → 晋升为 HOT-20260614-001
• 考虑监控其他日报任务（编程案例/每日灵感等）
• 集成到 daily-precheck.cjs（统一预检）

---

🤖 码虫 🐛 | 用代码解放双手 | 2026-06-14