你的龙虾医生
openclaw doctor 是 OpenClaw 内置的诊断和修复工具。无论是安装后遇到问题、升级后配置不兼容，还是网关无法启动，doctor 都是你应该首先尝试的命令。
基本用法
# 交互式诊断（推荐）
openclaw doctor
# 自动修复（无需确认）
openclaw doctor --repair
# 非交互模式（只执行安全迁移）
openclaw doctor --non-interactive
# 全自动（接受所有建议）
openclaw doctor --yes
检查哪些内容
配置与状态
- 验证配置文件权限和格式
- 检测并迁移过时的配置项（如旧版键名）
- 检查状态目录完整性
- 警告将状态放在 iCloud 等云同步目录中的风险
模型与认证
- 检查 OAuth Token 是否过期，提供刷新选项
- 报告认证配置的冷却和禁用状态
- 验证模型引用是否在目录中存在
网关与服务
- 运行健康检查，提供重启建议
- 检测端口冲突（默认 18789）
- 审计守护进程配置（launchd / systemd / 计划任务）
- 检查运行时环境（Node vs Bun，版本管理器路径）
频道状态
- 探测各聊天频道的连接状态
- 检查浏览器和 Chrome MCP 版本
- 验证提供商配置
自动修复能力
Doctor 能自动处理的问题包括：
- 配置文件从旧版格式迁移到新版
- 会话和代理目录的重新组织
- WhatsApp 认证状态文件的位置迁移
- Cron 定时任务存储格式更新
- 沙箱镜像修复
实用建议
- 每次升级后都运行一次
openclaw doctor - 遇到"命令未找到"或"端口被占用"时，先跑 doctor
- 生产环境建议用
--non-interactive避免意外操作 - Doctor 给出的"下一步建议"通常能直接解决问题