1. Windows 上从零跑通 OpenClawnvm 管 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 而不是直接装 NodeOpenClaw 要求 Node.js ≥ 22但很多 Windows 机器上早就装了 Node 18 或 20比如你之前跑别的项目留下的。如果你直接覆盖安装旧项目可能跑不起来如果你不升级OpenClaw 又装不上。nvm-windows 就是解决这个矛盾的它让你在同一台机器上装多个 Node 版本用nvm use随时切换。去 nvm-windows 的 release 页面下载nvm-setup.exe双击安装。安装路径建议不要带空格和中文比如C:\nvm和C:\nodejs。装完后 WinR 输入 cmd敲nvm version正常会输出类似1.2.2的版本号。如果提示「不是内部或外部命令」说明环境变量没生效关掉 cmd 重开一次或者检查安装时是否勾选了「添加到 PATH」。2.2 用 nvm 安装并切换到 Node 22以管理员身份打开 PowerShellWinX 选「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 并接入 TaoToken3.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 把模型通道指向 TaoTokenOpenClaw 的模型配置支持 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注意结尾不要多加/v1OpenClaw 会自己拼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 restartopenclaw gateway install会把 gateway 注册成 Windows 任务计划实现开机自启。这一步必须在管理员权限下执行否则会失败。4. 验证请求确认 OpenClaw 真的连上了 TaoToken4.1 启动并打开控制台gateway 起来后另开一个普通 PowerShell 窗口执行openclaw dashboard浏览器会自动打开 OpenClaw 的对话页面。如果你直接访问页面看到Unauthorized说明你只启动了 gateway 但没走 dashboard 的鉴权流程。解决办法就是上面这条命令它会带上正确的 token 打开页面。4.2 发一条测试消息在对话页面输入「你好请用一句话介绍你自己」回车。如果模型正常返回说明 TaoToken 通道打通了。如果返回报错看下一节的排查表。4.3 用命令行直接验证 API 通道想绕过 OpenClaw 单独确认 TaoToken 的 Key 有没有问题可以用 curlcurl 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、OAuth5.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_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan 详情https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台 API Keyshttps://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 的配置文件改完后不用重启整个 gateway在对话页面发/reload就能热加载模型配置。这个命令我试了好几次比重启快得多。