Doctor
openclaw doctor 是 OpenClaw 的修复 + 迁移工具。它修复过时的配置/状态，检查健康状况，并提供可操作的修复步骤。
快速开始
无头 / 自动化
它的功能（摘要）
- 可选的飞行前更新（仅交互式，针对 git 安装）
- UI 协议新鲜度检查
- 健康检查 + 重启提示
- 技能状态汇总
- 旧版值的配置规范化
- 旧版磁盘状态迁移（会话/agent 目录/WhatsApp 认证）
- 状态完整性和权限检查
- 模型认证健康：检查 OAuth 过期
- 沙箱镜像修复
- 旧版服务迁移和额外网关检测
- 网关运行时检查
- 通道状态警告
- Supervisor 配置审计及可选修复
- 安全警告
- systemd linger 检查
- 写入更新配置 + 向导元数据
详细行为
1) 配置规范化
如果配置包含旧版值格式，doctor 会将它们规范化为当前架构。2) 旧版配置键迁移
当配置中存在已弃用的键时，其他命令会拒绝运行并要求您执行openclaw doctor。
Doctor 会：
- 说明检测到哪些旧版键
- 显示应用的迁移
- 重写
~/.openclaw/openclaw.json为更新后的架构
3) 旧版状态迁移（磁盘布局）
Doctor 可将旧版磁盘结构迁移至当前结构：- 会话存储 + 转录：从
~/.openclaw/sessions/到~/.openclaw/agents/<agentId>/sessions/ - Agent 目录：从
~/.openclaw/agent/到~/.openclaw/agents/<agentId>/agent/ - WhatsApp 认证状态：从旧版
~/.openclaw/credentials/*.json到~/.openclaw/credentials/whatsapp/<accountId>/...
4) 状态完整性检查
Doctor 检查：- 状态目录缺失：警告灾难性状态丢失
- 状态目录权限：验证可写性
- macOS 云同步状态目录：警告状态目录位于 iCloud Drive 下
- 会话目录缺失：
sessions/和会话存储目录是必须 - 配置文件权限：警告
~/.openclaw/openclaw.json被组或其他人读取