1. 为什么 OpenClaw 在 Windows 上总是装不上OpenClaw 是一个跑在 Linux 环境里的程序它的安装脚本、依赖库、启动方式全部按 Linux 的目录结构和包管理器来写。你在 Windows 的 PowerShell 里直接跑它的安装命令脚本第一步检测系统环境就会报错退出提示找不到对应的发行版或者依赖缺失。这不是脚本写错了而是它压根没打算在纯 Windows 上运行。解决办法就是给 Windows 装一个 Linux 子系统也就是 WSL2。WSL2 是微软官方提供的功能它在你电脑里跑一个轻量的 Linux 内核Ubuntu 就装在这个内核上面。OpenClaw 的安装脚本进到 Ubuntu 里执行就跟在一台真正的 Linux 服务器上一样依赖能装上、服务能起来、端口能监听。这篇内容适合两类人一类是 Windows 10 或 Windows 11 用户想在本机跑 OpenClaw 但被环境卡住另一类是之前装过 WSL 但版本不对、或者 Ubuntu 装到一半失败的人。我会把 PowerShell 命令、Ubuntu 初始化、依赖安装、OpenClaw 启动验证以及后面接 TaoToken 统一 Key 的配置骨架都写清楚你照着复制执行就行。整个流程分四块先把 WSL2 地基打好再装 Ubuntu 并初始化然后装 OpenClaw 并验证启动最后把模型通道指向 TaoToken 的 API 地址让 OpenClaw 能正常调用模型。每一步都有对应的验证命令跑完能看到明确结果再进下一步避免装到一半不知道哪里出了问题。2. 前置准备TaoToken 账号与 Key 获取OpenClaw 启动之后需要连一个模型服务才能干活。TaoToken 提供统一的 API 通道你注册后拿到一个 Key填到 OpenClaw 的配置里它就能通过这个通道调用模型。这一步在装 WSL2 之前先做掉后面配置的时候直接填不用来回切窗口。打开浏览器访问 TaoToken 官网注册并登录。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册流程就是常规的邮箱加密码这里不展开。登录之后进控制台找到 API Keys 页面新建一个 Key。这个 Key 是一串以特定前缀开头的字符串复制下来存好后面配置config.toml的时候要用。控制台地址是 https://taotoken.net/console API Keys 页面在 https://taotoken.net/api-keys 。TaoToken 的 API 基础地址是 https://taotoken.net/api 这个地址在配置里填base_url或者api_base字段。注意这个地址不带任何查询参数就是纯路径。模型对话的入口在 https://taotoken.net/models 你可以先在那里试一下 Key 能不能正常调通确认没问题再往 OpenClaw 里填。如果你后面打算长期用 OpenClaw 做编码或者跑 Agent 任务可以看一下 Coding Plan地址是 https://taotoken.net/coding-plan 。接入文档在 https://taotoken.net/doc 里面有各个客户端的配置示例OpenClaw 的配置格式也能在里面找到参考。注意Key 只在创建的时候完整显示一次页面刷新后就看不到了。复制之后先存到记事本或者密码管理器里别直接关页面。3. 可复制配置WSL2 环境搭建全流程3.1 硬性门槛自查WSL2 对 Windows 版本有要求必须是 Windows 10 版本 2004 及以上或者 Windows 11。按Win R输入winver回车看弹出的版本号。如果低于 2004先去 Windows 更新里把系统升上来否则后面命令会直接报错。然后检查虚拟化有没有开。打开任务管理器切到“性能”标签点左侧的“CPU”右下角看“虚拟化”这一项。显示“已启用”就继续显示“已禁用”的话重启进 BIOS把 Intel VT-x 或者 AMD SVM 打开。这一步不做WSL2 装上了也起不来。3.2 启用 WSL 与虚拟机平台以管理员身份打开 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 功能第二条启用虚拟机平台。两条都跑完之后重启电脑。重启是必须的不重启功能不生效。3.3 安装 WSL 内核不装发行版重启后再次以管理员身份打开 PowerShell。这里有个坑直接跑wsl --install会默认去下载 Ubuntu 发行版而下载源在境外网络不好的时候会卡很久甚至超时。更稳的做法是先只装 WSL 引擎不装发行版wsl --install --no-distribution这条命令只装 WSL 核心组件不碰发行版速度快很多。跑完之后再重启一次电脑。重启后验证 WSL 版本wsl --version输出里能看到 WSL 版本号确认是 2.x 就对了。如果提示命令不存在说明前面的功能没启用成功回去检查 3.2 的两条 dism 命令有没有以管理员身份执行。3.4 通过应用商店安装 Ubuntu命令行装发行版慢改用 Microsoft Store。打开应用商店搜索 Ubuntu 22.04点安装。应用商店在国内有镜像节点下载速度比命令行拉取快很多。安装完成后点打开第一次启动会做初始化等它解压完提示你输入用户名和密码。用户名随便起小写字母就行密码输入的时候屏幕不显示字符这是正常的输完直接回车再输一遍确认。如果打开时报错提示“WslRegisterDistribution failed”去“启用或关闭 Windows 功能”里确认“适用于 Linux 的 Windows 子系统”和“虚拟机平台”两个勾都打上了然后重启。初始化完成后回到 PowerShell 确认默认版本是 2wsl --set-default-version 2如果这条命令对已装的发行版不生效用下面这条指定版本wsl --set-version Ubuntu-22.04 23.5 验证 WSL2 与 Ubuntu 状态在 PowerShell 里执行wsl -l -v输出应该类似这样NAME STATE VERSION * Ubuntu-22.04 Running 2VERSION 列是 2 就对了。然后进入 WSLwsl进去之后确认系统信息cat /etc/os-release看到Ubuntu 22.04相关的字段就说明环境正常。到这里 WSL2 地基就打好了。3.6 安装 OpenClaw 依赖并启动在 Ubuntu 终端里先更新包索引再装基础依赖sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essential python3 python3-pip这些是 OpenClaw 运行和编译依赖需要的基础包。装完之后拉取 OpenClaw 的安装脚本按官方方式执行。安装完成后OpenClaw 的配置文件一般在用户目录下的.openclaw或者~/.config/openclaw里具体路径看安装脚本的输出提示。启动 OpenClawopenclaw start如果提示命令找不到检查安装脚本有没有把可执行文件加到 PATH 里或者用绝对路径启动。3.7 配置 TaoToken 通道OpenClaw 的模型配置有两种常见格式一种是 JSON 的settings.json一种是 TOML 的config.toml。看你装的那个版本用哪种下面两个骨架都给出。settings.json骨架{ model: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: 你的TaoToken Key, model_name: claude-sonnet-4-20250514 } }config.toml骨架[model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model_name claude-sonnet-4-20250514把api_key换成你在 TaoToken 控制台创建的那串 Keybase_url保持https://taotoken.net/api不变。model_name按你实际要用的模型填具体可用模型列表在 https://taotoken.net/models 里看。注意base_url后面不要加/v1或者其他路径TaoToken 的 API 入口就是https://taotoken.net/api加了多余路径会 404。4. 验证请求与成功结果配置写完之后先别急着跑 OpenClaw 的完整任务用一条最简单的请求确认通道是通的。在 Ubuntu 终端里用 curl 测curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的TaoToken Key \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 ok}] }如果返回的 JSON 里有choices字段并且内容里能看到模型回复的文字说明 Key 和通道都没问题。如果返回 401检查 Key 有没有复制完整返回 404检查 URL 路径返回 429说明额度或者频率限制去控制台看一下。通道验证通过后回到 OpenClaw 启动它openclaw start然后在 OpenClaw 的交互界面里发一条测试消息比如“你好帮我列一下当前目录的文件”。如果它能正常回复并且执行动作说明 OpenClaw 到 TaoToken 的整条链路都通了。成功的结果长这样OpenClaw 启动日志里没有报错模型调用返回正常交互界面能收到回复。如果启动日志里出现connection refused或者invalid api key回到 3.7 检查配置文件的字段名和值。5. 本篇常见错误排查5.1 wsl --install 卡在下载这是最常见的坑。命令行安装默认从境外源拉取发行版网络一波动就卡住。解决办法就是 3.3 里写的先wsl --install --no-distribution只装引擎发行版走应用商店。应用商店有国内镜像速度快很多。5.2 WslRegisterDistribution failed打开 Ubuntu 时报这个错通常是两个 Windows 功能没启用完整。去控制面板的“启用或关闭 Windows 功能”确认“适用于 Linux 的 Windows 子系统”和“虚拟机平台”都勾上然后重启。如果还不行以管理员身份跑bcdedit /set hypervisorlaunchtype auto再重启。5.3 wsl -l -v 显示 VERSION 为 1说明发行版装成了 WSL1。执行wsl --set-version Ubuntu-22.04 2转换。转换过程会花几分钟取决于发行版里已有的数据量。转换完成后再用wsl -l -v确认。5.4 OpenClaw 启动报依赖缺失Ubuntu 里缺 Python 包或者系统库。回到 3.6把build-essential、python3-pip这些装全。如果报的是某个具体的 Python 模块找不到用pip3 install 模块名补上。建议在 Ubuntu 里用虚拟环境跑 OpenClaw避免污染系统 Python。5.5 API 返回 401 或 404401 是 Key 问题检查api_key字段有没有填对Key 有没有过期或者被删。404 是地址问题确认base_url是https://taotoken.net/api没有多余路径。如果用的是config.toml注意 TOML 里字符串要用双引号别用单引号。5.6 WSL 占满 C 盘WSL2 的虚拟磁盘文件默认放在 C 盘用久了会越来越大。可以把发行版迁移到 D 盘先wsl --shutdown停掉然后wsl --export Ubuntu-22.04 D:\ubuntu-backup.tar导出再wsl --unregister Ubuntu-22.04注销最后wsl --import Ubuntu-22.04 D:\WSL\Ubuntu-22.04 D:\ubuntu-backup.tar --version 2导入到 D 盘。导入后用wsl -l -v确认状态正常。6. 后续接入与长期使用建议环境跑通之后如果你只是偶尔用 OpenClaw 跑几个任务当前的配置就够了。但如果你打算长期用它做编码辅助或者跑 Agent 流程建议把 Key 的管理和额度监控做起来。TaoToken 控制台里能看到每个 Key 的调用量和剩余额度定期看一下避免跑到一半额度没了。接入文档在 https://taotoken.net/doc 里面有不同客户端的配置示例和常见问题。如果你在 OpenClaw 里遇到模型调用相关的报错先对照文档检查配置字段大部分问题都是字段名或者地址写错导致的。长期编码场景可以看一下 Coding Plan地址是 https://taotoken.net/coding-plan 它针对高频调用做了额度优化。模型对话的测试入口在 https://taotoken.net/models 换模型或者调参数的时候可以在那里先试确认没问题再写进 OpenClaw 配置。最后提醒一点WSL2 里的 Ubuntu 和 Windows 是两套文件系统OpenClaw 的项目文件建议放在 Ubuntu 的家目录里不要放在/mnt/c下面。跨文件系统访问的性能损耗很大跑起来会明显变慢。把项目放在~/projects这类 Linux 原生路径下读写速度正常OpenClaw 的文件操作也不会卡。