openclaw health --json
像拿着一张可读性很高的体检单。它会去问正在跑的 Gateway，要一份完整健康快照。
Cli 导读
一条命令检查网关是否活着
运行 `openclaw health` 即可获取运行中网关的健康状态。默认超时10秒，若需机器可读输出加 `--json`，调试时加 `--verbose` 或 `--debug`。
先讲这一页到底在解决什么
一条命令检查网关是否活着
运行 `openclaw health` 即可获取运行中网关的健康状态。默认超时10秒，若需机器可读输出加 `--json`，调试时加 `--verbose` 或 `--debug`。
第一站
👀 先把这三种看法分开
官方把它们摆在一起，是怕你把“看总览”和“做深检查”混掉。
openclaw status
像先看门口挂着的总览牌子，快，但没那么细。
openclaw status --deep
像把灯打到更亮，去现场多敲几扇门。
先记一句
health 更像“问 Gateway 自己”，status 更像“看整个院子”。
第二站
🚪 health --json 到底在问什么
它不是简单问“你还在吗”，而是追问“你能不能真的工作”。
🏠 Gateway 还在不在
像先敲敲总控室的门，确认里面有人。
📡 通道探针
像顺手问问各扇消息门：Telegram、Signal、Slack 这些门是不是还能开关正常。
🗃 会话仓库
像看看抽屉里那些会话纸条还整不整齐，有没有堆到看不懂。
⏱ 还会记时长
它还会告诉你这次检查花了多久。像医生在单子底部顺手写一句“这次巡诊用了几分钟”。
第三站
🧪 这条命令特别像“只听门里头的人说话”
官方特地说了，它是 WS-only。翻成人话就是：它要和正在跑的 Gateway 对话，不是自己在外面瞎猜。
WebSocket 对话
像拿着对讲机和门里的人讲话，不是隔着墙胡乱喊。
没有直连通道
CLI 不会自己去摸 WhatsApp 那种直接 socket。它是去问 Gateway：“你帮我看一眼。”
--timeout <ms>像规定最多等多久。别让一次检查把自己卡太久。
📌 这节真正想说的
health 不是“本地猜测器”，它是“去问正在上班的 Gateway 本人”。
第四站
🔐 如果门卡拿不到，它也会老老实实说出来
原文里对 SecretRef 的态度很清楚：能拿到就正常查，拿不到就降级，不瞎编。
有票就查
如果认证信息能正常解出来，健康检查就按完整路线走。
没票就降级
如果某些钥匙今天拿不到，它也会把“哪把钥匙没拿到”写进报告，而不是假装没事。
报告还是报告
重点是让你知道哪里够不着，而不是让整张单子直接报废。
一句话
health 更像老实的巡诊员，不像会装懂的机器。
第五站
🩹 出现问题时，先按顺序摸一遍，不要上来就大修
官方给的排查方式很像一串楼梯：先看能不能联系上，再看通道，再看日志。
openclaw health --json先把健康快照拿出来，看是不是整栋楼都已经喘不过气。
openclaw status --all像把总览表铺开，看看是不是某扇门或某个会话先出问题。
openclaw logs --follow像蹲在后台窗户后面看它到底卡在哪一步。
openclaw doctor如果看完还是不稳，再叫医生来做修补和清场。
最后总结
🎈 把 openclaw health 压成一句话
openclaw health --json 就是去问正在跑的 Gateway：“你现在真能干活吗？”它给的是完整健康快照，不是空泛的安慰。
如果你下一页只想继续看一页，我建议看 /cli/uninstall。因为看完健康单以后，另一个最常见的问题就是：怎么干净地离开。