OpenClaw 升级翻车 doctor 跑不动?这个命令专治这种病.

OpenClaw8月31日更新v2026.8.1 (AKA OpenClaw 2.0)版以来，先后更新了8.2、9.1、9.2、9.3、9.4等几个版本。由于是破坏性的更新，所以升级后问题不断。

这几天我的 OpenClaw，过得挺惨的。升级翻了一轮，doctor 挂着一条 error，我蹲在终端里翻日志，翻到眼睛发花，也没整明白到底哪根筋搭错了。

翻来翻去，越翻越烦。

后来我摸到一个命令，openclaw triage。

跑完它，机器上那份脱敏诊断书和 AI 修复提示词就给你打包好了，直接塞给 Claude Code，让 AI 自己去修。

我一开始以为就是个高级版 doctor。结果越用越觉得，这玩意儿设计得挺有想法。今天拆给你看。

先说它到底干嘛的。openclaw triage 连着做三件事，读 doctor 的体检结果，收集脱敏的诊断档案，再写一份 8KB 以内的 AI 修复提示词。

这三步是串起来的。doctor 跑出来的 error 和 warning，会按优先级排好，配上修复建议。诊断档案就是三样，配置摘要、Gateway 状态快照、日志摘要，全部脱敏过。AI 提示词就是把这两坨揉成一段指令，大意是「机器病了，你接手，自己修」。

修的过程，OpenClaw 不管。

它只管把病历递给你请的医生。这里有个骚设计，配置文件坏到 doctor 跑不动的时候，它照样能跑。这个命令注册时加了个 configGuard: skip，意思是不依赖 openclaw.json 能不能正常解析。机器坏到这份上，triage 还能用。这命令就是干这个的。

说到脱敏，这块是我一开始没注意、后来才咂摸出味道的卖点。官方文档说诊断档案里不含密钥、不含 token、不含原始聊天记录、不含原始日志，路径还会打码。我实际跑了一次，输出长这样，

Debugging prompt: .../logs/support/openclaw-triage-prompt-....mdSanitized diagnostics: .../logs/support/openclaw-diagnostics-....zip

提示词文件是 0600 权限，只有自己能读。里面的路径都是 $OPENCLAW_STATE_DIR\logs\support\... 这种相对引用，不是写死的绝对路径。你拿去给 Claude Code 看，AI 知道你装在哪，但摸不到你的用户名。

所以放心，把这份档案喂给 AI，不会把 API Key 泄露出去。

回到怎么用。五种方式，我一个个过。

1，裸跑，让它自动找 agent。

openclaw triage

交互式终端下，它按 PATH 顺序探测你装了哪个 coding agent，Claude Code、Codex、OpenCode、Pi，找到第一个能启动的就直接用。目前只支持上面5个 coding agent。

我这边装的是 Claude Code，它就直接拉起来，把提示词塞进去了。

启动 Claude Code 的时候带了 --safe-mode，会把项目里的 hooks、plugins、skills、MCP server 全关掉，只留认证和内置工具。这是怕你项目里的启动钩子把修复流程卡住。

2，指定 agent。

openclaw triage --agent codex

不想用 Claude 就指定 Codex，还有 opencode、pi 可选。

3，只收集，不启动 agent。

openclaw triage --jsonopenclaw triage --non-interactive

--json 吐一个 JSON，里面有提示词路径、诊断包路径、检测到的 agent 列表。--non-interactive 适合丢到 CI 或脚本里。这俩模式不启动任何 agent，只把材料备好。

4，内置 agent 自己修。这个最骚。

openclaw triage --run

它不走外部 coding agent，用 OpenClaw 自己配的模型跑一个有边界的修复轮次。修复前 Doctor 跑一次 lint，修复后再跑一次，拿 error 数量看有没有真修好。限制很死，一轮，总共 10 分钟，agent 跑 5 分钟，最多 40 次工具调用，超了算失败。修完还得过 Doctor 校验，agent 自己拍胸脯说「我修好了」不算数，Doctor 说了算。注意 --run 不能和 --json、--non-interactive、--agent 同时用。

5，带上更新失败的存档。

openclaw triage --update-result <path>

升级翻车的时候，更新器会存一个失败存档。把这个路径喂进去，它会把「你从哪个版本升到哪个版本、卡在哪一步」一并塞进提示词，让 AI 带着上下文接手。

我刚才在一台 Windows 机器上真跑了一遍 openclaw triage --non-interactive。doctor 当场抓到一个 error，是 plugin-state 快照清理没完成。就是这几天折磨我的那类毛病，它一条命令就给拎出来了。我这边没把 Claude Code 的完整链路接好，所以它没直接拉起来，而是打出一段 PowerShell，五条现成命令，每条都是把脱敏提示词从 stdin 管道传给 claude、codex、opencode 或 pi。

复制 Claude Code 那条跑就行。这种模式叫手动 handoff，机器上没装 coding agent，或者你在非交互环境里，它不硬启动，把命令给你，你自己决定什么时候跑。

安全边界这块，我单独说两句。

收集阶段，它是只读的，手不伸进你的东西里。

提示词 0600 权限，只有自己能读。密钥、token、原始聊天记录、原始日志，诊断档案里一样都没有。

修复阶段更严。不管你是外部的 Claude Code 还是 --run 内置模型，它都不碰你的密钥，不删数据库，不动服务生命周期。

外部 agent 走的是你现有的认证和权限，OpenClaw 不替你做审批。--run 的内置修复，能动的只有安装目录和暂存候选目录，你的 config 碰不了，Gateway 它也不许重启。

一句话，它把 AI 关在「只能看病、不能动手术」的笼子里，除非你明确授权。

很多人会问，这跟 openclaw doctor 有啥区别。

doctor 是体检，只读，报结果，你自己看着办。triage 是「体检、开化验单、请主治医生」一整套。doctor 跑完你拿到一堆 warning，然后呢，翻文档、翻日志、猜。triage 跑完直接把病因、修复指令、脱敏诊断包打包递给 AI，AI 拿着就能动手。

所以我的用法是，先跑 doctor 看看有没有大问题，有就 triage 让 AI 修，没事就不折腾。

什么时候该用它，三个场景。

升级翻车了，OpenClaw 更新到一半挂了，报错看不懂，triage 能带着更新失败的上下文让 AI 接手。Gateway 起不来，或者起来了但行为怪怪的，跑 triage 收集诊断，让 AI 看看配置哪出了问题。还有，你就是懒得自己刨日志，一个 error 挂着好几天了，你知道不对劲但没空翻，triage 帮你把「翻日志」这步自动化了。

回到急诊室那个比喻。

openclaw triage 这名字取得是真准。triage 在医疗里就是分诊，病人来了先分类，哪个重症哪个轻症，先救哪个。OpenClaw 这个命令干的一模一样，先跑 doctor 把机器上的病灶分个轻重，打包成一份「病历加建议」，递给 coding agent。

你从蹲在终端一行行刨日志的家属，变成了递化验单给主治医生的护士。

说句不严谨的，机器开始修机器了。AI 给你修 OpenClaw，那谁来修 AI。

这个问题我不答。但我觉得，当你的 OpenClaw 挂在一个 error 上跑了两天的时候，跑一下 triage，多半比你自己刨日志快十倍。