跳转至

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)仍然可以解析。每个条目都指向现在承载该内容的页面。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw