macOS 上的健康检查¶
macOS 应用从 Gateway 读取通道健康状态。已配置的通道无需关联会话字段即可报告健康状态。显式禁用的账户保持非活动状态,并且无法提供健康的回退。
菜单栏¶
菜单会显示可操作的健康问题:橙色故障原因或红色登录要求。健康状态和待定状态保持静默。打开菜单时会按需刷新健康状态。
设置¶
- 在原生 Connection… → Connection 选项卡中,Local Gateway 显示一行健康状态:状态点、通道摘要,以及可选的故障详情行,并带有 Retry now 和 Open logs 按钮。
- Dashboard → Settings → Channels 显示每个通道的状态和控制项(登录二维码、登出、检查、最近断开/错误)。
健康行使用以下状态:
- 绿色:所选的已关联或已配置通道没有报告故障。
- 橙色:某个通道或健康检查请求报告了故障。当另一个已配置通道健康时,未关联的通道也保持橙色。
- 红色:需要关联,且没有可用的健康已配置通道。
- 灰色:健康状态待定,或所选通道已禁用或未配置。
摘要可能显示“Telegram ready”、“Telegram running”或“linked · auth 12m”。应用会遵循 Gateway 的启动和重连宽限窗口。仅瞬态传输标志不会将通道标记为降级。报告的故障(例如陈旧套接字或不可用的入站处理)仍然优先于看似就绪的连接。
缺少 HTTP 状态本身并不意味着超时。应用会保留 Gateway 报告的检查错误。
健康刷新如何工作¶
应用通过现有 WebSocket 连接(而不是 CLI shell-out)每约 60 秒以及按需调用 Gateway 的 health RPC。这会读取 Gateway 的健康快照。它不会请求活动通道检查或发送消息。应用会分别缓存最后一次正常快照和最后一次错误,以便 UI 立即加载,并且离线时不会闪烁。
原生健康行遵循 Primary Gateway。 切换 Primary 会立即清除之前 Gateway 的缓存状态。来自该 Gateway 的延迟回复不能替换新结果。重新连接到同一 Gateway 时,在运行新的检查期间会保留其最后一次正常健康快照。连接错误保留在报告它们的 Gateway 上。
如有疑问¶
使用 Gateway 健康检查 中的 CLI 流程(openclaw status、
openclaw status --deep、openclaw health --json),并运行
openclaw logs --follow,过滤 web-heartbeat / web-reconnect。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw