Doctor
openclaw doctor 是 OpenClaw 的修复与迁移工具。它可修复过期的配置/状态、检查健康状况,并提供可操作的修复步骤。
本页是一个索引。Doctor 文档分为七个页面,每页对应一个读者任务。打开与你任务匹配的页面。
Doctor 页面¶
| 页面 | 适用场景 |
|---|---|
| 运行 doctor | 运行命令、选择自动化标志,并阅读只读 lint 报告。 |
| doctor 检查项 | 按领域分组的所有修复、迁移和健康检查摘要。 |
| 配置与迁移修复 | 检查 0-2:配置规范化、旧版配置键表,以及更新时的 schema 发布。 |
| Provider 与路由修复 | 检查 2b-2g:provider 覆盖、浏览器与 Chrome MCP 就绪性、OAuth TLS 与路由清理。 |
| 状态、会话与插件修复 | 检查 3-7b:磁盘布局、cron 存储、会话完整性、模型认证、沙箱与插件安装。 |
| 网关、服务与安全检查 | 检查 8-17:服务迁移、配对、安全警告、工作区状态、认证、健康检查与 supervisor。 |
| 工作区提示与 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 与更新
- 配置与迁移
- 状态与完整性
- 网关、服务与 supervisor
- 认证、安全与配对
- 工作区与 shell
- 0. 可选更新(git 安装)
- 1. 配置规范化
- 2. 旧版配置键迁移
- 2b. OpenCode provider 覆盖
- 2c. 浏览器迁移与 Chrome MCP 就绪性
- 2d. OAuth TLS 先决条件
- 2e. Codex OAuth provider 覆盖
- 2f. Codex 路由修复
- 2g. 会话路由清理
- 3. 旧版状态迁移(磁盘布局)
- 3a. 旧版插件 manifest 迁移
- 3b. 旧版 cron 存储迁移
- 3c. 会话锁清理
- 3d. 会话转录记录分支修复
- 4. 状态完整性检查(会话持久化、路由与安全性)
- 5. 模型认证健康检查(OAuth 过期)
- 6. Hooks 模型校验
- 7. 沙箱镜像修复
- 7b. 插件安装清理
- 8. 网关服务迁移与清理提示
- 8b. 启动矩阵迁移
- 8c. 设备配对与认证漂移
- 9. 安全警告
- 10. systemd linger(Linux)
- 11. 工作区状态(技能与插件)
- 11b. Bootstrap 文件大小
- 11c. Shell 补全
- 11d. 过期渠道插件清理
- 11e. 项目克隆结构
- 12. 网关认证检查(本地令牌)
- 12b. 只读 SecretRef 感知修复
- 13. 网关健康检查与重启
- 13b. 记忆搜索就绪性
- 14. 渠道状态警告
- 15. Supervisor 配置审计与修复
- 16. 网关运行时与端口诊断
- 17. 网关运行时最佳实践
- 18. 配置写入与向导元数据
- 19. 工作区提示(备份 + 记忆系统)
- 20. 重定向的工作区别名
相关¶
- Gateway 运行手册
- Gateway 故障排查
openclaw status— 本地诊断和通道检查- 配置参考 — 核心配置键、默认值以及子系统参考链接
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw