1. Windows 部署 OpenClaw 前，先把 Node 环境这关过了
OpenClaw 是一个可以在本地跑起来的 AI Agent 网关，能对接多种模型提供方，再通过浏览器面板直接对话。它适合想在 Windows 上快速体验 Agent 能力、又不想折腾复杂容器环境的开发者。整条链路的核心依赖只有两个：Node.js 运行时和 npm 包管理器。Node 版本必须大于 22，这是硬性门槛，低于这个版本openclaw的依赖树会直接报错退出。
我试过在一台没装过 Node 的 Windows 11 机器上从零走一遍，最容易卡住的地方不是 OpenClaw 本身，而是 PowerShell 的执行策略和 npm 源。前者会让npm命令直接拒绝运行，后者会让安装过程慢到怀疑人生。所以这一章先把环境铺好，后面接入 TaoToken 统一 Key 的时候才不会连环报错。
先确认你的系统架构。右键「此电脑」→「属性」，看系统类型是 64 位还是 ARM。绝大多数 Windows 笔记本和台式机都是 x64，直接去 Node 官网下载 LTS 版本的.msi安装包即可。安装时勾选「Add to PATH」，这一步很关键，否则后面 PowerShell 里敲node -v会提示找不到命令。
安装完成后按Win + R，输入powershell，回车。在终端里执行：
node -v npm -v正常应该输出类似v22.14.0和10.9.2的版本号。如果node -v报「不是内部或外部命令」，说明 PATH 没生效，重启一次终端或者重新跑一遍安装程序选 Repair。
接下来处理 PowerShell 执行策略。Windows 默认禁止运行脚本，npm 的.ps1包装脚本会被拦下来，报错长这样：
npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本。解决办法是以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser提示确认时输入Y回车。这条命令只影响当前用户，不会动系统级策略，相对安全。执行完再敲npm -v，应该就能正常输出版本号了。
环境这一步做完，相当于泳池已经建好，接下来才是把 OpenClaw 这只「龙虾」放进水里。Node 版本、PATH、执行策略这三样任何一项没到位，后面的安装都会以各种奇怪的错误码收场，所以别跳过验证。
2. TaoToken 统一 Key 接入前的准备工作
OpenClaw 初始化时会让你选模型提供者。默认走的是 Anthropic 的 Claude 系列，但如果你没有对应的 API 凭证，初始化到选择模型那一步就会卡住。这时候用 TaoToken 的统一 Key 通道会省事很多——一个 Key 就能覆盖多种模型，Base URL 和 Model ID 在面板里直接配，不用为每个提供方单独申请。
TaoToken 的定位是统一模型接入网关，把不同厂商的 API 格式收敛成一套兼容接口。对 OpenClaw 来说，你只需要在配置里填三个东西：Base URL、API Key、Model ID。这三件套填对，网关就能把请求转发出去。
先拿到 Key。打开https://taotoken.net/api-keys，登录后创建一个新的 API Key，复制保存。这个 Key 只在创建时完整显示一次，丢了就得重建。
Base URL 用https://taotoken.net/api，注意这里不带任何查询参数，直接填这个地址即可。Model ID 根据你要用的模型来定，比如claude-opus-4-6或者claude-sonnet-4-5，具体可用的模型列表在https://taotoken.net/doc里有说明。
如果你打算长期跑编码类任务或者 Agent 工作流，可以看一下 Coding Plan，https://taotoken.net/coding-plan，它针对高频调用场景做了额度优化。只是临时验证连通性的话，用按量计费的 Key 就够了。
这里要提醒一点：OpenClaw 的配置文件里，模型提供者的字段名和 TaoToken 的接口路径要对齐。OpenClaw 默认走 Anthropic 的/v1/messages格式，TaoToken 的 API 网关兼容这个格式，所以 Base URL 填https://taotoken.net/api之后，OpenClaw 会自动拼接出正确的请求路径。不需要你手动改 endpoint。
准备工作就这三样：Key、Base URL、Model ID。拿到之后先放着，等 OpenClaw 初始化到模型配置那一步再填进去。如果你在初始化时选了 Skip for now，也没关系，后面可以在面板里补配。
3. 可复制的 OpenClaw 安装与配置片段
这一章给的是可以直接复制粘贴的命令和配置片段。安装 OpenClaw 用管理员权限的 PowerShell，执行：
npm install -g openclaw@latest如果下载速度慢或者卡住，先Ctrl + C中断，切换 npm 源到国内镜像：
npm config set registry https://registry.npmmirror.com然后再跑一次安装命令。成功的话会看到类似added 653 packages in 30s的输出。如果报4058错误，通常是缺少 git，去 git 官网装一个再重试。报code 128一般是缓存问题，执行npm cache clean --force后重装。报4048则重启电脑、清缓存、再装。
安装完成后初始化：
openclaw onboard --install-daemon进入交互界面后，安全声明选Yes继续。配置模式选QuickStart，它会自动分配网关端口。模型提供者这一步，如果你已经有 TaoToken 的 Key，先选Skip for now，等初始化走完再手动配，这样不容易在交互流程里填错。
初始化完成后，找到 OpenClaw 的配置文件。Windows 下通常在%USERPROFILE%\.openclaw\config.json。用记事本或者 VS Code 打开，填入 TaoToken 的三件套：
{ "gateway": { "port": 18789, "host": "127.0.0.1" }, "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken密钥", "model": "claude-opus-4-6", "type": "anthropic" } }, "defaultProvider": "taotoken" }注意type字段填anthropic，因为 OpenClaw 内部按 Anthropic 的消息格式组装请求，TaoToken 的网关兼容这个格式。apiKey换成你在https://taotoken.net/api-keys创建的那串。model字段填你要用的模型 ID，不确定的话先用claude-opus-4-6验证连通性。
如果你用的是 Cline 或者 Claude Code 这类工具，配置逻辑是一样的：Base URL 填https://taotoken.net/api，Key 填 TaoToken 的 Key，Model ID 填对应模型。三件套对齐，请求就能通。
保存配置文件后，重启网关让配置生效：
openclaw gateway --port 18789这个命令会占用当前终端，所以最好开两个 PowerShell 窗口，一个跑网关，一个做其他操作。
4. 验证请求与确认 API 连通
网关跑起来之后，打开浏览器访问http://127.0.0.1:18789/overview。这是 OpenClaw 的 dashboard 面板。首次进入会要求填网关令牌，这个令牌在初始化时自动生成，可以在%USERPROFILE%\.openclaw\config.json里找到gateway.token字段，复制粘贴进去，点连接。状态从「离线」变成「已连接」就说明面板和网关通上了。
接下来验证模型通道。在面板左侧找到 Chat 或者对话入口，发一条测试消息，比如「你好，请回复你的模型名称」。如果配置正确，你会看到模型返回的内容。这一步能通，说明 TaoToken 的 Key、Base URL、Model ID 三件套都生效了。
如果面板里没有立即返回，先看跑网关的那个 PowerShell 窗口有没有报错。常见的错误有几种：
401 Unauthorized表示 Key 不对或者没填。检查config.json里的apiKey字段，确认没有多余空格，确认 Key 没有过期。
local proxy failed或者连接超时，通常是 Base URL 写错了。确认填的是https://taotoken.net/api，不要多加/v1或者/messages后缀，OpenClaw 会自己拼。
reading choices这类报错一般出现在用 OpenAI 格式的提供者时，说明返回结构不符合预期。如果你用的是 Anthropic 类型，不应该出现这个错。检查type字段是不是写成了openai。
OAuth相关报错说明你选了需要浏览器登录的提供者，比如 Qwen 的免费通道。如果你走 TaoToken 的 Key 通道，不需要 OAuth，把提供者类型改成anthropic即可。
验证通过后，你可以在面板里切换语言、调整对话参数。OpenClaw 的 dashboard 支持多会话管理，每个会话独立上下文。实测下来，从安装到第一条消息返回，顺利的话 15 分钟内能搞定。卡住的地方基本都在环境准备和配置字段对齐这两步。
5. 本篇常见错误排查
这一章把安装和接入过程中最容易撞上的报错集中列一下，方便你对号入座。
npm install -g openclaw@latest报4058：这是 npm 找不到 git 的典型错误。OpenClaw 的某些依赖需要从 git 仓库拉取。去 git 官网下载 Windows 版安装，装完后重启 PowerShell，再执行安装命令。
报code 128：git 命令执行失败，通常是网络问题或者缓存损坏。先npm cache clean --force，再确认 git 能正常访问，然后重装。
报4048：权限或者文件占用问题。重启电脑，用管理员身份打开 PowerShell，清缓存后重装。
npm : 无法加载文件 npm.ps1：执行策略拦截。管理员 PowerShell 里跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，选Y。
初始化时选模型提供者卡住：如果你没有 Anthropic 的 Key，选Skip for now，等初始化走完手动改config.json。不要在这一步硬填，交互界面里填错了不好回退。
面板连不上网关：检查网关进程是否还在跑。openclaw gateway --port 18789这个命令会占用终端，如果你在同一个窗口里敲了别的命令，网关就断了。开两个窗口，一个专门跑网关。
面板提示令牌错误：令牌在config.json的gateway.token字段，复制时注意不要带引号。如果找不到，重新跑一次openclaw onboard会重新生成。
聊天无响应但网关没报错：检查defaultProvider字段是否指向了taotoken，检查providers.taotoken.model填的模型 ID 是否在 TaoToken 的支持列表里。模型 ID 写错的话，网关会静默失败。
401错误：Key 无效。去https://taotoken.net/api-keys确认 Key 状态，必要时重建一个。
local proxy failed：Base URL 格式不对。确认是https://taotoken.net/api，结尾没有斜杠，没有多余路径。
这些错误里，环境类的问题占了一大半。Node 版本、执行策略、npm 源这三样提前处理好，后面的流程会顺很多。配置类的问题则集中在三件套的字段对齐上，Base URL、Key、Model ID 任何一个写错都会导致请求失败。
6. 跑通之后：把 OpenClaw 用起来的几个方向
OpenClaw 跑通之后，最直接的用法是在 dashboard 里对话。但它的价值不止于此——它是一个本地网关，可以接各种前端工具。比如你可以把 Cline 或者 Claude Code 的 Base URL 指向http://127.0.0.1:18789，让这些编码工具走 OpenClaw 的通道，再通过 TaoToken 的统一 Key 出去。这样一套 Key 就能覆盖多个工具，不用每个工具单独配。
如果你主要做编码类任务，建议看一下 Coding Plan，https://taotoken.net/coding-plan，它针对高频调用做了额度优化，比按量计费更适合长期跑 Agent 工作流。模型对话的入口在https://taotoken.net/models，可以在那里测试不同模型的响应质量，再决定 OpenClaw 里默认用哪个。
接入文档在https://taotoken.net/doc，里面有各语言的调用示例和字段说明。遇到配置问题时，对照文档检查字段名和格式，比盲目试错快得多。
OpenClaw 的 dashboard 支持技能配置和钩子，初始化时跳过的那些选项后面都可以在面板里补。比如你想让它接飞书或者搜索引擎，在面板的设置里能找到对应入口。不过这些属于进阶用法，先把基础对话跑通，再逐步加功能。
最后提醒一点：OpenClaw 的网关默认只监听127.0.0.1，不要改成0.0.0.0暴露到公网，除非你清楚自己在做什么。本地跑通、本地用，是最稳妥的方式。
