1. Windows 上从零跑通 OpenClaw:nvm 管 Node.js、PowerShell 装依赖、TaoToken 接模型
OpenClaw 是一个基于 Node.js 的本地 Agent 运行框架,你可以把它理解成一个「空壳主机」——它本身不带大模型能力,需要你给它接上模型 API 才能真正干活。适合谁?适合想在 Windows 上本地跑 Agent、又不想折腾 Linux 双系统的个人开发者。它要求 Node.js 版本不低于 22,而且对版本比较敏感,所以这篇教程用 nvm-windows 来管理 Node 版本,避免和你机器上已有的 Node 打架。
整个流程分四步:装 nvm → 用 nvm 装 Node 22 → PowerShell 一键安装 OpenClaw → 把模型通道指向 TaoToken。我实测下来,最容易翻车的不是安装本身,而是权限和 Node 版本没切对。下面每一步都给可复制的命令和检查动作,你照着敲就行。
先明确一个概念:OpenClaw 的「模型提供商」配置里,有一类是 OpenAI-compatible 接口。TaoToken 提供的正是这种兼容接口,所以你在 OpenClaw 里选 OpenAI-compatible,把 Base URL 和 Key 填进去就能用。这也是为什么后面配置片段里你会看到baseUrl和apiKey两个字段。
2. 前置环境:nvm-windows 安装与 Node.js 22 版本切换
2.1 为什么必须用 nvm 而不是直接装 Node
OpenClaw 要求 Node.js ≥ 22,但很多 Windows 机器上早就装了 Node 18 或 20(比如你之前跑别的项目留下的)。如果你直接覆盖安装,旧项目可能跑不起来;如果你不升级,OpenClaw 又装不上。nvm-windows 就是解决这个矛盾的:它让你在同一台机器上装多个 Node 版本,用nvm use随时切换。
去 nvm-windows 的 release 页面下载nvm-setup.exe,双击安装。安装路径建议不要带空格和中文,比如C:\nvm和C:\nodejs。装完后 Win+R 输入 cmd,敲:
nvm version正常会输出类似1.2.2的版本号。如果提示「不是内部或外部命令」,说明环境变量没生效,关掉 cmd 重开一次,或者检查安装时是否勾选了「添加到 PATH」。
2.2 用 nvm 安装并切换到 Node 22
以管理员身份打开 PowerShell(Win+X 选「Windows PowerShell (管理员)」),执行:
nvm install 22 nvm listnvm list会列出已安装的版本,找到 22.x 的具体版本号(比如 22.20.0),然后切换:
nvm use 22.20.0 node -vnode -v输出v22.20.0就说明切换成功了。这里有个坑:nvm use在非管理员权限下有时会报「exit status 1」,原因是它要改符号链接,权限不够。所以务必用管理员 PowerShell。
注意:每次新开终端,nvm 的当前版本可能会重置。如果你发现
node -v又变回旧版本,重新执行一次nvm use 22.20.0即可。想省事可以设默认版本:nvm alias default 22.20.0。
2.3 解锁 PowerShell 执行策略
Windows 默认禁止运行未签名的脚本,OpenClaw 的安装脚本会被拦。先解锁:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认。这一步只影响当前用户,不会动系统全局策略,相对安全。
3. 可复制配置:PowerShell 安装 OpenClaw 并接入 TaoToken
3.1 一键安装 OpenClaw
保持管理员 PowerShell,执行官方安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex如果下载超时,换国内镜像脚本:
iwr -useb https://clawd.org.cn/install.ps1 | iex安装过程中会进入交互式配置向导,依次问你:网络模式、模型提供商、默认模型、聊天通道、搜索、技能、Hooks。第一次装建议全部选「Skip for now」,先把框架跑起来,模型和通道后面用配置文件补。向导里如果提示「gateway 创建 Windows 任务计划失败」,多半是因为你没用管理员权限,记下来,后面用openclaw gateway install修复。
3.2 把模型通道指向 TaoToken
OpenClaw 的模型配置支持 OpenAI-compatible 提供商。TaoToken 的 API 地址是https://taotoken.net/api,你需要在 TaoToken 控制台创建一个 API Key。然后编辑 OpenClaw 的配置文件。配置文件通常位于用户目录下的.openclaw文件夹,具体路径可以在安装完成后用openclaw configure打开向导查看。
下面是一段可复制的 JSON 配置片段,放在providers数组里:
{ "providers": [ { "id": "taotoken", "type": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "models": [ { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5" }, { "id": "gpt-4o", "name": "GPT-4o" } ] } ], "defaultModel": "taotoken/claude-sonnet-4-5" }三件套对照表,别填错:
| 字段 | 填什么 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 注意结尾不要多加/v1,OpenClaw 会自己拼 |
| API Key | sk-开头的一串 | 在 TaoToken 控制台 API Keys 页面创建 |
| Model ID | claude-sonnet-4-5等 | 必须是 TaoToken 支持的模型标识 |
如果你更习惯用 TOML 格式(部分版本支持),等价写法:
[[providers]] id = "taotoken" type = "openai-compatible" baseUrl = "https://taotoken.net/api" apiKey = "sk-你的TaoToken密钥" [[providers.models]] id = "claude-sonnet-4-5" name = "Claude Sonnet 4.5" [defaultModel] provider = "taotoken" model = "claude-sonnet-4-5"改完配置后,重启 gateway 让配置生效:
openclaw gateway install openclaw gateway restartopenclaw gateway install会把 gateway 注册成 Windows 任务计划,实现开机自启。这一步必须在管理员权限下执行,否则会失败。
4. 验证请求:确认 OpenClaw 真的连上了 TaoToken
4.1 启动并打开控制台
gateway 起来后,另开一个普通 PowerShell 窗口,执行:
openclaw dashboard浏览器会自动打开 OpenClaw 的对话页面。如果你直接访问页面看到Unauthorized,说明你只启动了 gateway 但没走 dashboard 的鉴权流程。解决办法就是上面这条命令,它会带上正确的 token 打开页面。
4.2 发一条测试消息
在对话页面输入「你好,请用一句话介绍你自己」,回车。如果模型正常返回,说明 TaoToken 通道打通了。如果返回报错,看下一节的排查表。
4.3 用命令行直接验证 API 通道
想绕过 OpenClaw 单独确认 TaoToken 的 Key 有没有问题,可以用 curl:
curl https://taotoken.net/api/v1/chat/completions ^ -H "Content-Type: application/json" ^ -H "Authorization: Bearer sk-你的TaoToken密钥" ^ -d "{\"model\":\"claude-sonnet-4-5\",\"messages\":[{\"role\":\"user\",\"content\":\"hi\"}]}"注意 Windows 的 cmd 里换行符是^,PowerShell 里是反引号。如果返回一段 JSON 且choices数组里有内容,说明 Key 和网络都没问题,问题就出在 OpenClaw 的配置上。
5. 本篇常见报错排查:401、local proxy failed、reading choices、OAuth
5.1 401 Unauthorized
最常见。两种可能:一是 API Key 填错或过期,去 TaoToken 控制台重新生成一个;二是 Base URL 写成了https://taotoken.net/api/v1,多了一层/v1,导致 OpenClaw 拼出来的路径变成/api/v1/v1/chat/completions。把 Base URL 改回https://taotoken.net/api即可。
5.2 local proxy failed
这个报错通常出现在 gateway 启动阶段,意思是本地代理端口被占用或没权限绑定。OpenClaw 默认用 18789 端口。检查端口占用:
netstat -ano | findstr 18789如果有进程占用,要么杀掉它,要么在配置里改端口。另外确认你是用管理员权限启动的 gateway。
5.3 reading choices 报错
完整报错类似Cannot read properties of undefined (reading 'choices')。这说明 OpenClaw 收到了响应,但响应结构里没有choices字段。原因通常是模型 ID 填错了——TaoToken 返回了一个错误对象而不是正常的 chat completion。去 TaoToken 文档确认你填的模型 ID 是否在支持列表里。
5.4 OAuth 相关报错
如果你在配置向导里选了 Anthropic 的 OAuth 登录方式,但网络环境不通,会卡在 OAuth 回调。解决办法是改用 API Key 方式,也就是本篇的 TaoToken 方案。在配置文件里把 provider 的type从anthropic-oauth改成openai-compatible,填 Base URL 和 Key。
5.5 gateway 任务计划创建失败
安装时如果没加管理员权限,会看到这条。修复命令:
openclaw gateway install执行完 gateway 会自动启动,并注册开机自启。
6. 后续怎么用:把 TaoToken 作为统一模型入口
OpenClaw 跑起来之后,你可能会想换模型、加技能、接聊天通道。这时候不用重装,直接改配置文件或者跑openclaw configure向导就行。TaoToken 的好处是它把多个模型统一到一个 Base URL 和一把 Key 下面,你换模型只需要改defaultModel字段,不用重新申请各家平台的密钥。
如果你打算长期跑 Agent 任务,比如让它定时执行脚本、读写文件,建议去 TaoToken 控制台看一下 Coding Plan 的额度方案,比按次调用更划算。需要新建 Key 或者查用量,直接进控制台:
- 模型对话体验:https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite
- Coding Plan 详情:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite
- 控制台 API Keys:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
- 接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite
最后留一个实用技巧:OpenClaw 的配置文件改完后,不用重启整个 gateway,在对话页面发/reload就能热加载模型配置。这个命令我试了好几次,比重启快得多。