1. 为什么 Windows 上跑 OpenClaw 总卡在环境这一步OpenClaw 是一个可以在本地跑起来的 AI 网关与对话工具它能让你用一套统一的接口去调用不同厂商的大模型适合想在 Windows 上做本地 AI 助手、自动化脚本或者 Agent 实验的开发者。很多人第一次装它卡住的地方往往不是 OpenClaw 本身而是 Node.js 版本不对、PowerShell 脚本权限没开、npm 全局路径没进 PATH 这几件事。我试过在一台全新的 Windows 11 机器上从零走一遍发现只要把顺序理顺其实十几分钟就能跑通。这篇教程聚焦 Windows 环境下的完整链路先核对 Node.js 与 npm 版本再用 PowerShell 执行安装命令最后把模型请求的 endpoint 与 Key 指向 TaoToken 统一通道。TaoToken 在这里扮演的角色是「统一 Key 入口」——你不需要为每个模型厂商单独申请和切换密钥只要把 Base URL 和 Key 配好OpenClaw 发出的请求就会走同一条通道。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 地址是 https://taotoken.net/api 后面配置里会反复用到。需要提前说明的是本文所有命令都在 Windows 10 1903 及以上或 Windows 11 的 64 位系统上验证过PowerShell 需要以管理员身份运行。如果你之前装过旧版 Node.js建议先确认版本避免 npm 全局安装时出现原生模块编译失败。下面从环境核对开始一步步来。2. 前置准备Node.js、npm 与 PowerShell 权限核对2.1 确认系统版本与权限先按WinX选择「终端(管理员)」或「Windows PowerShell(管理员)」。这一步很关键因为 OpenClaw 安装过程中要注册网关服务、写环境变量普通权限会直接报「拒绝访问」。打开后可以先看一眼系统信息[System.Environment]::OSVersion.Version输出里 Major 为 10、Build 大于等于 18362 就满足要求。Windows 11 的 Build 号会更高同样没问题。2.2 核对 Node.js 与 npm 版本OpenClaw 要求 Node.js 22.16 或 24.xnpm 需要 v10 以上。执行node -v npm -v如果node -v输出v22.16.0或v24.x.xnpm -v输出10.x或更高就可以直接跳到第 3 节。如果提示「无法将 node 识别为 cmdlet」说明 Node.js 没装或者没进 PATH。手动安装 Node.js 时去官网下载「Windows Installer (.msi)」一路默认记得勾选「Automatically install necessary tools」。装完后必须重开一个管理员 PowerShell否则 PATH 不会刷新。重开后再次执行node -v确认。2.3 解锁 PowerShell 脚本执行权限Windows 默认禁止运行远程脚本首次安装 OpenClaw 前要放开当前用户的执行策略Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force这条命令只影响当前用户不会降低系统整体安全性。执行后可以用Get-ExecutionPolicy -Scope CurrentUser确认返回RemoteSigned。2.4 关于网络与依赖下载安装脚本会从远端拉取依赖包。如果下载慢或卡住可以换用国内加速源具体命令在第 3 节给出。这里先不展开重点是先把 Node.js 和权限这两件事确认好后面才不会反复返工。3. 可复制配置PowerShell 安装 OpenClaw 并接入 TaoToken3.1 一键安装 OpenClaw官方源安装命令如下适合网络稳定的情况iwr -useb https://openclaw.ai/install.ps1 | iex如果下载依赖超时、卡顿换国内加速源iwr -useb https://clawd.org.cn/install.ps1 | iex脚本会自动检测 Node.js 环境缺失则安装然后下载依赖、全局安装 OpenClaw、启动新手引导。如果你只想先装二进制、暂不配置模型可以加-NoOnboard ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard3.2 手动安装已有 Node.js 环境如果你已经装好 Node.js 22.16也可以手动全局安装npm install -g openclawlatest若出现sharp构建失败用下面这条规避$env:SHARP_IGNORE_GLOBAL_LIBVIPS1; npm install -g openclawlatest安装完成后初始化网关服务openclaw onboard --install-daemon3.3 把模型请求指向 TaoToken 统一通道OpenClaw 的配置文件默认在C:\Users\你的用户名\.openclaw目录下。我们要做的是把模型提供商的 Base URL 指向 TaoToken 的 API 地址并填入统一 Key。下面是一份可复制的 JSON 配置片段路径与字段名按 OpenClaw 的实际结构来写{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken统一Key, models: { default: gpt-4o-mini, fallback: claude-3-5-sonnet } } }, gateway: { port: 3000, defaultProvider: taotoken } }把这段内容保存为C:\Users\你的用户名\.openclaw\config.json或者合并进已有配置。注意baseUrl后面不要多加/v1TaoToken 的 API 根地址就是https://taotoken.net/api具体路径由 OpenClaw 的适配层拼接。如果你更习惯用环境变量也可以在 PowerShell 里设置[Environment]::SetEnvironmentVariable(OPENCLAW_PROVIDER_BASE_URL, https://taotoken.net/api, User) [Environment]::SetEnvironmentVariable(OPENCLAW_PROVIDER_API_KEY, sk-你的TaoToken统一Key, User)设置完重开 PowerShell 生效。三件套要记全Base URL 是https://taotoken.net/apiKey 是你在 TaoToken 控制台生成的统一 KeyModel ID 填你实际要用的模型名比如gpt-4o-mini或claude-3-5-sonnet。缺任何一个请求都会失败。3.4 启动服务并打开面板openclaw start openclaw dashboarddashboard会自动打开浏览器地址是http://localhost:3000。如果改了配置执行openclaw gateway restart让网关重新加载。4. 验证请求一条最小对话确认鉴权生效4.1 检查安装与服务状态先确认程序和服务都在位openclaw --version openclaw status openclaw doctor--version显示版本号说明安装成功status显示running说明网关在跑doctor会自动诊断环境和依赖排查异常时很有用。4.2 发一条最小对话请求OpenClaw 装好后可以用命令行直接发一条测试消息。假设你已经按第 3 节配好了 TaoToken 通道执行openclaw chat --message 你好请用一句话介绍你自己如果配置正确你会看到模型返回的中文回复。这一步同时验证了两件事OpenClaw 的网关能正常转发请求TaoToken 的 Key 和 Base URL 鉴权通过。4.3 用 curl 直接验证 TaoToken 通道如果想单独确认 TaoToken 这一层是通的可以用 PowerShell 的Invoke-RestMethod发一条请求$headers { Authorization Bearer sk-你的TaoToken统一Key Content-Type application/json } $body { model gpt-4o-mini messages ({ role user; content ping }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri https://taotoken.net/api/chat/completions -Method Post -Headers $headers -Body $body返回里能看到choices字段和模型输出就说明统一 Key 已经生效。这一步和 OpenClaw 的验证是互补的前者确认通道本身可用后者确认 OpenClaw 的适配层没配错。4.4 在 Web 面板里再确认一次打开http://localhost:3000进入「模型设置」确认默认提供商是taotokenBase URL 显示为https://taotoken.net/api。在面板的对话窗口里发一条消息如果也能正常回复说明整条链路从 PowerShell 安装到模型调用全部打通。5. 本篇常见错排查401、local proxy failed 与 reading choices5.1 报错 401 Unauthorized这是最常见的鉴权失败。原因通常是 Key 填错、Key 前后有空格或者 Base URL 写成了https://taotoken.net/api/v1导致路径重复。排查步骤先确认config.json里apiKey字段是完整的sk-开头字符串再用第 4.3 节的Invoke-RestMethod单独测 TaoToken 通道。如果单独测能通、OpenClaw 里报 401说明是 OpenClaw 配置没加载执行openclaw gateway restart后重试。5.2 报错 local proxy failed这个报错一般出现在网关启动阶段说明本地代理端口没起来或者被占用。先执行openclaw status看网关是否running如果不是执行openclaw start。如果提示端口 3000 被占用用下面命令查占用进程Get-NetTCPConnection -LocalPort 3000 | Select-Object OwningProcess找到 PID 后可以在任务管理器里结束或者改config.json里的gateway.port换一个端口再openclaw gateway restart。5.3 报错 reading choices 或返回结构解析失败这类报错说明请求发出去了但返回的 JSON 结构不符合 OpenClaw 的预期。常见原因是 Model ID 填错比如填了一个 TaoToken 通道里不存在的模型名。解决办法是回到config.json把models.default改成你确认可用的模型 ID比如gpt-4o-mini。另外确认type字段是openai-compatible这样 OpenClaw 才会按标准choices结构解析。5.4 提示 command not found: openclawnpm 全局路径没进 PATH。先查路径npm prefix -g假设输出是C:\Users\你的用户名\AppData\Roaming\npm把它加进用户环境变量[Environment]::SetEnvironmentVariable(PATH, $env:PATH;C:\Users\你的用户名\AppData\Roaming\npm, User)重开 PowerShell 后再试openclaw --version。5.5 安装时 sharp 构建失败这是原生模块编译问题用第 3.2 节的环境变量规避命令重装即可。如果还失败确认 Node.js 是 64 位版本并且安装时勾选了必要工具。5.6 Web 面板打不开先openclaw status确认网关运行再检查http://localhost:3000是否被防火墙拦截。临时关闭 Windows Defender 防火墙测试如果能打开再把 3000 端口加进允许列表。6. 把统一 Key 用顺后续更新、卸载与接入文档装好只是第一步后面你可能会想更新版本或者彻底卸载重来。更新用npm update -g openclawlatest卸载分两步先卸程序再清配置npm uninstall -g openclaw Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw配置文件默认在C:\Users\你的用户名\.openclaw里面除了config.json还有日志和缓存手动改参数前建议先备份一份。如果你想把 TaoToken 的统一 Key 用在更多场景比如在编辑器里做代码补全、或者跑长期编码任务可以分别看两个入口需要生成和管理 Key 的去 API Keys 页面 https://taotoken.net/console/api-keys 想先对话验证模型的去模型对话 https://taotoken.net/chat 长期编码或 Agent 场景可以了解 Coding Plan https://taotoken.net/coding-plan 。接入细节和字段说明在文档里 https://taotoken.net/doc 遇到配置问题对照文档里的 Base URL 和 Model ID 列表核对一遍基本都能定位。最后留一个实用习惯每次改完config.json先跑openclaw doctor再openclaw gateway restart这样能提前发现字段拼写或路径问题比直接发请求报错再回头查要省时间。