健康检查（CLI）

验证通道连接性的简短指南。

快速检查

• openclaw status — 本地摘要：网关可达性/模式、更新提示、链接通道认证时长、会话 + 最近活动。
• openclaw status --all — 完整本地诊断（只读、彩色、安全粘贴用于调试）。
• openclaw status --deep — 还探测运行中的网关（支持时逐通道探测）。
• openclaw health --json — 询问运行中的网关获取完整健康快照（仅 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（mtime 应该最近）。
• 会话存储：ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（路径可以在配置中覆盖）。计数和最近收件人通过 status 显示。
• 重新链接流程：当状态码 409–515 或 loggedOut 出现在日志中时，使用 openclaw channels logout && openclaw channels login --verbose 重新链接。（注意：QR 登录流程在状态 515 配对后会自动重启一次。）

当某事失败时

• logged out 或状态 409–515 → 使用 openclaw channels logout 然后 openclaw channels login 重新链接。
• 网关不可达 → 启动它：openclaw gateway --port 18789（如果端口繁忙使用 --force）。
• 没有入站消息 → 确认链接的电话在线，发送者在允许列表中（channels.whatsapp.allowFrom）；对于群聊，确保白名单 + 提及规则匹配（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

专用"健康"命令

openclaw health --json 询问运行中的网关获取其健康快照（无来自 CLI 的直接通道套接字）。它报告链接的凭据/认证时长（如果可用）、逐通道探测摘要、会话存储摘要和探测持续时间。如果网关不可达或探测失败/超时，它以非零退出。使用 --timeout <ms> 覆盖 10 秒默认值。