1. Windows 上跑 OpenClaw为什么我劝你先装 WSL2OpenClaw 是一个能在本地跑起来的 AI 编码助手工具支持浏览器自动化、技能扩展、多 Agent 协作这些玩法适合想在自己电脑上折腾 AI 工作流的人。但如果你是 Windows 用户直接装在原生系统上大概率会在编码乱码、技能不兼容、PATH 找不到命令这几个坑里反复横跳。我实测下来最省心的路径是Windows 装 WSL2在 Ubuntu 里跑 OpenClaw然后用 TaoToken 统一管理 API Key。这样一套组合下来Linux 环境该有的都有Node.js 环境干净Key 也不用在多个工具之间来回复制粘贴。这篇就按这个思路走先确认 WSL2 和 Ubuntu 装好再把 Node.js 环境配到位接着用 TaoToken 的 Key 完成 OpenClaw 侧配置最后跑一次连通性验证。目标是一次跑通不来回返工。整个流程分四块WSL2 Ubuntu 环境准备、Node.js 与 OpenClaw 安装、TaoToken Key 配置、连通性验证与排障。你跟着敲命令就行遇到报错直接跳到第 5 节对照排查。2. 前置准备WSL2、Ubuntu 与 TaoToken Key2.1 确认 Windows 版本并开启 WSL2WSL2 对系统版本有要求Windows 10 需要 2004 版本以上Build 19041Windows 11 全系支持。先在 PowerShell 里查一下当前状态wsl --list --verbose如果提示没有已安装的发行版说明还没装。接着安装 Ubuntu-24.04wsl --install Ubuntu-24.04安装过程中如果卡在下载或更新失败可以试试在 hosts 文件里加一行解析或者去 GitHub 的 microsoft/WSL releases 页面下载离线安装包双击安装。装完后再次执行wsl --list --verbose看到 Ubuntu-24.04 状态是 Running 就对了。注意WSL2 不是 OpenClaw 的硬性要求但原生 Windows 下浏览器自动化可能不稳定、很多技能标注只支持 Linux/macOS、PowerShell 输出中文还可能乱码。既然要折腾直接上 WSL2 少走弯路。2.2 拿到 TaoToken 的 API KeyTaoToken 在这里的角色是统一 Key 管理你只需要在它那边生成一个 KeyOpenClaw 以及后续其他工具都复用这一个不用每个工具单独去配。注册和生成 Key 的入口在控制台地址是 https://taotoken.net/api-keys 登录后新建一个 Key 复制出来备用。拿到 Key 之后先别急着填把下面两个信息记好配置项值API Base URLhttps://taotoken.net/apiAPI Key你在控制台生成的那串这两个值后面会写进 OpenClaw 的配置文件里。如果你还想先验证 Key 能不能正常调用模型可以打开模型对话页面 https://taotoken.net/chat 发一条消息试试能正常回复说明 Key 没问题。3. 可复制配置Node.js 环境 OpenClaw 安装 TaoToken 接入3.1 在 Ubuntu 里装 Node.js 22进入 WSL2 的 Ubuntu 终端先更新包列表并装基础依赖sudo apt update sudo apt install -y curl git build-essential然后装 Node.js 22。如果系统自带的版本低于 22用 NodeSource 的脚本装curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs装完验证一下node -v npm -v看到 v22.x.x 和对应的 npm 版本就 OK。这一步很关键OpenClaw 对 Node.js 版本有要求版本太低后面安装脚本会报错。3.2 安装 OpenClaw 并设置镜像官方安装脚本走的是默认源国内直接跑容易卡在 Installing 那一步。先把 npm 和 pnpm 的镜像换成国内源npm config set registry https://registry.npmmirror.com pnpm config set registry https://registry.npmmirror.com如果 pnpm 还没装先npm install -g pnpm再执行上面第二行。然后跑安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装过程中会弹出一些配置选项比如是否安装 daemon、选择模型提供商等。这里可以先跳过后面直接改配置文件更灵活。装完验证openclaw --version openclaw status openclaw gateway status三条命令都能正常输出说明主体装好了。3.3 写入 TaoToken 配置OpenClaw 的配置文件一般在~/.openclaw/openclaw.json。用编辑器打开把模型提供商指向 TaoToken{ providers: { taotoken: { type: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, models: { default: claude-sonnet-4-20250514 } } }, defaultProvider: taotoken }如果你用的是 config.toml 格式的版本对应写法是[providers.taotoken] type openai-compatible baseUrl https://taotoken.net/api apiKey 你的_TaoToken_Key [providers.taotoken.models] default claude-sonnet-4-20250514 defaultProvider taotoken保存后重启一下 gatewayopenclaw gateway restart提示Key 不要直接提交到 Git 仓库配置文件里如果涉及敏感信息建议用环境变量引用比如apiKey ${TAOTOKEN_API_KEY}然后在 shell 里 export。3.4 CC 配置片段可选如果你同时用 Claude Code 这类工具也可以让它复用同一个 TaoToken Key。在对应的 settings.json 里加{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的_TaoToken_Key } }这样 OpenClaw 和 Claude Code 共用一套 Key切换工具不用重新配。更多接入细节可以看接入文档 https://taotoken.net/doc 。4. 验证请求确认 OpenClaw 真的连上了配置写完不算完得实际发一次请求确认链路通。有两种验证方式。第一种直接在终端里让 OpenClaw 跑一个简单任务openclaw run 用一句话介绍你自己如果配置正确终端会返回模型输出。如果报 401 或连接超时说明 Key 或 baseUrl 有问题跳到第 5 节排查。第二种打开 Web UI 验证。默认 gateway 端口是 18789浏览器访问http://127.0.0.1:18789/chat?sessionmain首次打开如果提示需要 token把配置文件里的 token 拼到地址后面http://127.0.0.1:18789/?token你的token值看到聊天界面并能正常对话说明 OpenClaw TaoToken 这条链路完全打通了。成功的结果长这样终端openclaw status显示 gateway runningWeb UI 能正常收发消息模型返回内容没有乱码。到这一步Windows WSL2 OpenClaw TaoToken 的组合就算跑通了。5. 本篇常见错排查5.1 提示 openclaw: command not found这是 PATH 没配好。先查 npm 全局 bin 目录npm config get prefix假设输出是/home/你的用户名/.npm-global把这个路径的 bin 加进 PATHecho export PATH$HOME/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc再执行openclaw --version应该就能识别了。5.2 安装卡在 Installing OpenClaw大概率是源的问题。确认 npm 和 pnpm 镜像都换成了https://registry.npmmirror.com然后重新跑安装脚本。如果还是卡检查网络是否能正常访问 npm 镜像站。5.3 Web UI 打开报 token 错误首次访问需要带 tokentoken 在~/.openclaw/openclaw.json里。复制出来拼到 URL 后面即可。如果 token 对还是进不去检查 gateway 是否真的在运行openclaw gateway status。5.4 模型调用返回 401三种可能Key 复制时多了空格、baseUrl 写错、Key 已失效。先确认 baseUrl 是https://taotoken.net/api再去控制台 https://taotoken.net/api-keys 确认 Key 状态。如果 Key 没问题用模型对话页面 https://taotoken.net/chat 单独测一下能通说明是 OpenClaw 配置写法的问题。5.5 中文输出乱码这个在原生 Windows 下常见WSL2 里基本不会。如果你还在原生 Windows 跑建议切到 WSL2。已经在 WSL2 里还乱码检查终端编码设置Ubuntu 默认 UTF-8 一般没问题。6. 跑通之后Key 统一管理才是长期省心的地方一次跑通只是开始。后面你可能会加更多工具、换模型、跑多 Agent如果每个工具都单独配 Key管理成本会越来越高。用 TaoToken 统一 Key 的好处就在这里一个 Key 覆盖 OpenClaw、Claude Code 以及其他兼容 OpenAI 接口的工具换模型只改配置里的 model 字段不用动 Key。如果你打算长期用 OpenClaw 做编码或 Agent 任务可以了解下 Coding Plan https://taotoken.net/coding-plan 适合高频调用的场景。日常调试和验证模型直接用模型对话页面 https://taotoken.net/chat 就够了。接入过程中遇到配置问题接入文档 https://taotoken.net/doc 里有各工具的完整示例对照着改基本能解决。最后留一个实用习惯把~/.openclaw/openclaw.json里的 Key 换成环境变量引用配置文件可以放心备份和同步Key 单独存在 shell 环境里安全又省心。