概述
macOS 应用通过菜单栏和 Settings 面板展示 Gateway/Baileys 健康状态。
菜单栏状态
状态点反映 Baileys 健康：
| 颜色 | 含义 |
|---|---|
| 绿色 | 已连接，socket 最近已打开 |
| 橙色 | 连接中/重试中 |
| 红色 | 已登出或探测失败 |
- 副标题显示 “linked · auth 12m” 或失败原因
- “Run Health Check” 菜单项触发按需探测
Settings 面板
General 标签页的 Health 卡片显示：
- 已连接认证时长
- session-store 路径/数量
- 最后检查时间
- 最后错误/状态码
- 按钮：Run Health Check / Reveal Logs
Channels 标签页展示 WhatsApp/Telegram 频道状态和控制（登录 QR、登出、探测、最后断连/错误）。
探测机制
- 应用每约 60s 通过
ShellExecutor运行openclaw health --json，也可按需触发 - 探测加载凭证并报告状态，不发送消息
- 分别缓存最后成功快照和最后错误，避免 UI 闪烁
CLI 替代方案
openclaw status
openclaw status --deep
openclaw health --json
# 查看日志
tail -f /tmp/openclaw/openclaw-*.log # 关注 web-heartbeat / web-reconnect相关链接
- platform-macos — macOS 伴侣应用
- platform-mac-bundled-gateway — Gateway 管理