跳转至

doctor 检查什么

本页按领域汇总了 openclaw doctor 的功能。有关每项编号检查的完整行为和原理,请参阅 Doctor 页面 下的链接。

它做什么(摘要)

健康、UI 和更新
  • 针对 git 安装的可选更新前预检(仅交互式)。
  • UI 协议新鲜度检查(当协议 schema 较新时重建 Control UI)。
  • 健康检查 + 重启提示。
  • 仅问题技能和插件备注;健康清单保留在 openclaw skills check 和 openclaw plugins list 中。
  • 运行时工具 schema 检查会报告失败的 MCP 服务器并继续执行其余检查。如果无法确认子进程清理,Doctor 会保留服务器发现结果并添加清理诊断;在重新运行 Doctor 之前,请检查或停止受影响的 MCP 进程。
  • 更新期间,Doctor 会推迟 MCP 连接,并为每个启用的服务器记录一条后续命令。核心工具 schema 仍会被检查。更新后运行 openclaw doctor --lint --only core/doctor/runtime-tool-schemas 以检查 MCP 工具。
配置与迁移
  • 对旧版值形状的配置进行规范化。
  • 移除已退役的 gateway.controlUi.toolTitles 配置。工具活动描述会自动显示,无需效用模型请求。
  • 检查来自绑定 LAN 的 Gateway 的旧版默认 HTTPS Tailscale Serve 路由。Doctor 不会更改这些路由,因为状态形状无法证明所有权;在确认路由过期后,仅清除其根处理程序并手动配置托管回环入口。退役的命名服务配置会被移除,且托管入口保持禁用,直到操作员选择设备路由;自定义外部路由则获得手动指导。
  • Talk 配置迁移:从旧版扁平 talk.* 字段迁移到 talk.provider + talk.providers.<provider>。
  • 浏览器迁移检查:检查旧版 Chrome 扩展配置和 Chrome MCP 就绪状态,并提供用于原生引导检查和修复的明确命令。
  • OpenCode provider 覆盖警告(models.providers.opencode / opencode-zen / opencode-go)。
  • 旧版 OpenAI Codex provider/配置文件迁移(openai-codex → openai)以及对过时 models.providers.openai-codex 的遮蔽警告。
  • 针对 OpenAI Codex OAuth 配置文件的 OAuth TLS 前置条件检查。
  • 当 plugins.allow 受限但工具策略仍要求通配符或插件拥有的工具时,发出插件/工具允许列表警告。
  • 旧版磁盘状态迁移(sessions/agent 目录/WhatsApp 认证)。
  • 将旧版 Tailscale provider 登录从用户配置文件电子邮件别名迁移到 provider 身份。
  • 通过 openclaw doctor --fix 检测并修复合并的共享所有者配置文件;在保留个人电子邮件、角色和 GitHub 身份的同时恢复所有者身份。修复后重新连接。
  • 退役的 QMD 内存配置及派生工作区清理;参见 从 QMD 迁移。
  • 旧版插件清单契约键迁移(speechProviders、realtimeTranscriptionProviders、realtimeVoiceProviders、mediaUnderstandingProviders、imageGenerationProviders、videoGenerationProviders、webFetchProviders、webSearchProviders → contracts)。
  • 旧版 cron 存储迁移(jobId、schedule.cron、顶层 delivery/payload 字段、payload provider、notify: true webhook 回退任务)。
  • 将旧版工作区的 TOOLS.md 迁移到 AGENTS.md 的 ## Tools 部分,并在移除前归档原始文件。在 POSIX 上,Doctor 会保留现有目标文件的所有者、组和权限位。如果导入注释会新增 POSIX 读者,或者所有权无法保留,它会保留两个文件并报告警告。这些检查不保证文件系统 ACL 的保留。
  • Codex CLI 运行时固定修复(agentRuntime.id: "codex-cli" → "codex"),覆盖 agents.defaults、agents.entries.* 和 models.providers.*(包括逐模型条目)。
  • 启用插件时清理过时的插件配置;当 plugins.enabled=false 时,过时的插件引用将作为惰性包含配置保留。
