教程 · 部署
Windows 用 WSL 跑 OpenClaw 的干净装法
同一套龙虾装法，在 macOS 和 Linux 上往往一路绿灯，到了 Windows 原生环境就开始报红：某个依赖现场编译失败、路径反斜杠对不上、权限不够。与其在 PowerShell 里硬刚这些坑，不如换条路——开 WSL2，在 Windows 里直接跑一个真正的 Ubuntu，网上所有 Linux 教程原样照抄即可。这篇按装 WSL2、配 Ubuntu 环境、装龙虾、两边文件互通的顺序走。
为什么走 WSL，而不是硬装 PowerShell
PowerShell 当然也能装，但 Windows 原生环境有两个老大难：
- 编译依赖：有些 Python 包要现场编译，缺编译工具链就报一长串红字，新手很难排。
- 路径和权限：反斜杠、权限模型跟 Linux 不一样，很多项目脚本默认按 Linux 写，搬到 Windows 就水土不服。
WSL2 直接给你一个完整 Linux，这两个问题都不存在。你只要会照抄 Linux 命令就行。它本质上是 Windows 里跑的一个轻量虚拟机，但用起来不像虚拟机那么笨重——没有单独的窗口、不用来回切系统，一个终端就进去了，文件还能和 Windows 互通。对装龙虾这种“一堆 Linux 风格脚本和依赖”的活儿来说，这是目前 Windows 上最省心的环境。
第一步：装 WSL2
以管理员身份打开 PowerShell，一条命令装好（现在的 Windows 这条会自动装好 WSL2 内核加一个 Ubuntu）：
wsl --install装完重启电脑。重启后会自动弹出 Ubuntu 的初始化，让你设一个用户名和密码——这是 Linux 里的账号，记牢，后面 sudo 要用。设完你就进到了一个 Ubuntu 终端。
想确认装的是 WSL2（不是老的 WSL1），回 PowerShell 查一下：
wsl -l -vVERSION 那列是 2 就对了。是 1 的话用 wsl --set-version Ubuntu 2 升上去。
第二步：在 Ubuntu 里配环境
从这里开始，所有命令都在 WSL 的 Ubuntu 终端里敲，跟在真 Linux 上一模一样。先更新、再装龙虾要的东西：
sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-venv python3-pip nodejs npm git查一下版本，有输出就齐了：
python3 --version
node --version
git --version第三步：把龙虾装进 WSL 的 Linux 目录
这里有个性能讲究：项目代码要放在 WSL 自己的 Linux 目录里（比如你的家目录），别放在 /mnt/c 下的 Windows 盘里。放 Windows 盘会因为跨系统访问慢很多。先进家目录再拉源码：
cd ~
git clone https://github.com/<openclaw-repo>.git
cd openclaw
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt接大脑（新手走云端 API）：
cp .env.example .env
# 用编辑器打开 .env，填 MODEL_PROVIDER / MODEL_NAME / API_KEY然后启动，跑一条最小任务验证：
python main.py
# 起来后给它一句：在当前目录建 hello.txt 写一行字再读回来它真的建了文件、写了字、又读回来念给你听，就说明模型连通、工具调用、循环执行三件事都通了，剩下就是堆更复杂的任务。到这一步，你在 Windows 上其实已经拥有了一个跟 Linux 上一模一样的龙虾环境，后面所有 Linux 教程都能直接照抄，不用再为系统差异操心。
第四步：和 Windows 文件互通的坑
WSL 和 Windows 不是两台隔离的电脑，文件可以互访，但有讲究：
- WSL 访问 Windows 文件：你的 C 盘、D 盘在 WSL 里挂在
/mnt/c、/mnt/d。想让龙虾处理桌面上某个文件夹，路径就写成/mnt/c/Users/你的名字/Desktop/...。 - Windows 访问 WSL 文件：在 Windows 文件资源管理器地址栏输入
\\wsl$就能进到 WSL 的文件系统，把里面的文件拖出来。 - 性能提醒：跨系统读写（走 /mnt）明显慢，所以代码放 WSL 内部、只有要处理的数据才走 /mnt。
wsl --install 中间会重启一次，进 Ubuntu 后再 apt 装齐 Python/Node/Git、拉源码装依赖，时间大头都在下载上，耐心等就好。这里有一条很值得记的坑：代码和经常读写的数据，尽量放在 WSL 自己的家目录里，别放 Windows 盘（/mnt/c 下）。跨 /mnt/c 访问要走一层文件系统转换，处理大文件时会慢不少；同一份数据放 WSL 家目录里处理，往往能快出一大截。
常见问题
- 为什么 Windows 不直接用 PowerShell 装，要绕 WSL？
- PowerShell 也能装，但原生环境容易卡在编译依赖和路径/权限上，很多项目脚本是 Linux 写法。WSL2 给你一个真 Linux 环境，Linux 教程原样照抄，踩坑概率大幅下降。
- WSL 里跑的龙虾能访问我 Windows 上的文件吗？
- 能。Windows 盘挂在 /mnt/c、/mnt/d 下，按这个路径就能读写。但跨系统访问比 WSL 自己的目录慢，所以代码放 WSL 内部，只有要处理的数据才走 /mnt。
- WSL 会不会很占内存、拖慢电脑？
- WSL2 是轻量虚拟机，按需分配、不用时基本休眠。只跑龙虾走 API 占用很小。真正吃内存的是在 WSL 里本地跑大模型，那是模型的事，跟 WSL 本身无关。