1. 为什么要在 Windows 11 上用 WSL2 跑 OpenClawOpenClaw 是一个本地优先的 AI 助理框架能接文件管理、系统监控、网页自动化、知识库问答这些技能适合想在自己电脑上搭一套可控 AI 工作流的人。它原生跑在 Linux 环境里Windows 直接装会遇到一堆路径和依赖问题所以 WSL2 成了 Windows 11 用户最省事的方案——你既保留 Windows 的日常操作又拿到一个接近原生的 Linux 子系统。我自己的主力机是 Windows 11 i5-12400 32GB 内存之前试过直接在 PowerShell 里硬装 OpenClaw卡在 Python 编译和 Redis 服务上折腾了大半天。换成 WSL2 之后整个链路清晰很多发行版装好、依赖一次到位、服务用 systemd 托管重启电脑也能自动拉起来。这篇就把从零到跑通、再到接上 TaoToken 统一 Key 的完整过程写清楚你照着敲命令就行。先说清楚这套方案适合谁习惯 Windows 但想玩本地 AI 助理的用户、需要 Windows 开发环境同时跑 OpenClaw 的程序员、用 Windows 笔记本的学生党以及想拿闲置 Windows 机器当家庭 AI 服务器的技术爱好者。不适合纯 Linux 用户直接原生装更省事和需要重度 GPU 加速的场景WSL2 的 GPU 直通有限制。硬件上8GB 内存能跑起来但会紧张推荐 16GB 以上存储留 64GB 可用空间SSD 体验明显更好。系统要求 Windows 11 全版本都支持Windows 10 需要 2004Build 19041及以上。最关键的一点BIOS 里必须开启虚拟化Intel VT-x 或 AMD-V否则 WSL2 根本起不来这个后面排障会专门讲。整个链路分四段装 WSL2 和 Ubuntu 22.04、准备 Python/Node/Redis 依赖、拉取并配置 OpenClaw、最后接 TaoToken 统一 Key 做首次对话验证。下面按顺序来每段都给可复制的命令和配置片段。2. TaoToken 统一 Key 前置准备与 API 通道说明OpenClaw 本身是个框架它需要接一个模型服务才能对话。TaoToken 在这里的角色是提供统一的 API 通道和 Key 管理——你不用为每个模型单独申请账号、记一堆 Key一个统一 Key 就能走通对话、编码、Agent 这些场景。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。在动手装 OpenClaw 之前建议你先把 Key 拿到手这样配置阶段能一次填完不用来回切窗口。操作路径是进官网 → 登录 → 控制台 → API Keys 页面创建 Key。创建时给它起个能认出来的名字比如openclaw-wsl2方便以后区分。Key 只在创建时完整显示一次复制下来存到安全的地方后面配置环境变量要用。这里要强调一个概念Base URL 和 Key 是两回事。Base URL 是请求发往哪个地址统一填https://taotoken.net/apiKey 是身份凭证放在请求头里。OpenClaw 的配置里这两个要分开填很多人第一次配错就是把 Key 填到了 Base URL 的位置结果一直 401。模型 ID 这块TaoToken 支持多种模型你在控制台能看到可用的模型列表。OpenClaw 配置里需要指定一个默认模型 ID比如对话场景常用的那类。具体填哪个以你控制台里实际可用的为准别照抄别人的因为账号权限不同可用模型也不同。如果你后面还要接 Claude Code 或者做长期编码任务TaoToken 还有 Coding Plan 这个选项适合高频调用场景。不过这篇聚焦 OpenClaw 首次跑通先把基础对话链路打通Coding Plan 可以等跑通后再按需了解。拿 Key 这一步不复杂但有个坑要提前说别把 Key 直接写进会提交到 Git 的配置文件里。正确做法是写进环境变量或者单独的.env文件并且把.env加进.gitignore。后面配置章节会给具体做法。3. WSL2 与 OpenClaw 可复制配置片段这一段是全文的核心所有配置都给完整片段你复制改路径就能用。先装 WSL2 和 Ubuntu 22.04。以管理员身份打开 PowerShell执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart Restart-Computer重启后设置默认版本并安装发行版wsl --set-default-version 2 wsl --list --online wsl --install -d Ubuntu-22.04首次启动 Ubuntu 会让你创建 UNIX 用户名和密码这个密码后面sudo要用记牢。进去之后先更新系统sudo apt update sudo apt upgrade -y sudo apt autoremove -y sudo timedatectl set-timezone Asia/Shanghai接着装依赖。Python、Node、Redis 一次到位sudo apt install -y python3 python3-pip python3-venv git sqlite3 build-essential libffi-dev libssl-dev curl wget vim htop net-tools redis-server curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs sudo systemctl start redis-server sudo systemctl enable redis-server redis-cli pingredis-cli ping返回PONG就说明 Redis 正常。如果 systemd 没生效先看后面的/etc/wsl.conf配置。现在配置 WSL2 的 systemd 和资源限制。在 WSL2 里编辑/etc/wsl.conf[boot] systemdtrue [network] generateResolvConftrue然后在 Windows 用户目录创建.wslconfig路径C:\Users\你的用户名\.wslconfig[wsl2] memory8GB processors4 swap2GB改完在 PowerShell 里wsl --shutdown再重进systemd 就生效了。拉取 OpenClaw 并建虚拟环境mkdir -p ~/projects cd ~/projects git clone https://github.com/openclaw/openclaw.git cd openclaw python3 -m venv venv source venv/bin/activate pip install --upgrade pip pip install -r requirements.txt前端依赖cd web npm install npm run build cd ..现在配置 OpenClaw 接 TaoToken。先建目录和.env文件mkdir -p config data logs uploads cp config/config.example.yaml config/config.yaml编辑config/config.yaml重点是ai段server: host: 0.0.0.0 port: 8080 debug: false database: type: sqlite path: ./data/openclaw.db redis: host: localhost port: 6379 db: 0 ai: provider: openai-compatible base_url: https://taotoken.net/api api_key: ${TAOTOKEN_API_KEY} model: 你的模型ID max_tokens: 2048 temperature: 0.7 skills: enabled: - file_manager - system_monitor - web_automation - knowledge_base auto_load: true security: allowed_hosts: - localhost - 127.0.0.1 logging: level: INFO file: ./logs/openclaw.log注意api_key用的是${TAOTOKEN_API_KEY}占位符真实 Key 放环境变量。创建.envcat .env EOF TAOTOKEN_API_KEY你的真实Key EOF echo .env .gitignore然后让 OpenClaw 启动时加载.env。如果你用 systemd在服务文件里加EnvironmentFile如果手动启动先exportexport $(grep -v ^# .env | xargs)配置 systemd 服务编辑/etc/systemd/system/openclaw.service[Unit] DescriptionOpenClaw AI Assistant Afternetwork.target redis.service [Service] Typesimple User你的用户名 WorkingDirectory/home/你的用户名/projects/openclaw EnvironmentFile/home/你的用户名/projects/openclaw/.env EnvironmentPATH/home/你的用户名/projects/openclaw/venv/bin ExecStart/home/你的用户名/projects/openclaw/venv/bin/python main.py Restartalways RestartSec10 [Install] WantedBymulti-user.target启用并启动sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw sudo systemctl status openclaw到这里配置就齐了。三件套对照一下Base URL 是https://taotoken.net/apiKey 在.env里Model ID 在config.yaml的ai.model。这三个填对链路就通。4. 验证请求与首次对话成功结果配置写完不能直接信得验证。分两步先验 TaoToken 通道本身通不通再验 OpenClaw 能不能正常对话。第一步在 WSL2 里用 curl 直接打 TaoToken 的 API确认 Key 和网络没问题curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: 你的模型ID, messages: [{role: user, content: ping}], max_tokens: 16 }正常返回是一段 JSON里面有choices数组choices[0].message.content就是模型回复。如果返回 401说明 Key 不对或没加载进环境变量如果返回连接超时检查 WSL2 网络。第二步看 OpenClaw 服务日志sudo journalctl -u openclaw -f启动成功的日志大概长这样INFO: OpenClaw starting... INFO: Loading configuration from config/config.yaml INFO: WSL2 environment detected INFO: Connecting to Redis at localhost:6379 INFO: Database connection established INFO: AI provider: openai-compatible INFO: Web interface available at http://localhost:8080 INFO: OpenClaw is ready!看到OpenClaw is ready!就说明服务起来了。在 Windows 浏览器访问http://localhost:8080能看到 Web 界面。WSL2 默认会把 localhost 转发到 Windows所以不用查 IP 直接访问就行。在 Web 界面里发一条测试消息比如「你好帮我列一下当前目录的文件」。如果模型正常返回说明整条链路通了Windows 浏览器 → WSL2 里的 OpenClaw → TaoToken API → 模型 → 原路返回。再验一下 API 端口curl -s http://localhost:8080/api/health返回{status:ok}之类的就说明 OpenClaw 的 API 服务正常。如果 Web 界面能打开但对话报错多半是ai段配置问题重点看base_url有没有写全要带/api、model是不是控制台里可用的。我试过把base_url写成https://taotoken.net漏了/api结果一直 404补上就好了。验证通过后建议把开机自启也确认一遍sudo systemctl is-enabled openclaw返回enabled就对了。这样重启 Windows 后WSL2 起来 systemd 会自动拉起 OpenClaw。5. 本篇常见报错排查这一段按真实报错来你遇到哪个对哪个。报错一401 Unauthorized最常见。原因通常是 Key 没加载进环境变量或者 Key 复制时带了空格。先确认环境变量echo $TAOTOKEN_API_KEY如果输出为空说明.env没被加载。手动export $(grep -v ^# .env | xargs)再试。如果 systemd 启动的检查服务文件里EnvironmentFile路径对不对。还有一种情况是 Key 本身失效了去控制台重新创建一个。报错二local proxy failed / connection refused这个通常出现在 WSL2 网络异常时。先重置网络wsl --shutdown wsl如果还不行检查/etc/resolv.conf是不是被写坏了。在/etc/wsl.conf里确保generateResolvConftrue然后重启 WSL。另外确认 Windows 防火墙没拦 WSL2 的虚拟网卡可以加一条入站规则New-NetFirewallRule -DisplayName WSL2 -Direction Inbound -InterfaceAlias vEthernet (WSL) -Action Allow报错三reading choices 相关解析错误这个报错说明请求发出去了但返回的 JSON 结构不符合 OpenClaw 预期。常见原因是base_url写错比如漏了/api或者多写了/v1。TaoToken 的 Base URL 统一是https://taotoken.net/apiOpenClaw 内部会自己拼/v1/chat/completions你别手动加。另外确认provider填的是openai-compatible填错会导致解析逻辑不对。报错四OAuth / 认证流程报错如果你在配置里误开了某些需要 OAuth 的 provider会走到认证流程然后失败。OpenClaw 接 TaoToken 用的是 API Key 模式不需要 OAuth。检查config.yaml的ai段确保没有oauth相关字段provider是openai-compatible。报错五systemd 不工作systemctl 命令报错WSL2 默认可能没开 systemd。编辑/etc/wsl.conf加[boot]段systemdtrue然后 PowerShell 里wsl --shutdown重进。验证systemctl --version能输出版本号就对了。报错六8080 端口被占用sudo lsof -i :8080找到占用进程后要么停掉它要么改 OpenClaw 的端口。改config.yaml里server.port为 8081然后sudo systemctl restart openclaw。报错七内存不足导致 Windows 卡顿WSL2 默认会吃掉大量内存。在.wslconfig里限制[wsl2] memory8GB processors4 swap2GB改完wsl --shutdown重进生效。报错八Redis 连接失败redis-cli ping不通的话先sudo systemctl start redis-server再sudo systemctl enable redis-server。如果 systemd 没开用sudo service redis-server start临时启动。排查思路就一条从下往上查。先确认 WSL2 网络通curl 打 TaoToken再确认 OpenClaw 服务起来journalctl 看日志最后确认配置三件套Base URL、Key、Model ID都对。哪层断了修哪层别一上来就重装。6. 跑通之后把 OpenClaw 接进日常工作流服务跑通只是起点。OpenClaw 在 WSL2 里能访问 Windows 文件系统路径是/mnt/c/Users/你的用户名/你可以让它直接读 Windows 上的文档做知识库问答。VS Code 装个 Remote - WSL 扩展就能在 Windows 里直接编辑 WSL2 里的配置文件改完sudo systemctl restart openclaw就生效。如果你要长期跑建议把 OpenClaw 的日志目录挂到 Windows 侧方便查看或者用journalctl -u openclaw --since 1 hour ago按时间筛。API 接口这块OpenClaw 暴露的/api端点可以让你从 Windows 上的其他脚本调用比如用 PowerShell 发请求触发一个任务。想深入的话TaoToken 的接入文档里有更细的 API 参数说明模型对话页面可以直接试不同模型的返回效果控制台的 API Keys 页面能管理多个 Key 做轮换。这些都在官网对应入口能找到。最后留个实用习惯每次改完config.yaml或.env先sudo systemctl restart openclaw再sudo journalctl -u openclaw -n 50看最近 50 行日志确认没报错。这个动作能帮你第一时间发现配置写错比等对话失败再回头查快得多。