1. Windows 上跑 OpenClaw为什么绕不开 WSL2OpenClaw 是一个跑在终端里的 AI 编码代理能读写文件、执行命令、调用大模型完成多步任务。它的运行环境是 Linux官方安装脚本curl -fsSL https://molt.bot/install.sh | bash也是为 bash 写的。Windows 原生 PowerShell 直接跑会卡在依赖和路径上所以主流做法是先用 WSL2 装一个 Ubuntu再在 Ubuntu 里部署 OpenClaw。WSL2 是 Windows 自带的 Linux 子系统底层是轻量虚拟机能跑完整 Linux 内核和 Windows 文件系统互通。适合谁手上是 Windows 10 2004 以上或 Windows 11、CPU 支持虚拟化、内存 8GB 起步的开发者。装完之后你会在 Windows 里得到一个真正的 Ubuntu 终端OpenClaw 的安装脚本、systemd 服务、npm 全局包都能正常跑。这篇按「前置检查 → WSL2 安装 → Ubuntu 初始化 → OpenClaw 部署 → TaoToken 接入 → 验证 → 排障」的顺序走命令都可以直接复制。踩过的坑集中在网络模式、systemd 和 npm 全局路径三处后面单独列出来。2. 部署前把 TaoToken 的 Key 准备好OpenClaw 本身不带模型它需要接一个兼容 OpenAI 协议的服务端点。TaoToken 提供统一的 API Key一个 Key 可以调用多个模型省去在 OpenClaw 里逐个配 provider 的麻烦。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。操作顺序先注册账号进控制台创建 API Key把 Key 复制到本地记事本暂存。控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你打算长期用 OpenClaw 做编码和 Agent 任务可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 按订阅方式走比按量更省心。Key 拿到后先别急着填等 OpenClaw 装完、openclaw config初始化向导跑通再改settings.json。这样出问题时能分清是环境问题还是配置问题。3. WSL2 与 Ubuntu 的可复制配置3.1 前置检查按Win R输入winver确认 Windows 10 内部版本 ≥ 19041或任意 Windows 11。按Ctrl Shift Esc打开任务管理器性能 → CPU右下角看「虚拟化已启用」。没启用就重启进 BIOS 开 VT-x/AMD-V。按Win X选「Windows 终端管理员」后面所有命令都在这个窗口执行。3.2 一键安装 WSL2 和 Ubuntuwsl --install这条命令会自动启用「适用于 Linux 的 Windows 子系统」和「虚拟机平台」两个组件下载 WSL2 内核安装默认 Ubuntu 发行版并把 WSL2 设为默认版本。执行完重启电脑。重启后 Ubuntu 会自动启动提示创建 UNIX 用户Enter new UNIX username: openclaw New password: Retype new password:用户名用纯英文小写密码输入时无回显记牢。3.3 验证版本和状态wsl --list --verbose成功标准STATE 显示 RunningVERSION 显示 2发行版名为 Ubuntu。如果 VERSION 是 1执行wsl --set-version Ubuntu 2转换。3.4 Ubuntu 初始化进入 Ubuntu 终端后先更新软件源并装基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl wget git3.5 配置 .wslconfig 网络模式在 Windows 用户目录C:\Users\你的用户名\下新建.wslconfig文件注意前面的点不要存成.wslconfig.txt[wsl2] networkingModemirrored dnsTunnelingtrue autoProxytrue firewalltrue [experimental] autoMemoryReclaimgradual hostAddressLoopbacktrue保存后在 PowerShell 执行wsl --shutdown等 8 秒再启动 Ubuntu。镜像模式让 WSL 和 Windows 共享网络栈OpenClaw 的端口在 Windows 侧能直接访问也避免 DNS 解析在复杂网络下失效。3.6 开启 systemdOpenClaw 的 gateway 依赖 systemd 管理服务WSL 默认不开。在 Ubuntu 里执行sudo tee /etc/wsl.conf EOF [boot] systemdtrue EOF然后在 PowerShell 执行wsl --shutdown重新进入 Ubuntu。验证systemctl --version能输出版本号说明 systemd 已生效。3.7 配置 sudo 免密可选但推荐安装脚本里会多次调用 sudo免密能少输几次密码sudo visudo在文件末尾加一行把openclaw换成你的用户名openclaw ALL(ALL) NOPASSWD: ALLCtrl O保存Enter确认Ctrl X退出。4. 部署 OpenClaw 并接入 TaoToken4.1 执行官方安装脚本curl -fsSL https://molt.bot/install.sh | bash脚本会装 Node.js 环境、拉取 OpenClaw 包、初始化配置目录。跑完后如果提示openclaw: command not found说明 npm 全局 bin 没进 PATH执行echo export PATH/home/openclaw/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc which openclaw openclaw --versionwhich能输出路径、--version能输出版本号就说明命令可用。4.2 运行初始化向导openclaw config向导会问模型 provider、API Key、默认模型等。这里可以先随便选一个跳过后面直接改配置文件更清楚。4.3 写入 settings.json 接入 TaoTokenOpenClaw 的配置文件在~/.openclaw/settings.json不同版本路径可能略有差异用openclaw config --path确认。用编辑器打开填入下面骨架{ models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, api: openai-completions, models: [ { id: claude-sonnet-4-5, name: claude-sonnet-4-5, reasoning: true, input: [text], contextWindow: 200000, maxTokens: 64000 } ] } } }, agents: { defaults: { model: { primary: taotoken/claude-sonnet-4-5 }, models: { taotoken/claude-sonnet-4-5: { alias: sonnet } }, maxConcurrent: 4, subagents: { maxConcurrent: 8 } } } }几个字段说明baseUrl填 TaoToken 的 API 基址不要带尾部斜杠apiKey填控制台创建的 Keyapi用openai-completions走 OpenAI 兼容协议models[].id填你要用的模型标识具体可用模型在模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 能查到。agents.defaults.model.primary要和 provider 前缀对上格式是provider名/模型id。4.4 重启 gateway 让配置生效openclaw gateway restart如果提示 gateway 未安装openclaw gateway install systemctl --user start openclaw-gateway.service4.5 防火墙放行端口OpenClaw 默认服务端口是 18789镜像模式下需要在 Windows 侧放行。以管理员身份开 PowerShellNew-NetFirewallRule -DisplayName OpenClaw-Service -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789 Get-NetFirewallRule -DisplayName OpenClaw-Service | Format-Table第二条能列出规则说明创建成功。5. 验证部署成功的检查动作按顺序跑下面几条全过就说明部署完成。which openclaw openclaw --version openclaw gateway statusgateway status输出里应该能看到active (running)或类似状态。然后发一条真实请求验证模型链路openclaw run 用一句话说明当前目录下有哪些文件如果 OpenClaw 能调用模型并返回结果说明 TaoToken 的 Key、baseUrl、模型 id 三处都对上了。想单独验证模型连通性可以到模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 发一条消息确认 Key 本身可用。再检查一下配置文件是否被正确读取openclaw config --show输出里能看到taotokenprovider 和默认模型就说明 settings.json 生效了。6. 本篇常见报错排查报错一wsl --install提示需要更新内核。手动下载微软官方 WSL2 内核更新包安装再重跑命令。或者执行wsl --update。报错二wsl --list --verbose里 VERSION 是 1。先确认 CPU 虚拟化已开然后wsl --set-default-version 2再wsl --set-version Ubuntu 2转换。报错三gateway 启动失败提示 systemd 不可用。回到 3.6 节确认/etc/wsl.conf里[boot] systemdtrue已写入然后wsl --shutdown重启。报错四openclaw: command not found。npm 全局 bin 没进 PATH按 4.1 节把~/.npm-global/bin加进.bashrc并 source。报错五镜像模式不生效ip addr还是 172 开头。检查.wslconfig是否放在C:\Users\用户名\下、文件名是否是.wslconfig而不是.wslconfig.txt然后wsl --shutdown等 10 秒再启动必要时wsl --update。报错六模型请求返回 401 或 404。401 是 Key 不对回控制台重新生成404 是 baseUrl 或模型 id 写错baseUrl 用https://taotoken.net/api模型 id 到模型对话页核对。报错七忘记 Ubuntu 用户密码。在 PowerShell 执行wsl -d Ubuntu -u root以 root 进入passwd 你的用户名重设exit后用新密码登录。接入相关的细节可以对照接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 核对字段。如果你用的是 Claude Code 那套工作流Anthropic 兼容配置页 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 有对应的参数说明OpenClaw 的 provider 字段可以照着改。最后留一个实用习惯每次改完settings.json或.wslconfig先wsl --shutdown再重进再openclaw gateway restart三步走能避免大部分「改了没生效」的困惑。