健康检查

健康检查 (CLI)

在不猜测的情况下验证通道连接性的简短指南。

openclaw status — 本地摘要：网关可达性/模式、更新提示、已关联通道的验证时长、会话 + 近期活动。
openclaw status --all — 完整的本地诊断（只读、彩色、可安全粘贴用于调试）。
openclaw status --deep — 同时探测正在运行的 Gateway(网关) 网关（受支持时进行逐通道探测）。
openclaw health --json — 向正在运行的 Gateway(网关) 网关请求完整的健康快照（仅限 WS；无直接 Baileys 套接字）。
在 WhatsApp/WebChat 中将 /status 作为独立消息发送，以便在不调用代理的情况下获取状态回复。
日志：尾部 /tmp/openclaw/openclaw-*.log 并过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

磁盘上的凭据：ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json（修改时间应该是最近的）。
会话存储：ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（路径可以在配置中覆盖）。计数和最近的接收者会通过 status 显示。
重新关联流程：当日志中出现状态码 409–515 或 loggedOut 时，执行 openclaw channels logout && openclaw channels login --verbose。（注意：状态 515 配对后，二维码登录流程会自动重启一次。）

gateway.channelHealthCheckMinutes：Gateway(网关)检查渠道健康的频率。默认值：5。设置 0 可全局禁用健康监控重启。
gateway.channelStaleEventThresholdMinutes：已连接的渠道在健康监控将其视为陈旧并重启之前可以保持空闲的时间。默认值：30。请保持此值大于或等于 gateway.channelHealthCheckMinutes。
gateway.channelMaxRestartsPerHour：每个渠道/帐户在一个小时内的健康监控重启滚动上限。默认值：10。
channels.<provider>.healthMonitor.enabled：在保持全局监控开启的同时，禁用特定渠道的健康监控重启。
channels.<provider>.accounts.<accountId>.healthMonitor.enabled：优先于渠道级设置的多帐户覆盖设置。
这些每个渠道的覆盖设置适用于当前公开了这些设置的内置渠道监控：Discord、Google Chat、iMessage、Microsoft Teams、Signal、Slack、Telegram 和 WhatsApp。

logged out 或状态 409–515 → 使用 openclaw channels logout 重新连接，然后使用 openclaw channels login。
Gateway(网关) 无法访问 → 启动它：openclaw gateway --port 18789（如果端口被占用，请使用 --force）。
没有收到传入消息 → 确认关联的手机在线并且允许发送者发送（channels.whatsapp.allowFrom）；对于群组聊天，确保允许列表 + 提及规则匹配（channels.whatsapp.groups，agents.list[].groupChat.mentionPatterns）。

openclaw health --json 询问正在运行的 Gateway(网关) 的健康快照（CLI 没有直接的渠道套接字）。它在可用时报告关联的凭据/身份验证期限、每个渠道的探测摘要、会话存储摘要和探测持续时间。如果 Gateway(网关) 无法访问或探测失败/超时，它将以非零代码退出。

选项：

健康快照包括：ok（布尔值）、ts（时间戳）、durationMs（探测时间）、每个渠道的状态、代理可用性和会话存储摘要。