健康检查
对 OpenClaw 网关执行五步诊断，查看信任状态，并导出轻量健康证据。
/health-check概述#
健康检查提供一套五步诊断向导，逐层验证 OpenClaw 网关的运行状态——从基础连通性到 IM 通道就绪性。首次添加连接器时它会作为引导流程的一部分自动运行，之后也可随时作为独立工具使用。
除了诊断向导，健康检查现在还保留一条轻量证据链：来自每夜 TCC 审计的信任状态、最近的健康检查时间线，以及可导出的摘要数据，便于事故复盘和变更留痕，而不再额外做一个独立的 AI 报告产品面。
前置条件#
- 已配置至少一个连接器（参见「连接器」）
使用反馈#
运行健康检查后，你将看到：
- -五步诊断结果——每步显示通过（绿色）、警告（琥珀色）或失败（红色），并附带修复建议
- -整体状态摘要——根据各步结果综合判定为健康、降级或危急
- -信任评分——TCC（可信变更控制）每夜审计摘要，反映配置安全水平
- -健康检查历史时间线——过往结果记录，用于趋势追踪和回归检测
- -轻量健康证据——可信状态快照与最近诊断摘要，可用于导出或后续复查
Web 端操作#
从侧边栏的「系统」分组中导航至健康检查页面。
执行健康检查
点击「运行」按钮启动新的诊断。向导按顺序执行五个步骤：(1) 连通性——验证网关可达并检查安全连接（wss/https）；(2) 模型可用性——发现 Agent 并验证健康状态；(3) 定时任务沙箱——检查定时任务成功率；(4) 预算保护——验证成本保护配置；(5) IM 通道——探测 Telegram、Discord、Slack 的配置、登录和消息收发能力。各步骤独立执行，即使后续步骤失败也能获得部分结果。
理解诊断结果
每个步骤显示通过、警告或失败状态。通过表示检查完成且无问题。警告表示存在非关键问题但值得关注——例如定时任务成功率偏低，或 IM 通道已配置但未登录。失败表示需要立即处理的关键问题，例如网关无法连通。每条警告和失败都附带修复建议，说明下一步该怎么做。
信任状态
信任状态面板展示 TCC（可信变更控制）的每夜审计摘要。这是一个每天自动运行的后台流程，检查配置漂移、权限变更和安全态势。面板显示最新的信任评分以及最近一次审计周期中标记的问题。
健康检查历史
所有历史健康检查结果以时间线形式展示。每条记录包含日期、整体状态和各步骤结果。利用历史记录追踪趋势——例如发现定期出现的连通性问题，或确认某次修复操作确实解决了之前的警告。
CLI 端操作#
查看已连接网关的当前健康状态
$ ap health-check status对网关执行新的五步诊断检查
$ ap health-check run运行完整诊断，为每个问题提供详细修复建议
$ ap health-check diagnose移动端操作#
在移动端，进入「更多」标签页并选择「健康检查」。移动版提供简化的就绪检查视图。
- -简化的五步诊断视图，每步显示通过/警告/失败指示器
- -网关整体状态摘要（健康、降级或危急）
- -下拉刷新，随时重新执行就绪检查