Windows (WSL2) 搭建 openclaw

2026-05-06阅读 0热度 0

运维

Windows (WSL2) 搭建 OpenClaw

想在 Windows 上鼓捣 OpenClaw？官方首推的路子，其实是借助 WSL2（建议用 Ubuntu 发行版）。这么做的道理很简单：把 OpenClaw 的 CLI（命令行工具）和网关都跑在 Linux 环境里，能最大程度确保运行环境的一致性。甭管是 Node/Bun/pnpm 这些工具链，还是 Linux 的原生二进制文件，乃至各种技能包，兼容性问题都能少一大半。相比之下，要在 Windows 原生环境下从头配置，那个复杂度可就上来了，坑也多。而 WSL2 几乎给了你一个完整的 Linux 使用体验，安装起来往往就是一条命令的事儿：wsl --install。

环境安装

首先，咱们需要把 WSL2 和 Ubuntu 给装起来。以管理员身份打开 PowerShell，执行下面这组命令：

# 启用 WSL 和虚拟机平台（懒人一站式安装）
wsl --install

# 如果你想安装特定版本的 Ubuntu（上面和下面这两条命令，二选一即可）
wsl --list --online
wsl --install -d Ubuntu-24.04

安装完成后，继续在管理员 PowerShell 里，输入以下命令来启动 Ubuntu：

# 启动 Ubuntu
ubuntu

首次启动 Ubuntu，系统会提示你设置一个非 root 的用户名和密码，这个可得记牢了。

接下来，是优化 WSL2 环境和为后续步骤打基础。进入 Ubuntu 终端，依次执行：

# 更新系统包索引并升级现有软件
sudo apt update && sudo apt upgrade -y

# 安装一些后续会用到的基礎工具
sudo apt install -y wget curl vim

OpenClaw 网关的安装需要 systemd 支持，而 WSL2 默认没启用它。我们需要手动开启：

# 先创建配置文件，启用 systemd。执行前可以看看文件内容是不是符合要求
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

配置完后，需要重启 WSL 使其生效。回到刚才的 PowerShell 窗口，执行关闭命令：

wsl --shutdown

然后重新打开你的 Ubuntu。再次进入终端后，可以验证一下 systemd 是否已经正常运行：

systemctl --user status

编译安装 OpenClaw 原生环境

基础环境搞定，现在开始准备 OpenClaw 本身。回到 Ubuntu 终端，我们先找个地方存放源码并拉取项目：

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

注意，从 GitHub 克隆仓库这一步，如果网络不通畅可能需要配置代理。此外，确保宿主机的 Windows 防火墙没有阻拦相关连接。

最后，进入项目目录，开始安装和构建 OpenClaw（这一切都在 WSL 内的 Ubuntu 中进行）：

cd openclaw
pnpm install
pnpm ui:build # 首次运行会自动安装 UI 依赖
pnpm build
# 运行以下命令来初始化并启动 openclaw
openclaw onboard

如果在安装过程中遇到任何报错，最直接的办法就是：把错误信息截图，然后去问问社区的伙伴或者像“豆包”这样的AI助手，通常能很快找到解决方案。

Windows (WSL2) 搭建 openclaw