# 健康检查（macOS）

> macOS 应用如何报告 Gateway 网关/渠道健康状态

- 网址：https://funcoding.ai/agents/openclaw/platforms/mac/health/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/platforms/mac/health

---
如何从菜单栏应用中读取已链接渠道的健康状态。

## 菜单栏

状态圆点：

- 绿色：已链接且探测正常。
- 橙色：已链接，但渠道探测报告状态降级/未连接。
- 红色：尚未链接。

第二行显示“已链接 · 身份验证 12 分钟”，或显示失败原因。
菜单中的“Run Health Check Now”会触发按需探测。

## 设置

- General 选项卡显示健康卡片：状态圆点、摘要行（链接状态 +
  身份验证时长）以及可选的失败详情行，并带有 **Retry now** 和
  **Open logs** 按钮。
- **Channels 选项卡**显示 WhatsApp 和 Telegram 的各渠道状态及控制项（登录二维码、
  注销、探测、上次断开连接/错误）。

## 探测的工作原理

应用通过现有的 WebSocket 连接调用 Gateway 网关的 `health` RPC
（而非调用 CLI shell），约每 60 秒调用一次，也可按需调用。RPC 会加载
凭据并报告状态，而不会发送消息。应用分别缓存最后一次
正常快照和最后一次错误，因此 UI 能够立即加载，
并且离线时不会闪烁。

## 如果不确定

使用 [Gateway 健康](https://funcoding.ai/agents/openclaw/gateway/health/) 中的 CLI 流程（`openclaw status`、
`openclaw status --deep`、`openclaw health --json`），并运行
`openclaw logs --follow`，筛选 `web-heartbeat` / `web-reconnect`。

## 相关内容

- [Gateway 健康](https://funcoding.ai/agents/openclaw/gateway/health/)
- [macOS 应用](https://funcoding.ai/agents/openclaw/platforms/macos/)