openclaw doctor 修复工具

openclaw doctor 是 OpenClaw 的修复与迁移工具，负责修复过期配置/状态、检查健康状况并提供可操作的修复步骤。

常用命令

openclaw doctor                    # 交互式运行
openclaw doctor --yes              # 接受默认值，不提示
openclaw doctor --repair           # 自动应用推荐修复
openclaw doctor --repair --force   # 激进修复（覆盖自定义 supervisor 配置）
openclaw doctor --non-interactive  # 无提示，仅安全迁移
openclaw doctor --deep             # 扫描系统服务中的额外 gateway 安装

主要功能分类

健康与更新

• 可选的 git 安装预更新
• UI 协议新鲜度检查
• 健康检查 + 重启提示
• Skills/插件状态摘要

配置迁移

处理大量遗留配置键迁移，包括：

• routing.* → channels.* / messages.* / bindings
• agent.* → agents.defaults + tools.*
• talk.* 扁平字段 → talk.provider + talk.providers.<provider>
• messages.tts.<provider> → messages.tts.providers.<provider>
• 浏览器配置迁移（extension → existing-session）
• Codex 路由修复（openai-codex/* → openai/*）

状态与完整性

• 会话锁文件检查和清理
• 会话转录分支修复（2026.4.24 构建 bug）
• 状态目录权限检查（chmod 600）
• 模型 OAuth 令牌过期检查与刷新

Gateway 与服务

• 沙箱镜像修复
• 遗留服务迁移和额外 gateway 检测
• Supervisor 配置审计（launchd/systemd/schtasks）
• Gateway 端口冲突诊断（默认 18789）

认证与配对

• 开放 DM 策略安全警告
• Gateway 本地 token 认证检查
• 设备配对问题检测（待处理请求、token 漂移等）

工作区与 Shell

• systemd linger 检查（Linux）
• 工作区 bootstrap 文件大小检查
• Shell 补全状态检查与自动安装
• 内存搜索嵌入提供商就绪检查

配对问题诊断

doctor 会报告：

• 待处理的首次配对请求
• 已配对设备的待处理角色/范围升级
• 公钥不匹配修复
• 配对 token 范围漂移

修复命令：

openclaw devices list
openclaw devices approve <requestId>
openclaw devices rotate --device <deviceId> --role <role>

相关链接

• gateway-troubleshooting — 深度故障排查
• gateway-health — 健康检查