1. Windows 装 OpenClaw 到底卡在哪node/npm/git 三件套与统一 Key 的真实场景OpenClaw 是一个跑在本地、通过命令行交互的 AI Agent 工具能帮你把模型能力接进终端、编辑器和工作流里。它适合谁适合想在 Windows 上快速搭一个本地 AI 助手、又不想折腾复杂容器和云主机的开发者。但很多人第一次装就卡住问题往往不在 OpenClaw 本身而在它依赖的三件套node、npm、git。node 是运行时npm 是包管理器git 负责拉取依赖仓库缺一个都会在安装阶段报错。更麻烦的是网络与 Key 管理。默认情况下OpenClaw 会去请求官方模型端点国内直连经常超时就算连上了每个模型单独配一个 Key切换起来也很烦。我试过把 endpoint 和 Key 统一改到 TaoToken一次配置所有模型请求都走同一个入口省去反复改配置的麻烦。这篇就按「环境准备 → 依赖安装 → 统一 Key 接入 → 验证 → 排错」的完整链路走一遍每一步都给可复制的命令和配置片段。先说清楚整体思路Windows 下装 OpenClaw核心是先把 node/npm/git 装好并配好国内源再用 npm 全局安装 OpenClaw最后把模型请求的 Base URL 和 API Key 指向 TaoToken。整个过程不需要容器不需要额外服务一台普通 Windows 机器就能跑。下面从环境检查开始逐项拆解。2. 前置准备node/npm/git 环境检查与国内源配置2.1 用管理员权限打开 PowerShellWindows 下很多安装命令需要写系统目录普通权限会失败。按 Win 键搜索 PowerShell右键选择「以管理员身份运行」。这一步别省后面 npm 全局安装、环境变量写入都依赖管理员权限。打开后先确认当前目录和权限输入whoami $PSVersionTable.PSVersion输出里能看到你的用户名和 PowerShell 版本即可。如果版本低于 5.1建议先升级否则部分命令语法不兼容。2.2 安装 git 并验证git 是 npm 拉取某些依赖时的底层工具OpenClaw 的部分包会从 git 仓库直接拉取。去 git 官网下载 Windows 安装包双击按向导走安装时保持默认选项即可尤其是「Adjusting your PATH environment」要选「Git from the command line and also from 3rd-party software」这样 git 才会进 PATH。装完新开一个 PowerShell 窗口重要旧窗口不会刷新 PATH验证git --version输出类似git version 2.47.0.windows.1就成功了。如果提示「无法将 git 项识别为 cmdlet」说明 PATH 没生效重启终端或重启电脑再试。2.3 安装 node 与 npm推荐手动下载安装包比包管理器省心。去 node 官方镜像站下载最新 LTS 的.msi安装包双击安装向导里勾选「Add to PATH」其余默认。安装完成后同样新开窗口验证node -v npm -v两条命令都输出版本号比如v22.11.0和10.9.0说明 node 和 npm 都就位了。npm 是随 node 一起装的不用单独装。2.4 配置国内源关键一步默认 npm 源在国外装 OpenClaw 这种依赖较多的包会非常慢甚至超时中断。切换成国内镜像npm config set registry https://registry.npmmirror.com npm config get registry第二条命令应该输出https://registry.npmmirror.com/说明源已生效。如果你后续用 pnpm也同步配一下npm install -g pnpm pnpm config set registry https://registry.npmmirror.com到这里node/npm/git 三件套和国内源都准备好了。这一步是整个安装链路的地基地基不稳后面全是报错。3. 可复制配置安装 OpenClaw 并把模型请求统一改到 TaoToken3.1 全局安装 OpenClaw环境就绪后一条命令装 OpenClawnpm i -g openclaw装完验证openclaw --version能输出版本号就说明安装成功。如果这一步报错大概率是 git 没装好或 npm 源没配回到第 2 节检查。3.2 初始化并进入配置首次运行需要初始化openclaw onboard向导会引导你选择模型提供方、填入 API Key。这里先别急着填官方 Key我们直接把它指向 TaoToken统一管理。3.3 统一 Key 接入Base URL Key Model ID 三件套OpenClaw 的模型配置通常放在用户目录下的配置文件中Windows 路径一般是C:\Users\你的用户名\.openclaw\config.json不同版本可能略有差异以openclaw config path输出为准。先查一下配置路径openclaw config path拿到路径后用编辑器打开该 JSON 文件把模型请求的 endpoint 和 Key 改成 TaoToken 的统一入口。可复制的配置片段如下{ provider: { baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, model: claude-sonnet-4-20250514 } }三个字段缺一不可baseUrl指向 TaoToken 的 API 入口apiKey填你在 TaoToken 控制台生成的 Keymodel填你要用的模型 ID。这样所有模型请求都走同一个 endpoint 和同一个 Key切换模型只改model字段即可。如果你用的是环境变量方式也可以在 PowerShell 里设置$env:OPENCLAW_BASE_URLhttps://taotoken.net/api $env:OPENCLAW_API_KEY你的_TaoToken_API_Key $env:OPENCLAW_MODELclaude-sonnet-4-20250514环境变量方式适合临时测试配置文件方式适合长期使用。建议两者选其一避免冲突。3.4 获取 TaoToken API Key如果你还没有 Key去 TaoToken 控制台创建一个。地址是https://taotoken.net/api-keys登录后在 API Keys 页面点新建复制生成的 Key 填到上面的配置里。注意 Key 只显示一次复制后妥善保存。3.5 后台运行与日志配置好后启动 OpenClaw 网关openclaw gateway --port 18789如果想让它后台跑把输出重定向到日志文件openclaw gateway --port 18789 openclaw.log 21这样即使关掉终端网关仍在运行日志写在openclaw.log里出问题直接看这个文件。4. 验证请求逐项命令与成功结果对照配置写完不算完得逐项验证。下面按顺序跑一遍每步都有预期输出。4.1 验证环境三件套node -v npm -v git --version三条都输出版本号说明基础环境没问题。任何一条报「无法识别」回到第 2 节重装。4.2 验证 OpenClaw 安装openclaw --version openclaw config path第一条输出版本号第二条输出配置文件路径。确认路径和你编辑的是同一个文件。4.3 验证模型连通性用 OpenClaw 发一条测试请求openclaw chat 你好请回复一句话如果配置正确你会看到模型返回的文本。这一步成功说明 Base URL、Key、Model ID 三件套都生效了。4.4 验证网关端口netstat -ano | findstr 18789能看到监听记录说明网关正常启动。如果端口被占用换个端口重启即可。4.5 验证日志无报错Get-Content openclaw.log -Tail 20看最后 20 行没有error或failed字样就正常。有报错的话对照第 5 节排查。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth装 OpenClaw 最容易踩的坑集中在几个报错上逐个拆解。5.1 401 Unauthorized报错长这样Error: 401 Unauthorized - invalid api key原因API Key 填错、过期或者 Key 和 Base URL 不匹配。排查步骤先确认baseUrl是https://taotoken.net/api没有多余斜杠再确认apiKey是从 TaoToken 控制台复制的完整 Key没有空格最后去控制台看 Key 是否被禁用或额度耗尽。改完配置后重启网关。5.2 local proxy failed报错长这样Error: local proxy failed to connect原因网关没启动或者端口被占用。排查先netstat -ano | findstr 18789看端口状态如果没监听重新openclaw gateway --port 18789如果被占用换端口--port 18790。另外检查防火墙是否拦截了本地端口。5.3 reading choices 报错报错长这样TypeError: Cannot read properties of undefined (reading choices)原因模型返回结构不符合预期通常是 Base URL 指向了错误的端点或者模型 ID 写错。排查确认baseUrl是https://taotoken.net/apimodel字段填的是 TaoToken 支持的模型 ID。改完重启。5.4 OAuth 相关报错报错长这样Error: OAuth token expired or invalid原因某些模型提供方用 OAuth 鉴权Token 过期。如果你走 TaoToken 统一 Key一般不会遇到如果遇到检查配置里是否残留了旧的 OAuth 字段删掉后只保留baseUrl、apiKey、model三件套。5.5 npm 安装报错需装 git报错长这样npm ERR! code ENOENT npm ERR! syscall spawn git原因git 没装或没进 PATH。排查git --version验证没输出就重装 git 并勾选 PATH 选项重启终端。5.6 依赖拉取超时报错长这样npm ERR! network timeout原因npm 源没切国内。排查npm config get registry确认输出https://registry.npmmirror.com/不是就重新npm config set registry。6. 把 Key 统一到 TaoToken 之后长期编码与 Agent 场景的接入建议配置跑通后你会发现统一 Key 的好处不只是省事。以前每个模型单独配 Key切换模型要改配置、重启、验证来回折腾现在只改model字段Base URL 和 Key 不动切换成本几乎为零。对于长期跑编码任务或 Agent 工作流的场景这种统一入口能省下大量维护时间。如果你打算把 OpenClaw 用在日常编码里建议把配置固化到项目级而不是全局。在项目根目录建一个.openclaw/config.json填入同样的三件套这样不同项目可以用不同模型互不干扰。团队协作时把baseUrl和model写进配置apiKey用环境变量注入避免 Key 泄露。另外OpenClaw 的网关支持多端口并行你可以同时跑多个实例分别指向不同模型用端口区分。比如 18789 跑日常对话18790 跑代码生成互不影响。日志分开写排查也方便。最后提醒一点配置文件里的 Key 是明文别提交到 git 仓库。用.gitignore排除.openclaw/目录或者用环境变量方式注入。TaoToken 控制台可以随时吊销和重建 Key万一泄露第一时间去控制台处理。到这里Windows 下 OpenClaw 的完整安装链路就走完了环境三件套 → 国内源 → 全局安装 → 统一 Key 接入 → 逐项验证 → 排错。每一步都有可复制的命令和配置照着做基本不会卡住。真正跑起来之后你会发现最花时间的不是安装而是调模型和写 prompt那才是值得投入的地方。