doctor

健康检查 + 快速修复（配置 + 网关 + 遗留服务）。

用法

bash

openclaw doctor [选项]

选项

--no-workspace-suggestions: 禁用工作区记忆提示
--yes: 无需提示接受默认值（无头模式）
--non-interactive: 跳过提示；仅应用安全迁移
--deep: 扫描系统服务以查找额外的网关安装
--repair: 自动修复检测到的问题

功能

Doctor 命令会：

验证配置 - 检查配置文件语法和有效性
检查网关状态 - 确认网关服务运行正常
检测遗留服务 - 查找旧版本的服务配置
修复常见问题 - 自动修复可安全修复的问题
迁移配置 - 处理配置格式升级

示例

bash

# 运行健康检查
openclaw doctor

# 自动修复问题
openclaw doctor --repair

# 深度扫描
openclaw doctor --deep

# 无头模式（CI/CD）
openclaw doctor --non-interactive --yes

输出说明

Doctor 会输出：

✅ 通过的检查
⚠️ 警告（可能需要注意）
❌ 错误（需要修复）

常见修复

服务入口点不匹配

当在 npm 和 git 安装之间切换时，Doctor 会检测并提供修复服务配置的选项。

配置迁移

Doctor 会自动处理配置格式的向后兼容迁移。

端口冲突

检测到端口被占用时，会提供建议。

相关命令

status - 状态查看
health - 健康检查
gateway status - 网关状态