1. 为什么要在 Windows 上折腾 OpenClaw 命令行升级OpenClaw 是一个跑在本地的命令行工具常被用来做模型调用、Agent 编排和自动化脚本。它本身通过 npm 分发所以升级这件事本质上就是「把全局安装的包换成新版本再让后台网关重新加载」。听起来简单但 Windows 上真正动手时会遇到几个坑网关进程没停干净导致文件占用、npm 全局目录权限不足、镜像源没配导致下载卡住、升级完--version还是旧号。这篇就聚焦一件事在 Windows 的 PowerShell 里把 OpenClaw 从旧版本升到最新版并且用可复现的步骤验证升级真的生效。同时给出 TaoToken 统一 Key/API 通道的config.toml与settings.json配置骨架让升级后的 OpenClaw 能直接接上模型通道而不是升完发现调用报错。适合谁看已经在 Windows 上装了 OpenClaw、看到过 “Update available” 提示、想用命令行而不是重装来解决的人。全程用 PowerShell不需要额外装别的东西命令可以直接复制。我试过在没停网关的情况下直接npm install -g结果新版本文件写不进去--version纹丝不动白等几分钟。所以下面第一步一定是停服务这个顺序别调。2. 升级前把 TaoToken 通道准备好OpenClaw 升级后要能正常调用模型得有一个稳定的 API 入口。TaoToken 提供统一的 Key 和 API 通道把不同模型的调用收敛到一个地址上配置一次就能在 OpenClaw 里切换使用。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。你需要提前拿到两样东西一个是 API Key在控制台的 API Keys 页面创建地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 另一个是确认要用的模型名可以在模型对话页面先试跑一下地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。拿到 Key 之后先别急着写进配置建议在 PowerShell 里用环境变量存一份避免明文散落在多个文件里$env:TAOTOKEN_API_KEY sk-你的Key [Environment]::SetEnvironmentVariable(TAOTOKEN_API_KEY, $env:TAOTOKEN_API_KEY, User)第二行是写入用户级环境变量重开终端也还在。这样后面config.toml和settings.json里可以引用同一个来源升级换版本时不用重复填 Key。注意Key 只放在本地环境变量或配置文件里不要提交到 Git也不要贴到聊天窗口。控制台里可以随时吊销重建。3. 可复制的升级命令与配置骨架3.1 停网关、升级、重启的完整流程先确认当前版本留个对照openclaw --version然后按顺序执行。第一步停网关服务这一步在管理员 PowerShell 里做openclaw gateway stop第二步升级优先用内置命令openclaw update如果内置命令报错或者卡住改用 npm 强制重装。这里指定了国内镜像源并加上--unsafe-perm和--ignore-scripts避免 Windows 上常见的权限和脚本执行问题npm install -g openclawlatest --registryhttps://registry.npmmirror.com --unsafe-perm --ignore-scripts第三步重启网关并验证openclaw gateway start openclaw --version版本号变了并且启动时不再出现 “Update available”就说明升级到位了。3.2 config.toml 配置骨架OpenClaw 的主配置一般放在用户目录下的.openclaw/config.toml。下面是一个接 TaoToken 通道的骨架把base_url指向统一 API 地址Key 从环境变量读取# ~/.openclaw/config.toml [gateway] host 127.0.0.1 port 8787 auto_start true [provider.taotoken] type openai-compatible base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY default_model claude-sonnet-4-5 [logging] level infoapi_key_env写的是环境变量名不是 Key 本身这样配置文件可以安全地备份或同步。default_model换成你在模型对话页面确认可用的名字。3.3 settings.json 配置骨架有些 OpenClaw 版本或插件会读settings.json放在同一目录下。它和config.toml分工不同config.toml管网关和 providersettings.json管运行时行为和默认参数。骨架如下{ provider: taotoken, apiBase: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, model: claude-sonnet-4-5, timeoutMs: 60000, retry: { maxAttempts: 3, backoffMs: 800 }, gateway: { autoRestart: true } }两个文件里的base_url/apiBase和模型名保持一致避免出现「网关连上了但调用走错 provider」的情况。4. 验证升级与通道是否真的通了升级完只看版本号还不够得确认网关能起来、通道能调通。先看网关状态openclaw gateway status正常会返回 running 和监听端口。然后发一个最小请求验证 TaoToken 通道openclaw run --prompt 回复 ok --model claude-sonnet-4-5如果返回内容里带ok说明 Key、base_url、模型名三者都对上了。再检查一次版本和更新提示openclaw --version openclaw check-updatecheck-update返回已是最新或者没有可用更新就闭环了。整个过程的结果可以对照下面这张表检查项命令期望结果版本号openclaw --version显示新版本号网关状态openclaw gateway statusrunning端口正常通道调用openclaw run --prompt 回复 ok返回含 ok 的内容更新提示openclaw check-update无可用更新5. 本篇常见错误排查升级过程中最容易卡在几个固定位置逐个说清楚。报错一openclaw update提示文件被占用或 EPERM。这是网关没停干净。先openclaw gateway stop再用任务管理器确认没有残留的 node 进程然后重试。实在不行重启一次终端再执行。报错二npm 安装卡在下载或超时。检查是否带了--registryhttps://registry.npmmirror.com。如果公司网络有代理需要单独配置 npm 的 proxy但不要用任何绕过网络管理的方式按所在环境的合规要求处理。报错三升级后--version还是旧号。多半是全局安装路径和当前 PATH 里的不是同一个。用下面命令看实际路径npm root -g where.exe openclaw两个路径对不上就调整 PATH 或重装到正确位置。报错四网关起来了但调用返回 401。Key 没读到。确认环境变量名和配置里写的一致echo $env:TAOTOKEN_API_KEY为空就重新设置并重开终端让变量生效。报错五调用返回模型不存在。default_model写错了。去模型对话页面确认可用模型名再改config.toml和settings.json。报错六settings.json改了不生效。检查 JSON 是否有语法错误比如多了逗号。可以用 PowerShell 校验Get-Content ~/.openclaw/settings.json | ConvertFrom-Json能解析通过才说明格式没问题。6. 升级之后怎么继续用升级本身只是把版本换新真正影响日常使用的是通道配置。如果你只是偶尔跑一下模型把config.toml和settings.json配好就够了Key 在 API Keys 页面管理地址是 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入细节可以对照文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你打算长期用 OpenClaw 做编码或 Agent 任务频繁升级和调用会比较多可以看一下 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合这种持续使用的场景。想先验证模型效果直接在模型对话页面跑几条 prompt 就行地址是 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。最后留一个实用习惯每次升级前把openclaw --version的输出记一下升级后再记一次两次对照比只看「有没有报错」可靠得多。配置文件改完先跑openclaw run --prompt 回复 ok这种最小请求能省掉很多「以为配好了其实没通」的时间。