openclaw-healthcheck — 通讯自检与修复工具#

一键诊断飞书断联、Telegram 无响应、定时任务失效 — 精准修复，不用从头重配

---

何时使用#

• 飞书消息推不进来，或 lark-cli 命令报 401/token expired
• Telegram bot 长时间无响应，或需要重新验证配对码
• 微信 bridge 断线
• 定时任务（cron/push）静默失败，或同一任务重复触发
• 例行自检 — 每天/每周确认所有通道都活着

---

Scripts#

Script用途check-all.js全量诊断：所有通道 + 所有 cron 任务，输出健康报告check-feishu.js飞书 lark-cli auth 状态、token 有效期、测试推送check-telegram.jsTelegram bot API 连通性、webhook 状态、测试推送check-wechat.js微信 bridge 进程状态、连接测试check-crons.js列出所有定时任务、检测失败/重复/超时未跑fix-feishu.js引导飞书 token 刷新或重新 OAuth 登录fix-crons.js去重、修复、重启失效的定时任务

---

快速用法#

bash

# 全量自检（推荐先跑这个）
node scripts/check-all.js

# 只查飞书
node scripts/check-feishu.js

# 只查 Telegram
node scripts/check-telegram.js

# 只查定时任务
node scripts/check-crons.js

# 修复飞书 auth
node scripts/fix-feishu.js

# 修复 cron 重复任务
node scripts/fix-crons.js --dedup

---

输出格式#

每个 check 脚本输出一份健康报告写入 data/health-report.json：

json

{
  "checkedAt": "<ISO 时间戳>",
  "channels": {
    "feishu":   { "status": "OK | EXPIRED | DISCONNECTED | NOT_CONFIGURED", "detail": "..." },
    "telegram": { "status": "OK | SILENT | TOKEN_INVALID | NOT_CONFIGURED", "detail": "..." },
    "wechat":   { "status": "OK | BRIDGE_DOWN | NOT_CONFIGURED", "detail": "..." }
  },
  "crons": [
    {
      "id": "morning-push",
      "schedule": "0 8 * * *",
      "lastRun": "<ISO>",
      "status": "OK | MISSED | DUPLICATE | FAILED",
      "duplicateCount": 0
    }
  ],
  "overallStatus": "HEALTHY | DEGRADED | CRITICAL",
  "actionsNeeded": ["fix-feishu", "dedup-crons"]
}

---

常见问题速查#

症状根因修复命令飞书收不到推送lark-cli token 过期node scripts/fix-feishu.jsTelegram bot 无响应webhook 断开 / token 失效node scripts/check-telegram.js → 按提示操作定时任务重复触发cron 条目重复注册node scripts/fix-crons.js --dedup定时任务静默不跑cron 进程崩溃 / 配置丢失node scripts/check-crons.js → 查看 MISSED 条目配对码过期Telegram device code 超时node scripts/check-telegram.js --reauth

---

openclaw-healthcheck v1.0.0 — 用 Automatic Skill 流水线生成