Windows (WSL2) 搭建 openclaw

feichang_notlike32026-02-15 20:26

这里写自定义目录标题

[Windows (WSL2) 搭建 OpenClaw](#Windows (WSL2) 搭建 OpenClaw)
- 环境安装
- [编译安装 OpenClaw 原生环境](#编译安装 OpenClaw 原生环境)

Windows (WSL2) 搭建 OpenClaw

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

环境安装

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

bash 复制代码

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

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

bash 复制代码

# 启动Ubuntu
ubuntu

首次启动 Ubuntu，设置非 root 用户名和密码（需牢记）。

优化 WSL2 网络 / 更新源

进入 Ubuntu 终端，执行：

bash 复制代码

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

启用 systemd（网关安装需要）

bash 复制代码

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

然后从 PowerShell 中：

bash 复制代码

wsl --shutdown

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

bash 复制代码

systemctl --user status

编译安装 OpenClaw 原生环境

进入 Ubuntu 终端，下载 OpenClaw 源码

bash 复制代码

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

这里下载需要梯子

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

安装 OpenClaw（在 WSL 内）

bash 复制代码

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

安装报错直接截图问豆包