这里写自定义目录标题
- [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
- 安装报错直接截图问豆包