1. Windows 下 OpenClaw 安装踩坑Node.js 版本冲突与 PowerShell 执行策略怎么破OpenClaw 是最近在技术圈里被叫做“养龙虾”的 AI 智能体它和普通聊天机器人最大的区别在于能真正动手干活——清理收件箱、发邮件、管日历、办理值机还能通过飞书、企业微信、钉钉、QQ 这些常用聊天应用来接收指令。适合谁用如果你平时有一堆重复性的桌面操作和消息处理任务又不想每次都手动点来点去那它值得折腾一下。但 Windows 下的安装链路比 Mac/Linux 要绕尤其是 Node.js 版本、nvm 切换、npm 全局权限、PowerShell 执行策略这几个环节几乎每个新手都会卡一次。我把自己从零装到能跑通请求的完整过程拆开写命令都可以直接复制。先说清楚 OpenClaw 对环境的硬要求Node.js 22 及以上版本内存最低 2G、推荐 4G磁盘预留 500MB 左右。低于 22 的 Node 会在安装阶段直接报错退出所以第一步不是急着敲安装命令而是先把 Node 版本管好。Windows 上管理 Node 版本最稳的方式是 nvm-windows它和 Mac/Linux 的 nvm 命令基本一致但安装包和权限模型不同下面会一步步来。整个流程分六段先讲清楚问题场景和报错长什么样再把 TaoToken 的前置准备做好然后给出可复制的 nvm/npm/PowerShell 配置接着用一条 curl 验证通道再对照真实报错排查最后把 CTA 分流写清楚。你按顺序走基本不会漏。2. TaoToken 前置准备API Key 与 endpoint 怎么拿在装 OpenClaw 之前建议先把模型通道准备好否则安装向导走到“选择模型、填 API Key”那一步会卡住。TaoToken 提供的是兼容 OpenAI 风格的接口OpenClaw 里配置 endpoint 和 Key 就能接上。你需要准备两样东西一个 API Key一个 Base URL。API Key 的获取入口在控制台的 API Keys 页面路径是https://taotoken.net/api-keys登录后新建一个 Key复制出来先存到记事本里后面配置要用。注意 Key 只显示一次关掉页面就看不到了所以复制完先粘贴到安全的地方。Base URL 用https://taotoken.net/api这个地址在 OpenClaw 的模型配置里填到 endpoint 字段。如果你后面要跑长期编码或者 Agent 类的任务可以了解下 Coding Plan入口在https://taotoken.net/coding-plan适合需要持续调用、不想每次手动换 Key 的场景。模型对话的调试入口在https://taotoken.net/models接入文档在https://taotoken.net/doc这两个后面排查请求问题时会用上。这里要提醒一句OpenClaw 的安装向导里会让你选模型比如 DeepSeek、本地模型等。如果你选的是走 TaoToken 通道的模型那 API Key 就填刚才复制的那个endpoint 填https://taotoken.net/api。不要填成官网首页地址否则请求会 404。前置准备做完再进安装环节。3. 可复制配置nvm 装 Node 22、npm 全局安装 OpenClaw、PowerShell 设置这一节是全文操作最密集的部分命令都可以直接复制。先处理 PowerShell 执行策略再装 nvm再用 nvm 装 Node 22最后 npm 全局装 OpenClaw。第一步以管理员身份打开 PowerShell。按 WinX选择“Windows PowerShell (管理员)”或者“终端(管理员)”。先看一下当前执行策略Get-ExecutionPolicy如果返回Restricted安装脚本会被拦。改成RemoteSignedSet-ExecutionPolicy RemoteSigned -Scope CurrentUser执行后会问你是否确认输入 Y 回车。这一步只影响当前用户不会动系统全局策略相对安全。第二步安装 nvm-windows。去 nvm-windows 的 release 页面下载nvm-setup.exe一路下一步即可。装完后关掉当前 PowerShell重新以管理员身份打开否则 nvm 命令不在 PATH 里。验证nvm version能输出版本号就说明装好了。接着装 Node 22nvm install 22 nvm use 22 node -vnode -v应该输出v22.x.x。如果输出的是旧版本说明系统里还有独立安装的 Node 抢了 PATH需要去“添加或删除程序”里把旧的 Node.js 卸载掉再重新nvm use 22。第三步npm 全局安装 OpenClaw。国内网络建议先换 npm 源npm config set registry https://registry.npmmirror.com然后全局安装npm install -g openclaw-cn装完后验证openclaw-cn --version如果提示openclaw-cn 不是内部或外部命令说明 npm 全局 bin 目录不在 PATH。用下面命令查全局目录npm config get prefix把输出的路径加上\拼到 PATH 里或者直接重新开一个 PowerShell 窗口再试。第四步配置 OpenClaw 的模型通道。OpenClaw 的配置文件通常在用户目录下的.openclaw文件夹里Windows 路径是C:\Users\你的用户名\.openclaw\config.json。如果没有这个文件先跑一次openclaw-cn init生成。然后编辑成下面这样{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_API_Key, modelId: deepseek-chat }, gateway: { port: 18789 } }三个关键字段对齐Base URL 填https://taotoken.net/apiAPI Key 填你在控制台复制的那个Model ID 填你要用的模型标识。如果你用的是 Claude Code 类的接入方式配置项名称可能不同但 Base URL、Key、Model ID 这三件套的逻辑是一样的缺一不可。第五步安装并启动 Gateway 服务。Gateway 负责后台服务的启停管理openclaw-cn gateway install openclaw-cn gateway start openclaw-cn gateway statusstatus显示 running 就说明服务起来了。常用命令还有stop、restart、uninstall按需使用。4. 验证请求一条 curl 确认通道可用配置写完不能只看界面要用一条请求确认通道真的通。OpenClaw 本身有网页控制界面http://127.0.0.1:18789/但那是本地服务不代表模型通道没问题。直接对 TaoToken 的接口发一条 curl 最直接。在 PowerShell 里执行注意 PowerShell 的 curl 是Invoke-WebRequest的别名建议用curl.exe明确调用curl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Content-Type: application/json -H Authorization: Bearer 你的_TaoToken_API_Key -d {\model\:\deepseek-chat\,\messages\:[{\role\:\user\,\content\:\你好\}]}如果返回 JSON 里带choices字段和一段回复内容说明 Key、endpoint、模型 ID 三者都对上了。如果返回 401说明 Key 错了或者没带Bearer前缀如果返回 404多半是 Base URL 写成了首页而不是/api如果返回reading choices之类的解析错误说明返回体不是预期的 JSON 结构检查一下 endpoint 路径是不是多了或少了/v1。通道验证通过后回到 OpenClaw 的网页界面发一条测试指令比如让它“在桌面创建一个文件夹然后新建一个 txt 文件把 OpenClaw 的自我介绍写进去”。如果它能执行并返回结果说明整条链路从 PowerShell 到 nvm 到 npm 到 OpenClaw 到 TaoToken 全部打通。这一步的 curl 请求建议保留在记事本里后面换 Key 或者换模型时改一下参数就能复用比每次重新翻文档快。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth装 OpenClaw 的过程中报错基本集中在下面几类我按真实遇到的顺序列出来对照着查。401 Unauthorized。这个最直接Key 不对或者没带上。检查三处config.json 里的apiKey是不是复制完整、有没有多余空格curl 里的Authorization头是不是Bearer加 Key注意 Bearer 后面有一个空格Key 是不是在控制台被删过或者过期了。如果用的是 Claude Code 类的接入OAuth 流程走完后 token 可能没写进配置文件需要手动确认auth.json或对应配置里的 token 字段。local proxy failed。这个报错通常出现在 OpenClaw 启动 Gateway 的时候意思是本地代理端口起不来。原因一般是 18789 端口被占用或者 Gateway 服务没装好。先查端口netstat -ano | findstr 18789如果有进程占用要么杀掉那个进程要么改 config.json 里的gateway.port换一个端口。然后重新openclaw-cn gateway restart。如果还是失败openclaw-cn gateway uninstall再install一次。reading choices 报错。这个说明请求发出去了但返回体里没有choices字段解析失败。常见原因是 endpoint 路径不对。TaoToken 的接口是https://taotoken.net/api/v1/chat/completions如果你在 config.json 里 Base URL 填了https://taotoken.net/api那 OpenClaw 拼接时应该自动补/v1/chat/completions如果它没补你就得在 Base URL 里写全。用 curl 单独测一下完整路径确认返回的是标准 OpenAI 格式。OAuth 相关报错。如果你在配置里选了需要 OAuth 的 provider但没走完授权流程会报 token 缺失。这种情况要么走完 OAuth 拿到 token 写进配置要么直接换成 API Key 方式用 TaoToken 的 Key 更简单不需要额外授权步骤。Node 版本冲突。前面提过node -v不是 22 就会在安装阶段失败。用nvm list看已装版本nvm use 22切换。如果切换后node -v还是旧版本去系统环境变量里把旧 Node 的路径删掉或者直接卸载旧 Node。npm 权限报错。Windows 下如果之前用管理员装过全局包普通用户再装会报 EPERM。解决办法是用管理员 PowerShell 装或者改 npm 全局目录到用户目录npm config set prefix C:\Users\你的用户名\npm-global然后把C:\Users\你的用户名\npm-global加到 PATH 里。6. 后续怎么用从验证到日常任务的 CTA 分流通道验证通过、Gateway 跑起来之后OpenClaw 的网页界面http://127.0.0.1:18789/就是你的控制台。你可以在这里发指令也可以接飞书、企业微信、钉钉、QQ 这些通道让它从聊天应用里接收任务。第一次用建议先跑几个简单任务比如创建文件、整理桌面、发一封测试邮件确认执行链路没问题再上复杂任务。如果你在排障或者接入阶段卡住了优先看 API Keys 和接入文档Key 管理在https://taotoken.net/api-keys接入说明在https://taotoken.net/doc这两个页面能解决大部分配置问题。如果你只是想先验证模型能不能正常对话用模型对话入口https://taotoken.net/models发一条消息最快。如果你打算长期跑编码或者 Agent 类任务Coding Plan 的入口在https://taotoken.net/coding-plan适合需要持续调用、不想频繁换 Key 的场景。最后说一个实用技巧把 config.json 和那条 curl 验证命令一起备份到云笔记里。下次换机器或者重装系统直接复制粘贴就能恢复不用重新翻文档。OpenClaw 的 Gateway 服务记得设成开机自启否则每次重启都要手动gateway start。Windows 下可以用任务计划程序把openclaw-cn gateway start加进去触发条件选“登录时”这样开机就能直接用。