macOS 健康检查¶

macOS 应用会从网关（Gateway）读取频道健康状态。已配置的频道无需 linked-session 字段即可报告健康状态。显式禁用的账户保持非活动状态，无法提供健康的备用通道。

菜单栏¶

菜单会显示可操作的健康问题：橙色表示故障原因，红色表示需要登录。健康与待处理状态保持静默。打开菜单时会按需刷新健康状态。

设置¶

• 在原生 连接… → 连接 标签页中，本地网关 会显示健康状态行：状态点、频道摘要，以及可选的故障详情行，并提供 立即重试 和 打开日志 按钮。
• 仪表盘 → 设置 → 频道 会展示每个频道的状态与控制项（登录二维码、注销、探测、上次断开/错误）。

健康状态行使用以下状态：

• 绿色：所选已关联或已配置的频道没有报告任何故障。
• 橙色：某个频道或健康请求报告了故障。当另一个已配置频道健康时，未关联频道也会保持橙色。
• 红色：需要关联，且没有可用的健康已配置频道。
• 灰色：健康状态待定，或所选频道已被禁用或未配置。

摘要可能显示“Telegram ready”“Telegram running”或“linked · auth 12m”。应用会遵循网关的启动与重连宽限期。仅出现瞬时传输标志不会将频道标记为降级。已报告的故障（如失效的套接字或不可用的入站处理）仍优先于看起来就绪的连接。

缺少 HTTP 状态本身并不表示超时。应用会保留网关报告的探测错误。

健康刷新机制¶

应用会通过现有的 WebSocket 连接（而非 CLI 外部调用）每约 60 秒及按需调用网关的 health RPC。这会读取网关的健康快照。它不会请求主动频道探测，也不会发送消息。应用会分别缓存最近一次正常快照和最近一次错误，使 UI 立即加载，并且离线时不会闪烁。

原生健康状态行跟随主网关。切换主网关会立即清除前一网关的缓存状态。来自该网关的延迟回复无法替换新结果。重新连接到同一网关时，会在运行新检查的同时保留其最近一次正常健康快照。连接错误会归属于报告该错误的网关。

存疑时¶

请使用 网关健康 中的 CLI 流程（openclaw status、openclaw status --deep、openclaw health --json），并运行 openclaw logs --follow，筛选 web-heartbeat / web-reconnect。

相关文档¶

• 网关健康
• macOS 应用