☰
OpenClaw个人部署实操:Windows下nvm+Node.js+PowerShell环境搭建与TaoToken接入
2026/10/10 13:58:24 网站建设 项目流程

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 list

nvm list会列出已安装的版本,找到 22.x 的具体版本号(比如 22.20.0),然后切换:

nvm use 22.20.0 node -v

node -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 URLhttps://taotoken.net/api注意结尾不要多加/v1,OpenClaw 会自己拼
API Keysk-开头的一串在 TaoToken 控制台 API Keys 页面创建
Model IDclaude-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 restart

openclaw 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就能热加载模型配置。这个命令我试了好几次,比重启快得多。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询