openclaw health¶

通过 WebSocket RPC 从正在运行的 Gateway 获取健康快照（CLI 不直接建立通道套接字）。

选项¶

示例：

openclaw health
openclaw health --json
openclaw health --timeout 2500
openclaw health --verbose
openclaw health --debug

行为¶

• 本地 Gateway 启动使用共享的 60 秒就绪预算，并报告其观察到的阶段。显式 --timeout 会覆盖该预算。如果截止时间时启动仍在进行，则返回非失败结果；JSON 报告 { "status": "starting", "startupPhase": "…" }，而不是健康快照。

• 本地就绪状态会识别提供回环服务的通配符监听器，包括在 macOS 上同一端口上单独的回环绑定可能成功的情况。

• 未使用 --verbose 时，Gateway 可以返回缓存快照，并在后台为下一个调用者刷新它。缓存快照在最多 60 秒内保持新鲜，并且与实时通道运行时状态保持一致。

• --verbose 会强制对每个通道账户进行实时探测。它还会打印 Gateway 连接详情。它会展开所有已配置账户和代理的人类可读输出，而不仅仅是默认代理。
• 未配置或已禁用的首选账户不会隐藏其他活动账户的探测结果。普通输出仍遵循默认代理的账户绑定。--verbose 包含所有账户。
• 当显示的账户已禁用时，健康文本会显示 disabled，并且 status --deep 会将其标记为 OFF，即使该账户仍处于已配置状态。
• 不健康的通道行在可用时会包含记录的启动错误，因此已停止的通道会与其状态一起报告失败原因。
• 人类可读输出包括显式、自动或默认启用的插件的失败，以及已配置但不可用的插件的警告。它最多显示 20 条插件诊断，外加一个省略计数。这些警告也会出现在 openclaw gateway health 和 openclaw status --deep 中的 Health 表里。插件诊断会针对单行终端输出进行清理；JSON 保留快照值。
• 就绪后，--json 返回完整快照：通道、按账户探测、插件加载状态、上下文引擎隔离状态、模型定价缓存状态、事件循环健康、投递队列警告，以及按代理的会话存储。
• 配置读取失败会报告不可读的路径和底层错误，而不是凭据缺失诊断。这也适用于 openclaw gateway health。
• 文本和 JSON 中的会话年龄使用 Gateway 的时钟。
• 文本中的心跳间隔显示解析后的频率，不会舍去毫秒。对于长间隔，会保留周单位。
• 顶层 ok: true 表示健康 RPC 成功，并且 Gateway 生成了快照。队列和插件警告不会将其变为 false。
• 当出站或会话投递，或入站通道事件，被死信处理时，文本输出会报告其数量和最旧失败时长。入站数量按通道账户分组。使用 openclaw channels dead-letters 检查或恢复单个事件。
• 可选的 deliveryQueues.ingressPressure 汇总可能阻塞后续事件的持久入站泳道。它按通道账户分组，并且从不暴露事件、泳道、负载、错误、所有者、token、会话或目标标识符。有关精确的判定条件与计数语义，请参阅 Gateway 健康。

相关¶

• CLI 参考
• openclaw status — 本地诊断和通道探测，无需完整健康快照
• Gateway 健康