Codex Reset Radar — 使用量重置窗口监控器

监控 Codex Reset Radar 的 current.json 接口，用于检测 Codex 使用配额重置窗口（即“速度窗口”），并通过 OpenClaw 定时任务（cron）向默认代理聊天频道推送告警。

工作原理

Cron 触发
     │
     ▼
① 数据采集：python3 scripts/codex-radar-check.py
   → 获取 current.json 并与本地缓存比对
     │
     ▼
② JSON 差分：输出 has_changes + events[] 或 has_changes: false
   → 无变更 → 代理回复 NO_REPLY（静默）
     │
     ▼
③ LLM 格式化：仅读取 JSON 差分结果
   → 转换为友好的聊天消息格式
     │
     ▼
④ 聊天推送：发布至用户会话（默认聊天频道）

检测脚本

scripts/codex-radar-check.py — 仅使用 Python 标准库，零外部依赖：

• 获取 https://codex-reset-radar.pages.dev/current.json
• 与上一次运行保存的 cache/codex-radar-last.json 进行比对
• 首次运行时自动创建基线缓存

检测的变更类型：

输出 JSON 示例

无变更：

{"has_changes": false}

检测到变更：

{
  "has_changes": true,
  "events": [
    {"type": "window_opened", "detail": "Codex 使用量重置窗口已开启", "opened_at": "2026-05-24T08:21:33+08:00", "scope": "Codex users"}
  ],
  "current_status": {
    "window_open": true,
    "status": "open",
    "last_window_id": "codex-speed-window-2026-05-24-codex",
    "prediction_level": "low",
    "probability_24h": 0.06
  }
}

安装

clawhub install codex-reset-radar

Cron 配置

创建一个 OpenClaw 定时任务（推荐设置为每天上午 8 点至晚上 11 点每小时执行一次，凌晨 0–7 点静默不执行）。投递目标将自动使用您的默认代理聊天频道：

{
  "name": "Codex Reset Radar Monitor",
  "schedule": {"kind": "cron", "expr": "0 8-23 * * *", "tz": "Asia/Shanghai"},
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "timeoutSeconds": 60,
    "lightContext": true,
    "message": "Codex Reset Radar monitor.n1. cd ~/.openclaw/workspace && python3 skills/codex-reset-radar/scripts/codex-radar-check.pyn2. If has_changes: false, reply NO_REPLYn3. If changes detected, format and push to default chat channel"
  }
}

💡 该定时任务将自动推送告警至您的 OpenClaw 代理当前默认使用的聊天频道（飞书、Discord、Telegram 等），无需额外配置频道相关参数。

推荐的执行周期：

• 0 8-23 * * * —— 工作时段每小时一次，凌晨 0–7 点静默
• */10 * * * * —— 每 10 分钟一次（适用于紧急监控场景）

设计原则

• LLM 仅处理 JSON 差分结果 —— 不解析原始 RSS/HTML 内容，语义分析开销极低，Token 使用量最小化
• 零成本静默 —— has_changes: false 时代理返回 NO_REPLY，不向聊天频道发送任何消息
• 纯标准库实现 —— 仅依赖 json、urllib、datetime、os，无任何第三方依赖
• 容错性强 —— 网络异常时输出 {"has_changes": false, "error": "..."}，绝不会误触发或崩溃
• 频道无关性 —— 借助 OpenClaw 的投递系统，可无缝适配任意聊天平台（飞书、Discord、Telegram 等）