1. Windows 上跑 OpenClaw 为什么绕不开 WSL2OpenClaw 是一个面向个人和小团队的智能体网关能对接多种大模型、管理节点、跑自动化任务。它本身没有原生 Windows 二进制包官方推荐在 Linux 环境里运行。Windows 用户想“人人养虾”最省事的路子就是 WSL2——Windows Subsystem for Linux 2适用于 Linux 的 Windows 子系统第二版。它给你一个完整的 Linux 内核性能接近原生还能和 Windows 文件系统互通。我试过直接在 Windows 上折腾 Node 环境依赖冲突和路径问题能把人劝退。换成 WSL2 Ubuntu 之后OpenClaw 的安装脚本一次跑通。这篇就按“PowerShell 启用 WSL2 → Ubuntu 初始化 → 依赖安装 → TaoToken 统一 Key 配置 → curl 验证”的顺序把每一步的可复制命令和配置片段交给你。适合谁用 Windows 10/11、想本地跑 OpenClaw 网关、又不想装双系统的开发者。核心检索词就三个OpenClaw、WSL2、Windows。读完你能得到一个能启动、能验证、能排错的养虾环境。先说清楚硬件门槛避免白忙活。Windows 10 21H2 或 Windows 11CPU 支持虚拟化VT-x/AMD-V内存 8GB 起步16GB 更稳磁盘留 20GB 可用空间。低于这个配置WSL2 和 OpenClaw 抢内存会很难受。WSL2 和 WSL1 的区别值得提一句WSL1 是系统调用翻译层WSL2 是轻量虚拟机里跑真 Linux 内核。OpenClaw 依赖的一些网络和进程行为在 WSL2 下才正常所以务必确认版本是 2。后面wsl -l -v那一步就是干这个的。2. PowerShell 启用 WSL2 与 Ubuntu 初始化这一章全在 Windows 侧操作用管理员身份打开 PowerShell。最省心的是微软的一键安装wsl --install这条命令会自动启用 WSL 功能、装 WSL2 内核、拉取 Ubuntu 默认发行版。跑完重启电脑重启后 Ubuntu 会自动弹窗让你设用户名和密码。设完就进 Linux 了。如果一键安装卡住或报错走手动流程。逐条执行# 1. 启用 WSL 功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 2. 启用虚拟机平台 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 3. 重启电脑 Restart-Computer # 4. 设置 WSL 默认版本为 2 wsl --set-default-version 2 # 5. 安装 Ubuntu 22.04 wsl --install -d Ubuntu-22.04重启后确认版本这条命令的输出里 VERSION 必须是 2wsl -l -v正常输出类似NAME STATE VERSION * Ubuntu-22.04 Running 2如果 VERSION 显示 1用wsl --set-version Ubuntu-22.04 2转换。转换过程可能几分钟别中断。进入 Ubuntu 环境直接敲wsl第一次进去先更新系统再装依赖。OpenClaw 需要 Node.js 20 以上sudo apt update sudo apt upgrade -y curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -vnode -v应输出 v20.x 或更高。然后装 OpenClawnpm install -g openclaw openclaw --version到这一步OpenClaw 本体就位。接下来是网络和 Key 配置这才是能不能真正跑起来的关键。注意WSL2 默认用 NAT 网络Windows 宿主机访问 WSL2 里的服务需要端口转发。新版 Windows 11 对 localhost 有自动转发但 IP 每次启动可能变后面会给启动脚本。3. TaoToken 统一 Key 与 OpenClaw settings 配置OpenClaw 要调用大模型得配 API 通道。TaoToken 提供统一的 Key 和兼容接口把 Base URL 指向https://taotoken.net/api一个 Key 就能管多个模型。先去控制台拿 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole拿到 Key 后在 WSL2 Ubuntu 里配置 OpenClaw。OpenClaw 的配置文件通常在~/.openclaw/settings.json。先建目录mkdir -p ~/.openclaw然后写入配置。下面这段是可复制的 JSON路径和字段名按 OpenClaw 实际结构来{ gateway: { port: 7681, host: 0.0.0.0 }, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514, type: openai-compatible } }, defaultProvider: taotoken }三个关键件必须齐全Base URL 是https://taotoken.net/apiKey 是你控制台生成的Model ID 按你要用的模型填。缺任何一个都会在启动时报错。如果你用 Claude Code 或 Cline 这类工具配置逻辑一样把 Base URL 和 Key 填进对应位置即可。OpenClaw 的 provider 类型写openai-compatible因为 TaoToken 的接口兼容 OpenAI 格式。模型 ID 可以在模型对话页确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodels配完保存启动网关openclaw gateway start如果提示端口占用改 settings.json 里的 port或者先openclaw gateway stop再启。注意Key 不要提交到 Git也不要在截图里露出。settings.json 权限设成 600chmod 600 ~/.openclaw/settings.json。4. curl 验证连通性与端口转发实测配置写完先别急着开浏览器。用 curl 直接打 TaoToken 接口确认 Key 和网络通curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json返回 JSON 里能看到模型列表说明 Key 有效、网络可达。如果返回 401是 Key 错了或没带 Bearer 前缀返回超时检查 WSL2 的 DNS。再验证 OpenClaw 网关本身curl -s http://localhost:7681/health返回{status:ok}之类就说明网关起来了。接下来处理 Windows 宿主机访问。先拿 WSL2 的 IPwsl hostname -I假设输出172.20.10.5在管理员 PowerShell 里加端口转发netsh interface portproxy add v4tov4 listenport7681 listenaddress0.0.0.0 connectport7681 connectaddress172.20.10.5 New-NetFirewallRule -DisplayName OpenClaw -Direction Inbound -LocalPort 7681 -Protocol TCP -Action Allow然后在 Windows 浏览器访问http://localhost:7681。新版 Windows 11 通常自动转发不生效再手动加。WSL2 每次重启 IP 会变转发规则就失效。写个启动脚本start-openclaw.ps1$wslIp (wsl hostname -I).Trim() Write-Host WSL2 IP: $wslIp netsh interface portproxy delete v4tov4 listenport7681 listenaddress0.0.0.0 netsh interface portproxy add v4tov4 listenport7681 listenaddress0.0.0.0 connectport7681 connectaddress$wslIp wsl -e openclaw gateway start每次开机跑一次这个脚本转发和网关一起搞定。资源占用高的话在 Windows 用户目录建.wslconfig[wsl2] memory4GB processors2 swap2GB localhostForwardingtrue改完wsl --shutdown再进。5. 常见报错排查401、local proxy failed 与 OAuth养虾路上最容易卡在几个固定报错上逐个拆。401 Unauthorizedcurl 或 OpenClaw 日志里出现 401九成是 Key 问题。检查三点Key 有没有复制全前后空格也算错请求头是不是Authorization: Bearer sk-xxxKey 有没有在控制台被禁用。重新生成一个 Key 再试。local proxy failed / connection refusedOpenClaw 启动时报这个通常是 Base URL 写错或网络不通。确认 settings.json 里是https://taotoken.net/api不是https://taotoken.net/api/v1路径重复会 404。再 curl 一次接口确认网络。reading choices 报错调用模型后返回结构解析失败报reading choices之类。这多半是 Model ID 填错或者 provider 类型没写openai-compatible。回 settings.json 核对 model 字段去模型对话页确认可用 ID。OAuth 相关报错如果你用 Claude Code 接入可能遇到 OAuth 流程问题。Claude Code 的配置在~/.claude/settings.jsonBase URL 和 Key 要填对。参考接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdocWSL2 安装失败先确认 BIOS 里虚拟化开了VT-x/AMD-V。wsl --install无响应就检查 Windows Update或走手动 dism 流程。DNS 解析失败WSL2 里ping taotoken.net不通改 DNSecho nameserver 8.8.8.8 | sudo tee /etc/resolv.conf文件系统性能差项目别放/mnt/c/放/home/你的用户名/下IO 快很多。端口访问不了Windows 防火墙拦了确认New-NetFirewallRule那条执行过或者 WSL2 IP 变了重跑启动脚本。排查顺序建议先 curl TaoToken 接口 → 再 curl 网关 health → 再看 OpenClaw 日志openclaw logs --tail 50。日志里报错行通常直接指向配置字段。6. 把养虾环境固化成日常流程环境跑通只是开始日常用起来要顺手。在 PowerShell 里加个别名直接调 WSL 里的 OpenClawfunction openclaw { wsl openclaw $args }写进$PROFILE以后openclaw status、openclaw nodes、openclaw logs --tail 20都能在 PowerShell 里直接敲。长期跑编码和 Agent 任务的话Coding Plan 比按量更划算适合高频调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-planKey 管理在 API Keys 页面可以随时轮换https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys最后提醒一句WSL2 的 IP 会变启动脚本记得每次开机跑settings.json 权限锁 600Key 别外泄。把这三件事做成习惯OpenClaw 在 Windows 上就能稳定养虾了。