openclaw doctor¶
针对 Gateway、通道、插件、技能、模型路由、本地状态和配置迁移的健康检查与快速修复。当行为不符合预期,并且你希望用一条命令说明问题所在时,请使用它。
在聊天请求的更新过程中,Doctor 会在修复步骤之间重新检查原始请求者当前的所有者权限。移除或替换该所有者会阻止进一步更改。在变更前备份边界之后,这些检查会复用维护会话的实时读取器,而不是反复复制共享数据库。
当针对受管 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 诊断
openclaw policy—doctor --lint所报告的策略规则openclaw status— 通道和会话诊断、检查以及使用情况快照
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw