openclaw doctor¶
针对 Gateway、通道、插件、技能、模型路由、本地状态和配置迁移的健康检查与快速修复。每当出现不符合预期的行为，并且你希望用一条命令解释问题所在时，都可以使用它。
当针对受管理的 Gateway 运行时，Doctor 会将活动官方插件与已安装服务引用的 OpenClaw 包进行比较。即使 Gateway 已停止或不可达，此检查仍然有效。当旧版 Gateway 仍在运行时，Doctor 会将其版本与重启后的版本分开报告。如果无法识别服务包，Doctor 会将重启就绪状态报告为未知，而不是将该插件集视为兼容。
当 Gateway 状态报告降级的 SecretRef 所有者时，Doctor 会打印 Secret 运行时降级 警告，并列出每个冷或过期的所有者、受影响的配置路径、已脱敏的原因以及 openclaw secrets reload 重试命令。
当通道入站事件进入死信时，Doctor 会列出每个受影响的通道账户，并指向 openclaw channels dead-letters list 以进行检查和恢复。
当注册表拥有的项目克隆不完整或为浅克隆时，Doctor 会发出警告。它会列出克隆、浅克隆状态以及部分克隆配置键，包括以 URL 为键的远程孪生。它会打印手动修复命令；--fix 不会获取或重新打包这些克隆。Agent 工作区和手动注册的检出被排除。
当 Gateway 具有导出器健康事实时，Doctor 会在 遥测导出器 下报告最新的受信任的按信号状态和传输。摘要已脱敏，不包含端点值、请求头、证书、负载或原始错误。
Doctor 会报告使用成本缓存刷新失败的会话，因为其总计可能不完整。检查 Gateway 日志并再次请求用量以重试。有界失败历史会在重启之间保留最近 256 个会话；成功刷新会清除该会话的警告。--fix 不会在会话成功刷新前清除警告。
相关：
Doctor 页面¶
本页是索引。openclaw doctor 在七个页面中有文档，每个页面对应一种读者任务。打开与你的任务匹配的页面。
| 页面 | 何时阅读 |
|---|---|
| 运行 Doctor | 选择一种姿态，复制一个可用示例，或查询某个选项的作用。 |
| Gateway 和服务恢复 | Gateway 服务、远程目标、Control UI 资产或 Gateway token 需要修复。 |
| Lint 和升级后模式 | 你需要用于 CI 门禁的只读发现，或升级后的插件兼容性探测。 |
| 结构化健康检查契约 | 你正在编写 Doctor 检查或基于插件的健康检查。 |
| 旧状态迁移 | 文件到 SQLite 的迁移被阻塞，需要手动对账。 |
| SQLite 维护和会话迁移 | 你正在压缩数据库，或导入、验证或恢复会话历史。 |
| 其他检查和修复 | 你想查看其余所有检查和修复的清单，从 Nix 模式到通道。 |
各章节迁移位置¶
之前单页版本中的每个章节标题都在此处保留其锚点，因此诸如 /cli/doctor#session-sqlite-migration 这样的现有链接仍然可以解析。每个条目都指向现在承载该内容的页面。
- 姿态
- Gateway 服务恢复
- 远程 Gateway 恢复
- Control UI 资产
- 示例
- 选项
- Lint 模式
- 结构化健康检查
- 检查选择
- 升级后模式
- 旧状态迁移
- 共享状态 SQLite 压缩
- 会话 SQLite 迁移
- 会话 SQLite 迁移后降级
- 说明
- 无效 Gateway token
- macOS：
launchctl环境变量覆盖 - macOS：
launchctl环境变量覆盖
相关¶
- CLI 参考
- Gateway doctor
openclaw policy—doctor --lint所报告的策略规则openclaw status— 通道和会话诊断、探测以及用量快照
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw