1. 为什么 Windows 用户跑 OpenClaw 总在第一步卡住OpenClaw 是一个可以本地部署、通过浏览器看板交互的 AI 助手框架支持接入多种模型通道适合想在自己电脑上跑通完整对话链路、又不想把数据丢到别人服务器上的开发者。它的安装脚本是给 Linux 环境写的Windows 原生 PowerShell 直接跑会遇到一堆路径和权限问题所以主流做法是走 WSL2 Ubuntu 这条路。我试过在 Windows 11 上从零装一遍踩过的坑集中在三块WSL2 没开虚拟化导致 Ubuntu 装不上、Node.js 版本太低让 npm 装依赖时报 engine 不匹配、以及 openclaw.json 里模型通道没配对导致看板能打开但一发消息就 401。这篇就按真实操作顺序把 WSL2 启用、Ubuntu 准备、Node.js 安装、OpenClaw 安装、openclaw.json 配置、TaoToken 通道接入、验证请求这条链路完整走一遍配置片段可以直接复制。适合谁看手上是 Windows 10/11、想本地跑 OpenClaw、对 Linux 命令不算熟但能照着敲的读者。全程不需要额外网络工具WSL2 和 Ubuntu 都从系统自带渠道获取。2. 前置准备WSL2、Ubuntu 与 Node.js 环境2.1 启用 WSL2 与虚拟机平台以管理员身份打开 PowerShell右键开始菜单选“终端(管理员)”或“Windows PowerShell(管理员)”依次执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart wsl --set-default-version 2三条命令分别开启 Linux 子系统、虚拟机平台并把默认版本设为 WSL2。执行完必须重启电脑否则虚拟化层不生效后面 Ubuntu 会启动失败。注意如果wsl --set-default-version 2报“WSL2 需要更新内核组件”去微软官方文档页下载 WSL2 内核更新包安装即可这一步不涉及任何第三方工具。2.2 安装 Ubuntu 并初始化重启后在 Microsoft Store 搜索 Ubuntu选 22.04 LTS 版本安装。装完首次启动会要求设置用户名和密码这个密码是 sudo 提权用的记牢。进入终端后先更新系统并装基础依赖sudo apt update sudo apt upgrade -y sudo apt install -y curl git wget build-essentialbuild-essential别省OpenClaw 部分依赖带原生模块缺编译工具链会在 npm install 阶段报 gyp 错误。2.3 安装 Node.js 22.xOpenClaw 要求 Node.js 18 以上实测 22.x 最稳。用 NodeSource 源安装curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs验证版本node -v npm -v正常输出类似v22.11.0和10.9.0。如果node -v还是旧版本说明系统里残留了 apt 自带的 node执行sudo apt remove nodejs -y再重装一次。3. TaoToken 前置统一 Key 与 API 通道OpenClaw 本身只是框架真正干活的是背后接的模型通道。与其在 openclaw.json 里给每个 provider 单独填 key、单独配 base_url不如用一个统一入口把模型请求收拢配置量能少一大半。TaoToken 在这里的角色就是统一 Key 统一 API 通道你申请一个 Key把 base_url 指向它的 API 地址之后换模型、加模型都只改 model 字段不用动鉴权部分。对本地调试特别友好因为 openclaw.json 里 provider 段可以写得很干净。先去官网注册并拿到 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content登录后在控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 管理页在这里可以随时新建或吊销https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewriteAPI 基础地址统一用https://taotoken.net/api这个地址不加任何查询参数直接作为 base_url 填进配置。Key 拿到后先别急着写进文件下一步会讲怎么放才安全。4. 可复制配置openclaw.json 骨架与 TaoToken 接入4.1 安装 OpenClaw在 Ubuntu 终端执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash装完它会提示看板地址形如http://localhost:18789/#tokenxxxx。先别关终端配置文件在~/.openclaw/openclaw.json用 vim 打开vim ~/.openclaw/openclaw.json4.2 openclaw.json 骨架下面是一份可直接改用的骨架重点是providers段把 TaoToken 作为统一通道models段引用它{ gateway: { host: 0.0.0.0, port: 18789, authToken: 把看板链接里的token粘到这里 }, providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: [ claude-sonnet-4-5, gpt-4o-mini, qwen-plus ] } }, defaultModel: taotoken/claude-sonnet-4-5, tools: { enabled: true, allowAll: true } }几个字段说明type用openai-compatible是因为 TaoToken 的 API 走 OpenAI 兼容协议OpenClaw 原生支持baseUrl结尾不要带斜杠defaultModel用provider/model的写法斜杠前是 providers 里的键名。tools.allowAll先设 true 方便调试跑通后再按需收紧。注意apiKey 直接明文写在 json 里只适合本地调试。如果这台机器多人用改成从环境变量读把apiKey: sk-xxx换成apiKeyEnv: TAOTOKEN_API_KEY然后在~/.bashrc里 export 这个变量。4.3 重启网关让配置生效改完保存退出重启 OpenClaw 网关openclaw gateway restart如果提示命令不存在说明安装脚本没把 bin 加进 PATH执行source ~/.bashrc或重开终端再试。5. 验证请求确认调试链路正常5.1 看板侧验证浏览器打开http://localhost:18789/#token你的token进入聊天界面发一条“你好回复一个字”。如果收到回复说明 gateway、provider、model 三段都通了。5.2 命令行侧验证更可靠的验证是直接打 API绕开看板 UI确认 TaoToken 通道本身没问题curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }返回 JSON 里choices[0].message.content有内容就证明 Key 和通道都正常。这一步通了但看板不通问题一定在 openclaw.json 的字段上不用怀疑网络。5.3 模型授权与切换OpenClaw 支持通过命令做 provider 授权比如千问通道openclaw models auth login --provider qwen-portal它会输出一个链接浏览器打开完成授权即可。TaoToken 这种 openai-compatible 通道不需要走 auth loginKey 填对就能用。想换模型时只改defaultModel的值比如换成taotoken/gpt-4o-mini再openclaw gateway restart。5.4 权限与工具确认登录看板后进 tools 页面确认需要的工具权限都打开。调试阶段全开正式用的时候把文件写入、命令执行这类高风险工具关掉只留对话和检索。6. 本篇常见错排查报错一wsl --set-default-version 2提示虚拟化未启用。进 BIOS 打开 Intel VT-x 或 AMD-VWindows 功能里确认“虚拟机平台”已勾选重启后再执行。报错二npm install 阶段报gyp ERR!或node-gyp失败。缺编译工具链回第 2.2 步补装build-essential再npm rebuild。报错三看板能打开发消息返回 401。九成是 apiKey 写错或 baseUrl 带了多余斜杠。用第 5.2 步的 curl 单独验证 Key能通就说明是 json 字段问题。报错四openclaw gateway restart报 command not found。PATH 没刷新source ~/.bashrc或重开终端。仍不行就找安装脚本输出的 bin 路径手动加进 PATH。报错五模型返回model not found。defaultModel里的模型名不在 providers 的 models 列表里或者斜杠前的 provider 键名拼错。对照第 4.2 步的骨架检查。报错六端口 18789 被占用。改 openclaw.json 里gateway.port为其他值重启网关看板地址端口同步改。排查顺序建议固定成先 curl 验通道再看 json 字段最后查 gateway 日志。这样能快速定位是通道问题还是配置问题。7. 后续怎么用模型对话、Coding Plan 与接入文档链路跑通后日常使用分几个方向。想快速验证某个模型效果直接进模型对话页试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite如果你打算把 OpenClaw 当长期编码助手或 Agent 底座用按量计费不如包月划算可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite接入细节、字段含义、兼容协议这些官方文档写得比我这里细遇到配置疑问直接查https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你用的是 Claude Code 这类 Anthropic 协议工具接入方式略有不同参考这份说明https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite最后给个实用建议openclaw.json 改之前先cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak改崩了直接还原比重装快得多。调试阶段把 gateway 日志开着openclaw gateway logs -f报错第一时间能看到比猜字段高效。