健康检查（CLI）

一个简短指南：用可验证的步骤来确认 channel 连通性，避免“猜”。

快速检查

• openclaw status — 本地摘要：gateway 可达性/模式、更新提示、已连接 channel 的鉴权时间、sessions 与近期活动。
• openclaw status --all — 完整的本地诊断（只读、带颜色、可安全粘贴用于排障）。
• openclaw status --deep — 额外探测运行中的 Gateway（支持时按 channel 探测）。
• openclaw health --json — 向运行中的 Gateway 请求完整健康快照（仅 WS；不会直连 Baileys socket）。
• 在 WhatsApp/WebChat 里发送一条独立的 /status 消息，可在不触发 agent 的情况下得到状态回复。
• 日志：tail /tmp/openclaw/openclaw-*.log 并过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度诊断

• 磁盘上的凭据：ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json（mtime 应该是近期）。
• Session store：ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（路径可在 config 中覆盖）。session 数量与最近收件人可通过 status 查看。
• 重新关联流程：当日志出现 409–515 或 loggedOut 时，执行 openclaw channels logout && openclaw channels login --verbose。（注：QR 登录流程在配对后，遇到 515 会自动重启一次。）

出问题时怎么做

• logged out 或状态码 409–515 → 先 openclaw channels logout，再 openclaw channels login 重新关联。
• Gateway 不可达 → 启动：openclaw gateway --port 18789（如果端口忙，用 --force）。
• 收不到入站消息 → 确认已连接手机在线，且发送者被允许（channels.whatsapp.allowFrom）；对于群聊，确认 allowlist 与 @mention 规则匹配（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

专用 “health” 命令

openclaw health --json 会向运行中的 Gateway 请求健康快照（CLI 不会直连 channel socket）。它在可用时报告已连接的 creds/auth age、按 channel 的 probe 摘要、session-store 摘要，以及 probe 耗时。如果 Gateway 不可达或 probe 失败/超时，会以非 0 退出码退出。可用 --timeout <ms> 覆盖默认 10s。