跳转至

doctor 检查内容

本页按领域汇总了 openclaw doctor 的作用。有关每个编号检查的完整行为和原因，请遵循 Doctor 页面 下的链接。

它的作用（摘要）

健康、UI 和更新
  • 针对 git 安装的可选预检更新（仅限交互式）。
  • UI 协议新鲜度检查（当协议架构更新时重建 Control UI）。
  • 健康检查 + 重启提示。
  • 仅问题技能和插件说明；健康清单仍保留在 openclaw skills check 和 openclaw plugins list。
  • 运行时工具架构检查会报告失败的 MCP 服务器，并继续执行其余检查。如果无法确认子进程清理，Doctor 会保留服务器发现项并添加清理诊断；在重新运行 Doctor 之前，请检查或停止受影响的 MCP 进程。
  • 更新期间，Doctor 会延迟 MCP 连接，并为每个已启用的服务器记录后续命令。核心工具架构仍会检查。更新后运行 openclaw doctor --lint --only core/doctor/runtime-tool-schemas 以检查 MCP 工具。
配置和迁移
  • 对旧值形状进行配置规范化。
  • 移除已弃用的 gateway.controlUi.toolTitles 配置。工具活动描述会自动显示，无需 utility-model 请求。
  • 检查来自绑定到局域网的 Gateway 的旧默认 HTTPS Tailscale Serve 路由。Doctor 不会更改这些路由，因为状态形状无法证明所有权；在确认过期路由后，仅清除其根处理器，并手动配置托管回环入站。已弃用的命名 Service 配置会被移除，并且托管入站保持禁用，直到操作员选择设备路由；自定义外部路由会收到手动指导。
  • 将旧版扁平 talk.* 字段的 Talk 配置迁移到 talk.provider + talk.providers.<provider>。
  • 浏览器迁移检查，针对旧版 Chrome 扩展配置和 Chrome MCP 就绪状态，并提供用于原生引导检查和修复的明确命令。
  • OpenCode 提供商覆盖警告（models.providers.opencode / opencode-zen / opencode-go）。
  • 旧版 OpenAI Codex 提供商/配置迁移（openai-codex → openai），以及对过期 models.providers.openai-codex 的遮蔽警告。
  • 针对 OpenAI Codex OAuth 配置文件的 OAuth TLS 先决条件检查。
  • 当 plugins.allow 具有限制性，但工具策略仍要求通配符或插件拥有的工具时，发出插件/工具允许列表警告。
  • 旧版磁盘状态迁移（会话/agent 目录/WhatsApp 身份验证）。
  • 旧版 Tailscale 提供商登录迁移，从用户资料电子邮件别名迁移到提供商身份。
  • 使用 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 版本创建的重复提示重写分支的会话转录。
  • 检测卡住的主会话和子代理重启恢复墓碑。Doctor 会报告被阻止的会话，并仅修复与现有墓碑冲突的过期 aborted 标志；它不会重新启用自动恢复。
  • 状态完整性和权限检查（会话、转录、状态目录）。
  • 在本地运行时检查配置文件权限（chmod 600）。
  • 模型身份验证健康：检查 OAuth 过期时间，可以刷新即将过期的 token，并报告 auth-profile 冷却/禁用状态。
Gateway、服务和 Supervisor
  • 启用沙箱时修复沙箱镜像。
  • 旧版服务迁移和额外 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 不会停止它们。
  • 修复旧版 openai-codex/* 模型引用，涉及主模型、回退、图像/视频生成模型、heartbeat/subagent/compaction 覆盖、hooks、通道模型覆盖和会话路由固定；--fix 会将它们重写为 openai/*，将 openai-codex:* 身份验证配置文件/顺序迁移到 openai:*，移除过期的会话/整个 agent 运行时固定，并让修复后的有效路由决定 Codex 是否兼容。
  • Supervisor 配置审计（launchd/systemd/schtasks），可选修复。
  • 清理嵌入式代理环境，针对在安装或更新期间捕获了 shell HTTP_PROXY / HTTPS_PROXY / NO_PROXY 值的 Gateway 服务。
  • Gateway 运行时检查（不支持的旧版 Bun 服务、版本管理器路径）。
  • Gateway 端口冲突诊断（默认 18789）。
身份验证、安全性和配对
  • 针对开放 DM 策略的安全警告。
  • 本地 Token 模式的网关身份验证检查（当不存在 Token 来源时提供 Token 生成；不会覆盖 Token SecretRef 配置）。
  • 设备配对问题检测（待处理的首次配对请求、待处理的角色/范围升级、过期的本地设备 Token 缓存漂移，以及已配对记录的身份验证漂移）。
工作区与 Shell
  • 针对部分或浅层 registry 拥有的项目克隆的警告，并为每个检测到的部分克隆键和浅层历史提供手动修复命令。
  • Linux 上的 systemd linger 检查。
  • 工作区引导文件大小检查（针对上下文文件的截断/接近上限警告）。
  • 默认代理的 Skills 就绪检查；报告已允许但缺少 bins、env、config 或 OS 要求的 Skills，并且 --fix 可以在 skills.entries 中禁用不可用的 Skills。
  • Shell 补全状态检查以及自动安装/升级。
  • 记忆搜索嵌入提供程序就绪检查（本地模型或远程 API 密钥）。
  • 源码安装检查（pnpm workspace 不匹配、缺少 UI 资源、缺少 tsx 二进制文件）。
  • 写入更新后的配置 + 向导元数据。

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