Files
bot/docs/zh-CN/platforms/mac/health.md
zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase
Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot
2026-03-19 13:52:32 -07:00

1.7 KiB

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

macOS 上的健康检查

如何从菜单栏应用查看关联渠道是否健康。

菜单栏

  • 状态圆点现在反映 Baileys 健康状态:
    • 绿色:已关联 + socket 最近已打开。
    • 橙色:正在连接/重试。
    • 红色:已登出或探测失败。
  • 第二行显示"linked · auth 12m"或显示失败原因。
  • "Run Health Check"菜单项触发按需探测。

设置

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

探测工作原理

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

有疑问时

  • 你仍然可以使用 Gateway 网关健康 中的 CLI 流程(hanzo-bot status、hanzo-bot status --deep、hanzo-bot health --json),并在 /tmp/hanzoai/bot-*.log 中跟踪 web-heartbeat / web-reconnect。