OpenClaw 本地部署指南:WSL2 + Ubuntu + Node.js 22+ 环境搭建
1. 开启 WSL2 与虚拟机平台
Windows 11 或 Windows 10 22H2 及以上版本可直接在管理员模式的 PowerShell 中执行以下命令,自动开启 WSL2、虚拟机平台并下载安装 Ubuntu 22.04 LTS:
wsl --install
旧版本 Windows 10(如 21H2)需先手动更新 KB5004296 补丁,然后分两步开启:
- 开启 WSL:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart - 开启虚拟机平台:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑后,前往微软商店下载 Ubuntu 22.04 LTS 或 24.04 LTS(推荐 22.04)。
2. 配置 Ubuntu 环境
首次打开 Ubuntu 时设置用户名和密码。建议更换国内源以提升下载速度。
- 备份原源文件:
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak - 编辑源文件(以 nano 为例):
清空内容并替换为清华源 Ubuntu 22.04 LTS 内容,保存退出(Ctrl+O, Ctrl+X)。sudo nano /etc/apt/sources.list - 更新密钥与软件列表:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32 sudo apt update && sudo apt upgrade -y
3. 安装 Node.js 22+
使用 nvm 管理 Node.js 版本,避免 apt 源版本过低。
- 安装 nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash - 使配置生效:
source ~/.bashrc - 安装并切换至 Node.js 22:
nvm install 22 nvm use 22 node --version npm --version
4. 安装 Docker Desktop
OpenClaw 单节点集群基于 Docker Compose 部署,需安装 Docker Desktop for Windows 并启用 WSL2 后端。
- 下载 Windows 安装包并勾选'Use WSL 2 based engine'。
- 重启电脑后打开 Docker Desktop,设置资源限制(如 2 核 CPU、4G 内存)。
- 在 Settings > Resources > WSL Integration 中启用 Ubuntu 集成,点击 Apply & Restart。
- 验证安装:


