1. openclaw update 之后版本还是旧的先分清你装的是哪种很多人第一次遇到 openclaw update 的问题场景都差不多终端里敲完openclaw update看着它跑完一堆输出心里以为搞定了结果openclaw --version一看还是老版本。或者更糟更新完 gateway 起不来doctor 一堆红字整个人卡在那里不知道从哪下手。这个问题的根源往往不是 update 命令本身坏了而是你没搞清楚自己这套 OpenClaw 到底是 npm 全局包安装还是 git 源码检出。这两种安装方式更新路径完全不同混着用就会出各种版本不一致的怪现象。我先把结论摆出来openclaw update 会自动检测安装类型但检测逻辑依赖~/.openclaw下的状态文件。如果你之前手动npm i -g装过又用 installer 装过一次状态就可能打架。这时候最靠谱的做法是先用openclaw update status --json看清楚它认为你是什么安装类型再决定走 npm 还是 git 这条路。这篇内容适合三类人一是刚接触 OpenClaw、被 update 报错卡住的新手二是想把 endpoint 和鉴权统一到 TaoToken 通道、避免每个工具各配一套 Key 的开发者三是长期跑 gateway 服务、需要稳定更新流程的运维向用户。核心检索词就是 openclaw update、npm 全局包、git 拉取、doctor 自检这四件事我会一条条拆开讲每条都给能直接复制的命令。先说清楚 OpenClaw 是什么它是一个带 CLI 和 gateway 服务的智能体运行框架你可以把它理解成一个「本地大脑 网关」的组合CLI 负责命令交互gateway 负责常驻服务。update 要同时照顾这两部分所以它比单纯npm update复杂。适合谁适合需要长期跑 Agent、又希望版本可控的人。不适合只想临时试一下、装完就删的人那种场景直接重装更省事。下面进入正题从三条排查路径讲起最后把配置统一到 TaoToken 通道并用一次完整 update 验证。2. TaoToken 前置准备统一 Key 与 API 通道在动 update 之前我建议你先把 API 通道这件事理顺。原因很简单OpenClaw 更新后配置文件结构偶尔会变如果你每个模型、每个工具都单独填 endpoint 和 Key更新一次就要重配一遍非常痛苦。把通道统一到 TaoToken后面无论怎么更新只要改一处就行。TaoToken 在这里扮演的角色是一个统一的 API 接入层。你拿到一个 Key配一个 Base URL就能在 OpenClaw 里调用多种模型不用为每个模型单独申请账号。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 这个地址不带 UTM 参数配置时直接写这个。你需要准备三样东西我称之为「三件套」Base URL、API Key、Model ID。这三样在 OpenClaw 的配置里会反复出现尤其是 auth.json 和 openclaw.json 这两个文件。Base URL 填https://taotoken.net/api。API Key 在控制台创建入口是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后复制出来注意别泄露。Model ID 根据你要用的模型填比如你想用某个编码模型就填对应的模型标识具体可以在模型对话页确认入口是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。这里有个坑要提前说OpenClaw 的 auth.json 里Key 的字段名和 openclaw.json 里的 endpoint 字段名不同版本可能不一样。更新后如果 doctor 报鉴权失败第一件事就是打开这两个文件对照字段名别想当然。为什么强调「前置」因为 update 过程中如果 gateway 正在跑它会用旧配置启动新进程配置没理顺的话更新完直接鉴权失败你会以为是 update 把东西搞坏了其实是配置没跟上。所以顺序是先确认三件套再动 update。如果你还没创建 Key现在去控制台建一个顺手把 Base URL 和 Model ID 记在便签上。接下来所有配置片段都围绕这三样展开。这一步花五分钟能省掉后面半小时的排障。3. 可复制配置npm 更新命令、git 分支切换与 settings 片段这一节是全文最实操的部分我按 npm 路径、git 路径、配置文件三块来讲每块都给能直接复制的命令和片段。先说 npm 全局包路径。如果你确认自己是 npm 安装最稳的更新方式是npm i -g openclawlatest但更推荐用 OpenClaw 自带的 update因为它能协调 gateway 服务openclaw update想预览不实际执行加--dry-runopenclaw update --dry-run想要结构化结果加--jsonopenclaw update --json注意openclaw update不接受--verbose这是很多人踩的坑。想看诊断信息用--dry-run或openclaw update status --json。切换通道用--channelopenclaw update --channel beta openclaw update --channel dev openclaw update --tag main--channel dev会确保走 git 检出stable和beta走包安装。如果你 npm 装完 update 失败可以用 installer 恢复curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm想锁定版本curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm --version version-or-dist-tag再说 git 路径。如果你是源码检出更新流程是git fetch origin git checkout main git pull pnpm install pnpm build openclaw gateway restart想切到某个历史提交git fetch origin git checkout $(git rev-list -n 1 --before\2026-01-01\ origin/main) pnpm install pnpm build openclaw gateway restart回到最新git checkout main git pull。如果遇到 pnpm/corepack bootstrap 报错手动装 pnpm 再重跑。最后是配置文件。OpenClaw 的配置主要在~/.openclaw/openclaw.json和~/.openclaw/auth.json。把 endpoint 和 Key 统一到 TaoTokenopenclaw.json 里大致这样写{ update: { channel: stable, auto: { enabled: false, stableDelayHours: 6, stableJitterHours: 12, betaCheckIntervalHours: 1 } }, model: { baseUrl: https://taotoken.net/api, modelId: your-model-id } }auth.json 里放 Key{ apiKey: sk-your-taotoken-key }如果你用的是 Codex 风格的 auth.json字段名可能是OPENAI_API_KEY或类似具体以你版本为准。Cline MCP 或 CC Switch 场景下同样把 Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填对应模型。这三件套在哪个工具里都是同一套别每个工具填不一样的。配置改完别急着 update先openclaw doctor看一眼确认配置能被正确读取。这一步能提前暴露字段名写错的问题。4. 验证请求一次完整 update 与成功结果解读配置理顺后跑一次完整 update 验证。我建议按这个顺序来每一步都有明确的成功标志。第一步看当前状态openclaw update status --json输出里会告诉你当前 channel、安装类型、可用版本。重点看installType字段是npm还是git这决定你后面走哪条路。第二步预览更新openclaw update --dry-run它会列出计划执行的动作比如「fetch latest」「run doctor」「restart gateway」。如果这里就报错说明状态文件有问题先解决再继续。第三步正式更新openclaw update成功的话你会看到它依次完成包替换、doctor 自检、gateway 重启。注意 npm 路径下它会先把目标版本装到临时 prefix验证 dist 清单再替换到全局 prefix避免旧文件残留。如果安装命令失败它会用--omitoptional重试一次。第四步跑 doctoropenclaw doctordoctor 会迁移配置、审计 DM 策略、检查 gateway 健康。输出里如果有OK或passed说明没问题。看到WARN要读清楚看到ERROR必须解决。第五步重启 gatewayopenclaw gateway restart第六步验证健康openclaw health返回健康状态就说明整条链路通了。怎么确认 TaoToken 配置生效更新后发一个测试请求比如用 CLI 触发一次模型调用看返回是否正常。如果返回鉴权错误回到 auth.json 检查 Key如果返回 endpoint 错误检查 openclaw.json 里的 baseUrl 是不是https://taotoken.net/api。成功的话你会看到模型正常返回内容这就证明三件套配对了。我实测下来npm 路径最容易出问题的是 gateway 没重启旧进程还在用被替换的包文件导致行为诡异。所以 update 完一定手动openclaw gateway restart一次别偷懒。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节对照真实报错讲每个都给排查方向。401 Unauthorized最常见。原因通常是 auth.json 里的 Key 没更新或者字段名写错。排查步骤打开~/.openclaw/auth.json确认 Key 是 TaoToken 控制台创建的那个字段名和当前版本要求一致。如果用的是 Codex 风格确认是OPENAI_API_KEY还是apiKey。改完跑openclaw doctor再试。local proxy failed这个报错通常和网络配置有关。先确认 Base URL 写的是https://taotoken.net/api没有多余斜杠或路径。然后检查 gateway 是否正常启动openclaw gateway restart一次。如果还报看 doctor 输出里有没有端口冲突。reading choices 报错这通常是模型返回格式解析失败根源可能是 Model ID 填错或者 endpoint 指向了不兼容的接口。确认 Model ID 和你在模型对话页看到的一致Base URL 用 TaoToken 的 API 地址。如果换了模型还报检查 openclaw.json 里 model 段的结构是否符合当前版本。OAuth 相关报错如果你之前用 OAuth 方式登录过某个模型更新后 OAuth token 可能失效。排查方向是清掉旧的 OAuth 缓存改用 API Key 方式。在 auth.json 里确保用的是 Key 而不是 OAuth token。CC Switch 或 Cline MCP 场景下同样优先用 Key 方式避免 OAuth 过期问题。pnpm/corepack bootstrap errorgit 路径常见。手动装 pnpmnpm i -g pnpm然后重跑 update。或者重新启用 corepack。版本不一致update 完openclaw --version还是旧的。原因可能是 PATH 里有多个 openclaw或者 npm 全局 prefix 和实际执行的不是同一个。用which openclaw看路径用npm prefix -g看全局 prefix两者要对上。对不上就调整 PATH 或重装。排查通用原则先openclaw doctor再openclaw update status --json两个输出对照看大部分问题能定位。如果卡住去文档页查入口是 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有接入和排障说明。6. 把通道固定下来长期编码与 Agent 场景的配置建议排障讲完说点长期的。如果你打算长期跑 OpenClaw 做编码或 Agent 任务建议把通道固定成一套别每次更新都重配。具体做法openclaw.json 里把update.auto.enabled设为 false手动控制更新时机避免自动更新在你跑任务时重启 gateway。然后把 model 段的 baseUrl 固定为https://taotoken.net/apimodelId 固定成你常用的那个。auth.json 里的 Key 单独管理更新前备份一份。如果你用 Coding Plan 跑长期编码任务入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 可以把 Key 和通道统一到那里管理。Claude Code 或 Anthropic 风格接入的场景入口是 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 同样用 Base URL Key Model ID 三件套。API Keys 管理入口是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 建议定期轮换 Key更新前先确认新 Key 能用。最后给个实用技巧每次 update 前先cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak出问题能快速回滚。更新后如果 doctor 报配置迁移别慌按提示走迁移一般不会丢数据。整套流程跑顺之后openclaw update 就是一条命令的事版本不一致和鉴权报错基本不会再找上门。