Doctor

moltbot doctor 是 Moltbot 的修复与迁移工具。它修复过期配置/状态、检查健康并提供可执行的修复步骤。

快速开始

moltbot doctor

无头 / 自动化

moltbot doctor --yes

无提示接受默认（包括在适用时重启/服务/沙箱修复步骤）。

moltbot doctor --repair

应用建议修复且无提示（在安全处执行修复与重启）。

moltbot doctor --repair --force

同时应用激进修复（会覆盖自定义监管配置）。

moltbot doctor --non-interactive

无提示运行，仅应用安全迁移（配置规范化与磁盘状态迁移）。跳过需要人工确认的重启/服务/沙箱操作。检测到旧版状态时会自动运行迁移。

moltbot doctor --deep

扫描系统服务以发现额外网关安装（launchd/systemd/schtasks）。若想在写入前查看变更，可先打开配置文件：cat ~/.clawdbot/moltbot.json。

功能摘要

• 可选更新（git 安装，仅交互）。
• UI 协议新鲜度检查（协议 schema 更新时重建 Control UI）。
• 健康检查与重启提示。
• 技能状态摘要（就绪/缺失/阻塞）。
• 旧版配置值规范化。
• OpenCode Zen 提供商覆盖警告。
• 旧版磁盘状态迁移（会话/代理目录/WhatsApp 认证）。
• 状态完整性与权限检查。
• 模型认证健康：检查 OAuth 过期、可刷新即将过期令牌、报告认证配置冷却/禁用状态。
• 沙箱镜像修复（启用沙箱时）。
• 旧版服务迁移与额外网关检测。
• 网关运行时检查、端口冲突诊断、安全与认证警告。
• systemd linger 检查（Linux）。
• 源码安装检查。
• 写入更新后的配置与向导元数据。

详细行为

配置规范化、旧版配置键迁移、旧版状态迁移（磁盘布局）、状态完整性检查、模型认证健康、沙箱镜像修复、网关服务迁移与清理提示、监管配置审计与修复、网关运行时与端口诊断、Config 写入与向导元数据等。完整迁移列表与说明见英文文档。参见 代理工作区 了解工作区结构与 Git 备份。