健康检查 (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）。
专用的“health”命令
openclaw health --json 向运行中的 Gateway(网关) 请求其健康快照（CLI 不直接连接渠道套接字）。它在可用时报告关联的凭据/身份验证时间、每个渠道的探测摘要、会话存储摘要以及探测持续时间。如果 CLI 无法访问或探测失败/超时，它将以非零状态退出。使用 --timeout <ms> 覆盖 10 秒的默认值。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。