Gateway 导读

不靠猜:5 秒确认通道是否在线

先跑 `openclaw status` 看本地摘要,再跑 `openclaw status --deep` 让网关实时探测通道。日志里搜 `web-heartbeat` 能揪出断连原因。

先讲这一页到底在解决什么

不靠猜:5 秒确认通道是否在线

先跑 `openclaw status` 看本地摘要,再跑 `openclaw status --deep` 让网关实时探测通道。日志里搜 `web-heartbeat` 能揪出断连原因。

原文共 7 节,先看 Start Here 路径:/gateway/health 查看官方原文

第一站

🩺 先记住三种体检:看一眼、照深一点、请医生出报告

官方 quick checks 列的命令很多,其实可以压成三档体检强度。

👀

openclaw status

像先看一眼总面板。网关能不能摸到、最近活跃不活跃,先有个全局感觉。

🔦

openclaw status --deep

像拿手电再往里照一层,不只是看门口亮不亮,还会更认真探通道状态。

🧾

openclaw health --json

像让值班医生出一份结构化体检单,方便你机器读、脚本接、自动化判断。

📌

一句话先记住

先看 status,再上 --deep,还不够就拉 health --json 报告。

第二站

🛠 那几条命令,翻成人话就是“摸灯、看病历、盯监控”

这页的价值不在于命令多,而在于它们各自负责看的地方不一样。

openclaw status

像先抬头看控制室总灯牌,确认网关通不通、模式对不对、最近有没有活动痕迹。

openclaw status --all

像把普通体检表展开成详细版,适合你准备把现场情况发给别人一起看。

openclaw logs --follow

像站在监控屏前盯直播。它特别适合查“为什么刚才那条消息像掉地上了”。

openclaw channels status --probe

像不是只看整栋楼活没活,而是逐个敲房门,看每条通道到底有没有人在值班。

第三站

🔍 Deep diagnostics 在讲“往设备抽屉和状态仓库里翻”

如果普通状态页看不出问题,官方就让你开始翻凭证时间、session store 和 relink 流程。

🪪 creds.json 时间戳

像看通行证最近有没有被更新。如果文件很老,说明这条线可能很久没真正连上。

🗂 sessions.json

像看会话仓库里最近有没有真的进出货。它不活跃,很多聊天症状就会一起怪。

openclaw channels logout / login --verbose

像把某扇门的旧门禁卡先注销,再认真重绑一遍。遇到 409 到 515 这类状态码时,这招很常见。

🎈 一句话

看不出问题时,就别只盯前台,要去翻后面的凭证抽屉和会话仓库。

第四站

⏰ health monitor 配置,像“多久量一次体温,多久没动静就叫醒一下”

官方最后这一段其实在讲自动值班规则,不是单次检查命令。

gateway.channelHealthCheckMinutes

像规定值班护士多久巡一轮。

gateway.channelStaleEventThresholdMinutes

像规定“多久一点动静都没有,就把它判成可能发呆了”。

gateway.channelMaxRestartsPerHour

像规定一小时最多抢救几次,别无限重启把现场折腾烂。

channels.<provider>.healthMonitor.enabled

像给某一条特别娇气的通道单独说:“这条先别自动乱碰,让它自己安静待着。”

最后总结

🎈 把 Health Checks 这页压成一句话

Health Checks 就是在提醒你:OpenClaw 出问题时,先看生命体征,再看深度体检,再翻凭证和日志,不要一上来靠猜。

如果你下一页只想继续看一页,我建议看 /web/index。因为很多“连不上”的问题,下一层就会落到“这栋楼到底怎么开门、绑在哪个地址、用了哪条路出去”。