Doctor
openclaw doctor 是 OpenClaw 的修复和迁移工具。它会修复过期的配置/状态，检查健康状况，并提供可操作的修复步骤。
本页是索引。Doctor 的文档分布在七个页面中，每个页面对应一种读者任务。 打开与你的任务匹配的页面。
Doctor 页面¶
| 页面 | 何时阅读 |
|---|---|
| 运行 doctor | 运行命令，选择自动化标志，并阅读只读 lint 报告。 |
| doctor 检查什么 | 按领域分组的所有修复、迁移和健康检查摘要。 |
| 配置和迁移修复 | 检查 0-2：配置规范化、旧版配置键表以及更新时的 schema 发布。 |
| 提供者和路由修复 | 检查 2b-2g：provider 覆盖、浏览器和 Chrome MCP 就绪状态、OAuth TLS 以及路由清理。 |
| 状态、会话和插件修复 | 检查 3-7b：磁盘布局、cron 存储、会话完整性、模型认证、沙箱以及插件安装。 |
| Gateway、服务和安全检查 | 检查 8-17：服务迁移、配对、安全警告、工作区状态、认证、健康以及 supervisors。 |
| 工作区提示和 Dreams UI 操作 | 检查 18-20，外加 Control UI 的 Dreams 回填、重置和清除操作。 |
各章节迁移位置¶
之前单页版本中的每个章节和检查标题都会在此保留其
锚点，因此诸如 /gateway/doctor#9-security-warnings
之类的现有链接仍然可以解析。每个条目都指向当前承载该内容的页面。
- 快速入门
- 无头模式和自动化模式
- 2026.9.2 更新期间的 schema 发布
- 只读 lint 模式
- 它的作用（摘要）
- Dreams UI 回填和重置
- 详细行为和原理 — 现在是五个页面，如上所列。
- 2026.9.2 更新期间的 schema 发布
- 它的作用（摘要）
- --yes
- --fix
- --lint
- --fix --force
- --non-interactive
- --deep
- 健康、UI 和更新
- 配置和迁移
- 状态和完整性
- Gateway、服务和 supervisors
- 认证、安全和配对
- 工作区和 shell
- 0. 可选更新（git 安装）
- 1. 配置规范化
- 2. 旧版配置键迁移
- 2b. OpenCode provider 覆盖
- 2c. 浏览器迁移和 Chrome MCP 就绪状态
- 2d. OAuth TLS 先决条件
- 2e. Codex OAuth provider 覆盖
- 2f. Codex 路由修复
- 2g. 会话路由清理
- 3. 旧版状态迁移（磁盘布局）
- 3a. 旧版插件清单迁移
- 3b. 旧版 cron 存储迁移
- 3c. 会话锁清理
- 3d. 会话转录分支修复
- 4. 状态完整性检查（会话持久化、路由和安全）
- 5. 模型认证健康（OAuth 过期）
- 6. Hooks 模型验证
- 7. 沙箱镜像修复
- 7b. 插件安装清理
- 8. Gateway 服务迁移和清理提示
- 8b. 启动 Matrix 迁移
- 8c. 设备配对和认证漂移
- 9. 安全警告
- 10. systemd linger（Linux）
- 11. 工作区状态（skills 和 plugins）
- 11b. Bootstrap 文件大小
- 11c. Shell 补全
- 11d. 过期 channel 插件清理
- 11e. 项目克隆结构
- 12. Gateway 认证检查（本地 token）
- 12b. 只读 SecretRef 感知修复
- 13. Gateway 健康检查 + 重启
- 13b. 内存搜索就绪状态
- 14. Channel 状态警告
- 15. Supervisor 配置审计 + 修复
- 16. Gateway 运行时 + 端口诊断
- 17. Gateway 运行时最佳实践
- 18. 配置写入 + 向导元数据
- 19. 工作区提示（备份 + 内存系统）
- 20. 重新指向的工作区别名
相关¶
- Gateway 运行手册
- Gateway 故障排除
openclaw status— 本地诊断和通道探测- 配置参考 — 核心配置键、默认值以及子系统参考链接
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw