健康检查（CLI）

适用范围

在以下情况使用此页面：

• 诊断 WhatsApp 通道健康状态

简明指南，无需猜测即可验证通道连接性。

快速检查

• moltbot status — 本地摘要：网关可达性/模式、更新提示、已链接通道认证年龄、会话 + 最近活动。
• moltbot status --all — 完整本地诊断（只读、彩色、安全粘贴用于调试）。
• moltbot status --deep — 还探测正在运行的网关（支持时进行每个通道的探测）。
• moltbot health --json — 向正在运行的网关请求完整健康快照（仅限 WS；无直接 Baileys 套接字）。
• 在 WhatsApp/WebChat 中作为独立消息发送 /status 以获取状态回复而无需调用代理。
• 日志：tail /tmp/moltbot/moltbot-*.log 并过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度诊断

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

当出现故障时

• logged out 或状态 409–515 → 使用 moltbot channels logout 然后 moltbot channels login 重新链接。
• 网关不可达 → 启动它：moltbot gateway --port 18789（如果端口忙碌则使用 --force）。
• 无接收消息 → 确认已链接手机在线且发件人被允许（channels.whatsapp.allowFrom）；对于群组聊天，确保允许列表 + 提及规则匹配（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

专用"health" 命令

moltbot health --json 向正在运行的网关请求其健康快照（CLI 无直接通道套接字）。它在可用时报告已链接的凭据/认证年龄、每个通道的探测摘要、会话存储摘要以及探测持续时间。如果网关不可达或探测失败/超时，它将以非零状态退出。使用 --timeout <ms> 覆盖 10 秒默认值。