openclaw/docs/zh-CN/platforms/mac/health.md

read_when	summary	title	x-i18n
调试 Mac 应用健康指示器	macOS 应用如何报告 Gateway网关/Baileys 健康状态	健康检查	generated_at model provider source_hash source_path workflow 2026-02-01T21:32:43Z claude-opus-4-5 pi 0560e96501ddf53a499f8960cfcf11c2622fcb9056bfd1bcc57876e955cab03d platforms/mac/health.md 15

macOS 上的健康检查

如何从菜单栏应用查看已关联渠道的健康状态。

菜单栏

• 状态圆点现在反映 Baileys 健康状态：
  • 绿色：已关联 + socket 近期已打开。
  • 橙色：正在连接/重试中。
  • 红色：已登出或探测失败。
• 次要行显示 "linked · auth 12m" 或显示失败原因。
• "运行健康检查" 菜单项可触发按需探测。

设置

• 通用选项卡新增健康卡片，显示：已关联认证时长、会话存储路径/数量、上次检查时间、上次错误/状态码，以及"运行健康检查"/"显示日志"按钮。
• 使用缓存快照，使 UI 即时加载，离线时优雅降级。
• 渠道选项卡展示渠道状态 + WhatsApp/Telegram 的控制项（登录二维码、登出、探测、上次断连/错误）。

探测工作原理

• 应用每约 60 秒以及按需通过 ShellExecutor 运行 openclaw health --json。探测会加载凭据并报告状态，不会发送消息。
• 分别缓存上次成功的快照和上次错误，以避免闪烁；显示各自的时间戳。

不确定时

• 你仍然可以使用 Gateway网关健康检查 中的 CLI 流程（openclaw status、openclaw status --deep、openclaw health --json），并跟踪 /tmp/openclaw/openclaw-*.log 中的 web-heartbeat / web-reconnect。