1. 为什么要在 Node.js 环境里折腾 OpenClawOpenClaw 是一个用 Node.js 写的大模型 Agent 应用能跑本地网关、接聊天渠道、管理多 Agent 工作区适合想自己搭一套可控 Agent 运行环境的开发者。它的编译和运行链路比较长corepack 管包管理器、pnpm 装依赖、脚本编译 UI 和主程序、最后用 node 跑 dist 产物。中间任何一环出问题都会卡在“命令跑不动”的状态。我这次的目标很明确在本地把 OpenClaw 从源码编译到能跑起来同时把模型能力这条线用 TaoToken 统一 Key 接进去避免在多个 provider 之间来回换配置。整个过程分两大块一块是 Node.js 工具链的编译运行另一块是模型通道的接入。前者是后者的地基地基不稳后面接什么模型都白搭。这篇会按“先编译、再运行、再接模型”的顺序走给出可复制的 corepack/pnpm 配置、settings.json 骨架以及编译和运行两步验证动作。你跟着做能在本地复现一条完整链路。2. 前置准备Node.js、corepack 与 TaoToken 统一 Key2.1 Node.js 版本与 corepack 启用OpenClaw 对 Node.js 版本有要求建议 22.0 以上。低版本容易在编译阶段报各种语法或 API 不兼容的错。先确认版本node -v # 期望输出 v22.x.x 或更高如果版本不够去 Node.js 官网下 LTS 或 Current 都行装完再验一次。版本对了之后启用 corepack它是 Node.js 自带的包管理器代理OpenClaw 用它来锁定 pnpm 版本corepack enable corepack prepare pnpmlatest --activate pnpm -vcorepack enable会在 Node.js 安装目录下创建 pnpm、yarn 的 shim之后你敲pnpm实际走的就是 corepack 管理的版本。这一步在 Windows 上尤其重要因为后面那个路径空格的坑就和它有关。2.2 TaoToken 统一 Key 的定位TaoToken 在这里扮演的是“模型能力统一入口”的角色。OpenClaw 本身要调模型做推理、跑 Agent 回合如果每个 provider 都单独配 Key配置会散得到处都是。用 TaoToken 的 API 通道把 base URL 和 Key 统一成一份OpenClaw 的 provider 配置只认这一个入口换模型时改模型名就行不用动 Key。你需要先去控制台拿一个 API Key地址是 https://taotoken.net/api-keys 。拿到之后先放着第 4 节会写进 settings.json。想先看看模型列表和对话效果可以走模型对话页 https://taotoken.net/models 确认你要用的模型名再填配置省得填错返工。3. 可复制配置corepack、pnpm 与 settings.json 骨架3.1 拉代码与依赖安装先把仓库拉下来进目录git clone https://github.com/openclaw/openclaw.git cd openclaw依赖安装走 pnpm因为项目用 corepack 锁了包管理器直接pnpm install这一步会读 package.json 和 lock 文件把依赖装到 node_modules。如果卡在下载检查网络和 registry 配置如果报 engine 不匹配回头确认 Node.js 版本。3.2 Windows 下 pnpm ui:build 的路径空格坑装完依赖编译 UIpnpm ui:build在 Windows 上这条命令大概率会报错典型输出是C:\Program 不是内部或外部命令也不是可运行的程序 或批处理文件。 ELIFECYCLE Command failed with exit code 1.原因不复杂pnpm 通常装在C:\Program Files\nodejs下路径里有空格。脚本scripts/ui.js里的run和runSync函数在拼命令时把C:\Program Files\nodejs\pnpm直接当命令传控制台解析到C:\Program就断了后面的Files\nodejs\pnpm被当成参数自然找不到可执行文件。解决办法是把整个命令路径用双引号包起来。改scripts/ui.js里的两个函数核心逻辑是Windows 平台、shell 为 true、且 cmd 含空格时用字符串命令方式 spawn命令路径加引号。function run(cmd, args) { const options createSpawnOptions(cmd, args); let child; if (process.platform win32 options.shell true cmd.includes( )) { const quotedCmd ${cmd}; const fullCommand [quotedCmd, ...args].join( ); try { child spawn(fullCommand, [], { ...options, shell: true }); } catch (err) { console.error(Failed to launch ${cmd}:, err); process.exit(1); return; } } else { try { child spawn(cmd, args, options); } catch (err) { console.error(Failed to launch ${cmd}:, err); process.exit(1); return; } } child.on(error, (err) { console.error(Failed to launch ${cmd}:, err); process.exit(1); }); child.on(exit, (code) { if (code ! 0) { process.exit(code ?? 1); } }); }runSync同理把spawn换成spawnSync逻辑一致。改完再跑pnpm ui:build就能过。注意这个改动只针对 Windows 路径含空格的场景其他平台走原逻辑不影响。3.3 settings.json 骨架模型通道的配置放在 settings.json 里骨架如下。把apiKey换成你在 TaoToken 控制台拿到的 KeybaseUrl用 API 地址模型名按你实际要用的填{ provider: { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-20250514, timeout: 60000 }, gateway: { port: 18789, host: 127.0.0.1 }, agent: { workspace: ./workspace, maxTurns: 20 } }这份骨架只保留最小可用字段。provider 段是模型通道gateway 段是本地网关agent 段是 Agent 运行参数。实际项目里字段更多但先跑通这三段就够验证链路了。4. 编译与运行两步验证4.1 编译验证pnpm build 与 help 命令UI 编译过了之后编译主程序pnpm build跑完会在项目根目录生成dist文件夹里面是编译好的可执行产物。验证编译是否成功直接跑 helpnode dist/entry.js --help正常输出会打印 OpenClaw 的版本、用法和命令列表类似OpenClaw 2026.4.6 (3b865d8) Usage: openclaw [options] [command] Options: --container name Run the CLI inside a running container --dev Dev profile -h, --help Display help for command -V, --version output the version number Commands: acp * Agent Control Protocol tools agent Run one agent turn via the Gateway gateway * Run, inspect, and query the WebSocket Gateway models * Discover, scan, and configure models ...看到命令列表说明编译产物可用第一步验证通过。4.2 运行验证启动网关并确认模型通道启动本地网关pnpm openclaw gateway --port 18789这条命令会拉起 WebSocket Gateway首次启动可能要几分钟初始化。起来之后浏览器访问http://127.0.0.1:18789能看到网关配置页面。接着验证模型通道是否通。用 OpenClaw 的 infer 命令跑一次推理node dist/entry.js infer --prompt 用一句话说明什么是 Agent --json如果 settings.json 里的 TaoToken 配置正确会返回模型输出。返回正常说明从编译到运行再到模型调用的整条链路都通了。想更直观地对比模型输出也可以直接在模型对话页 https://taotoken.net/models 里试同一个 prompt两边结果对得上就说明通道没问题。5. 本篇常见错排查5.1 pnpm ui:build 报 C:\Program 不是内部或外部命令这是 Windows 路径空格的经典问题根因在scripts/ui.js的 spawn 调用没给命令路径加引号。按 3.2 的改法处理run和runSync两个函数即可。改完记得保存再跑一次pnpm ui:build。5.2 corepack enable 后 pnpm 仍不可用先确认corepack -v有输出。如果 corepack 本身没装说明 Node.js 版本太低或安装不完整升级到 22.0 以上。如果 corepack 有输出但 pnpm 没有跑corepack prepare pnpmlatest --activate手动激活一次再pnpm -v验证。5.3 pnpm install 卡住或报 engine 不匹配卡住多半是 registry 访问问题检查网络和 npm registry 配置。报 engine 不匹配是 Node.js 版本低于项目要求回到 2.1 确认版本。还有一种情况是 lock 文件和 package.json 不一致删掉 node_modules 和 lock 重装。5.4 网关启动后模型调用报 401 或超时401 一般是 Key 不对或没生效检查 settings.json 里apiKey是否填了完整 KeybaseUrl是否是https://taotoken.net/api。超时先看timeout字段默认 60000 毫秒网络慢可以调大。如果 Key 确认没问题还是报错去控制台重新生成一个 Key 试试排除 Key 本身失效。5.5 node dist/entry.js --help 报模块找不到说明pnpm build没跑完或产物不完整。重新跑pnpm build确认dist目录下有 entry.js。如果 build 阶段就报错往上翻日志找第一个 error通常是某个依赖没装好或 Node.js 版本问题。6. 把模型通道固定下来后续少折腾编译和运行链路跑通之后真正省事的地方在于模型通道只维护一份配置。OpenClaw 的 provider 段指向 TaoToken 的 API 入口换模型只改model字段Key 和 baseUrl 不动。这样你在本地反复编译、重启网关、跑 Agent 回合时不会因为 provider 配置散落而反复排查。如果你后面要长期跑编码类 Agent 或做多轮任务可以看下 Coding Plan https://taotoken.net/coding-plan 它更适合持续性的编码场景。接入细节和字段说明在接入文档 https://taotoken.net/doc 里有遇到配置对不上的时候翻一下比猜快。整条链路的核心就一句话Node.js 工具链负责把 OpenClaw 编译出来TaoToken 负责把模型能力稳定接进去两边各管一段中间用 settings.json 对齐。