Windows (WSL2) 搭建 OpenClaw

OpenClaw推荐Windows 上使用 WSL2（推荐使用 Ubuntu）运行 OpenClaw。CLI 和网关运行在 Linux 系统内，这保证了运行时环境的一致性，并使工具（Node/Bun/pnpm、Linux 二进制文件、技能）的兼容性更强。在 Windows 原生环境下安装可能比较复杂。WSL2 提供完整的 Linux 体验——只需一条命令即可完成安装wsl --install

环境安装

1. 以管理员身份打开 PowerShell，执行以下命令：

# 启用 WSL 和虚拟机平台（懒人安装）
wsl --install
# 如果你想安装特定的ubuntu(两个命令二选一)
wsl --list --online
wsl --install -d Ubuntu-24.04

2. 以管理员身份打开 PowerShell，执行以下命令：

# 启动Ubuntu
ubuntu

首次启动 Ubuntu，设置非 root 用户名和密码（需牢记）。
3. 优化 WSL2 网络 / 更新源
进入 Ubuntu 终端，执行：

# 更新系统包索引并升级
sudo apt update && sudo apt upgrade -y
# 安装基础工具
sudo apt install -y wget curl vim

4. 启用 systemd（网关安装需要）

# 先看下文件是否是要求的内容，不是的话修改
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

然后从 PowerShell 中：

wsl --shutdown

重新打开Ubuntu系统，然后进行验证：

systemctl --user status

编译安装 OpenClaw 原生环境

1. 进入 Ubuntu 终端，下载 OpenClaw 源码

mkdir /home/openclaw
cd /home/openclaw
git clone https://github.com/OpenClaw/OpenClaw.git

这里下载需要梯子

• ubuntu设置代理环境变量
• 防火墙关闭

2. 安装 OpenClaw（在 WSL 内）

cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
# 这个是开启openclaw
openclaw onboard

• 安装报错直接截图问豆包