状态与完整性
  • 会话锁文件检查与过期锁清理。
  • 对受影响的 2026.4.24 构建所产生的重复 prompt-rewrite 分支进行会话转录修复。
  • 卡住的主会话和子代理重启恢复 tombstone 检测。Doctor 会报告被阻塞的会话,并且只修复与现有 tombstone 冲突的过期 aborted 标志;它不会重新启用自动恢复。
  • 状态完整性与权限检查(sessions、transcripts、state 目录)。
  • 本地运行时执行配置文件权限检查(chmod 600)。
  • 模型认证健康度:检查 OAuth 过期时间,可刷新即将过期的令牌,并报告认证配置文件的冷却/禁用状态。
  • Claude CLI 发现使用 Anthropic 插件的可执行文件解析器,包括 ~/.local/bin 中的原生安装。在更新期间,Doctor 子进程可能继承 Gateway 服务更窄的 PATH;当发现的二进制文件位于该路径之外时,Doctor 会报告其位置。二进制文件缺失仍会产生安装指导。
Gateway、服务与监督进程
  • 启用沙箱时修复沙箱镜像。
  • 旧版服务迁移与额外 Gateway 检测。
  • Matrix 频道旧版状态迁移(在 --fix / --repair 模式下)。
  • Gateway 运行时检查(服务已安装但未运行;缓存的 launchd 标签)。
  • 频道状态警告(从正在运行的 gateway 检查)。
  • 特定频道的权限检查位于 openclaw channels capabilities 下;例如,Discord 语音频道权限通过 openclaw channels capabilities --channel discord --target channel:<channel-id> 审计。
  • WhatsApp 响应性会报告 Gateway 压力并检测本地 TUI 客户端,但不会将压力归因于这些客户端。在决定是否关闭客户端之前,请检查 Gateway 诊断;Doctor 不会停止它们。
  • Codex 路由修复:针对主模型、后备模型、图像/视频生成模型、心跳/子代理/压缩覆盖、hooks、频道模型覆盖和会话路由固定中的旧版 openai-codex/* 模型引用;--fix 会将它们改写为 openai/*,将 openai-codex:* 认证配置文件/顺序迁移为 openai:*,移除过时的会话运行时固定,并让修复后的有效路由决定 Codex 是否兼容。
  • 监督进程配置审计(launchd/systemd/schtasks),可选修复。
  • 为在安装或更新期间捕获了 shell HTTP_PROXY / HTTPS_PROXY / NO_PROXY 值的 gateway 服务清理嵌入的代理环境。
  • Gateway 运行时检查(不受支持的旧版 Bun 服务、版本管理器路径)。
  • Gateway 端口冲突诊断(默认 18789)。
认证、安全与配对
  • 开放 DM 策略的安全警告。
  • 本地令牌模式的网关身份验证检查(当不存在令牌来源时提供令牌生成;不会覆盖令牌 SecretRef 配置)。
  • 设备配对问题检测(待处理的首次配对请求、待处理的角色/范围升级、过期的本地设备令牌缓存漂移,以及配对记录身份验证漂移)。
工作区与 Shell
  • 部分或浅层注册表所有项目克隆警告,并为每个检测到的部分克隆键和浅层历史提供手动修复命令。
  • Linux 上的 systemd linger 检查。
  • 工作区引导文件大小检查(上下文文件的截断/接近上限警告)。
  • 默认代理的技能就绪检查;报告缺少二进制文件、环境变量、配置或操作系统要求的允许技能,并且 --fix 可以禁用 skills.entries 中不可用的技能。
  • Shell 补全状态检查和自动安装/升级。
  • 内存搜索嵌入提供程序就绪检查(本地模型或远程 API 密钥)。
  • 源代码安装检查(pnpm 工作区不匹配、缺少 UI 资源、缺少 tsx 二进制文件)。
  • 写入更新后的配置 + 向导元数据。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw