1 安装 WSL
WSL(Windows Subsystem for Linux)是微软官方提供的工具,使得我们能在 Windows 上直接运行 Linux 系统(如 Ubuntu),无需虚拟机或双系统。OpenClaw 不能直接在 Windows 上运行,但通过 WSL 可以完美运行。
1.1 以管理员身份打开 PowerShell
按 Win 键,搜索 PowerShell,右键点击'Windows PowerShell'并选择'以管理员身份运行'。
1.2 执行安装命令
在 PowerShell 中输入以下命令并回车:
wsl --install
系统会自动下载并安装 WSL 2 和 Ubuntu(需能访问 github 环境下载)。
1.3 设置 Ubuntu 用户名和密码
系统提示 Create a default Unix user account: XXX 后按回车键,接着设置密码并再次输入密码以确认密码。
安装完成后记得重启电脑。
2 重启后打开 WSL 终端
之后的所有操作都在 WSL 终端(Ubuntu)中进行。
WSL 终端打开方式:开始菜单搜索 Ubuntu 并打开或在 PowerShell 中输入 wsl 并回车。
打开后会看到类似 user@电脑名:~$ 的提示符。
3 安装 Node.js
在 WSL 终端中依次执行以下命令。
3.1 更新软件包列表
sudo apt update
如果提示输入密码,输入之前设置的 WSL 密码(输入时不可见),按回车即可。
3.3 添加 Node.js 22.x 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
3.4 安装 Node.js
sudo apt install -y nodejs
3.5 验证安装
node --version # 应输出 v22.x.x
4 一键安装 OpenClaw
在 WSL 终端中运行安装脚本:
curl -fsSL https://openclaw.ai/install.sh | bash
等待 2-5 分钟,安装完成后会自动进入配置向导。
若在安装过程中遇到类似下面的错误(sharp 模块安装失败):
npm install failed for openclaw@latest
请按以下步骤手动修复(所有命令仍在 WSL 终端中执行):
4.1 清理 npm 缓存(避免残留文件干扰)
npm cache clean --force
4.2 安装构建工具(node-gyp)
sudo npm install --global npm@latest
npm install --global node-gyp


