通过 WSL2 在 Windows 上运行 OpenClaw。从启用 WSL2、安装 Ubuntu 到配置运行环境，一步步带你完成部署。
OpenClaw（小龙虾）不支持在原生 Windows 上直接运行，需要通过 WSL2（Windows Subsystem for Linux 2）来运行。WSL2 是微软官方提供的 Linux 子系统，性能接近原生 Linux，安装简单——一条命令即可开启。很多 Windows 用户第一次接触 WSL2 觉得有门槛，但其实只要跟着步骤走，20 分钟就能搞定。
以管理员身份打开 PowerShell（右键开始菜单 → Windows Terminal (管理员)，或搜索 PowerShell 后右键选择「以管理员身份运行」），运行以下命令：
wsl --install
此命令会自动启用 WSL2 所需的 Windows 功能，并安装默认的 Ubuntu 发行版。安装完成后需要重启电脑。
重启电脑后，在 PowerShell 中验证 WSL 版本：
wsl -l -v
确认 Ubuntu 的 VERSION 列显示为 2。如果显示 1，运行以下命令升级到 WSL2：
wsl --set-version Ubuntu 2
打开 Ubuntu 终端（从开始菜单搜索 Ubuntu）。以下所有命令都在 WSL2 Ubuntu 环境中运行。先更新系统包，然后安装 Node.js 22：
# 更新系统包 sudo apt update && sudo apt upgrade -y # 通过 NodeSource 安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs
验证安装是否成功：
node --version\nnpm --version
确保 Git 已安装（Ubuntu 通常自带），然后克隆 OpenClaw 仓库并安装依赖：
# 安装 Git（如果没有的话） sudo apt install -y git # 克隆 OpenClaw git clone https://github.com/openclaw/openclaw.git # 进入项目并安装依赖 cd openclaw && npm install
复制示例配置文件，用 nano 编辑器填入你的 API 密钥（Ctrl+O 保存，Ctrl+X 退出）：
cp .env.example .env\nnano .env
填入你的 API 密钥和访问密码：
# OpenClaw 环境变量配置 OPENAI_API_KEY=sk-your-openai-api-key # ANTHROPIC_API_KEY=sk-ant-your-key # DEEPSEEK_API_KEY=your-deepseek-key DEFAULT_MODEL=gpt-4o ACCESS_CODE=your-secure-password PORT=3210
保存 .env 后启动 OpenClaw：
npm start
启动成功后，在 Windows 浏览器（Chrome、Edge 等）中访问以下地址。WSL2 会自动将端口转发到 Windows 宿主机，无需额外配置：
http://localhost:3210
务必将 OpenClaw 项目放在 WSL2 文件系统中（如 ~/openclaw），不要放在 /mnt/c/ 或 /mnt/d/ 下。跨文件系统访问的 I/O 性能会大幅下降（慢 10 倍以上），npm install 和项目启动都会非常慢。
WSL2 默认会使用较多主机内存。如果你的电脑内存有限（8GB 以下），建议创建 %USERPROFILE%/.wslconfig 文件来限制 WSL2 的内存使用。例如添加 [wsl2] 和 memory=2GB 来限制最大使用 2GB 内存。
强烈推荐安装 VS Code 和其 WSL 扩展。安装后在 Ubuntu 终端中项目目录下运行 code . 即可直接用 VS Code 编辑 WSL2 中的文件，体验与原生 Linux 开发完全一致。
如果你觉得 WSL2 配置太复杂，Docker Desktop for Windows 是更简单的选择（底层也基于 WSL2，但配置全图形化）。安装 Docker Desktop 后直接用 docker-compose 一键启动，无需手动配置 Node.js 环境。