⚠️ 安全提醒

与 Mac 版相同，OpenClaw 具备系统级操作权限，不建议在主力机部署。建议使用备用机、虚拟机或 WSL2 隔离环境。

Windows稍微比苹果电脑麻烦点，但是也按着操作就行了，基本也就是复制黏贴的事情。

第一步：安装 WSL2

以管理员身份打开 PowerShell（Win+X → Windows PowerShell 管理员），执行：

powershell

一键安装 WSL2 + Ubuntu

安装完成后重启电脑。

第二步：首次启动 Ubuntu

重启后，在开始菜单打开Ubuntu

等待初始化完成，设置：

⚠️ 关键：WSL2 中的项目文件必须放在 Linux 文件系统内（如 /home/你的用户名/），不要放在 /mnt/c/下，否则性能极差。

第三步：启用 systemd（必需）

bash

编辑 WSL 配置文件

写入以下内容：

ini

保存：Ctrl+O→ 回车 →Ctrl+X

回到Windows PowerShell执行：

powershell

重新打开 Ubuntu 使配置生效。

第四步：更新系统

bash

安装必要工具：

bash

第五步：安装 Node.js 22

bash

安装 nvm

重新加载配置

安装 Node.js 22

验证

应显示 v22.x.x

💡 国内用户可选：配置 npm 镜像加速

bash

npm config set registry https://registry.npmmirror.com/

第六步：安装 OpenClaw

bash

安装完成后，重新加载环境变量：

bash

第七步：初始化配置

bash

向导选项与 Windows/Mac 版相同：

AI 模型：选择你有的 API Key（如 Moonshot AI、Qwen 或 Claude）

聊天渠道：可暂时跳过

Skills：建议选择Yes

⚠️ 注意：若执行 openclaw命令提示找不到，执行：

bash

exportPATH="$(npm prefix -g)/bin:$PATH"

echo'export PATH="$(npm prefix -g)/bin:$PATH"'>> ~/.bashrc

source ~/.bashrc

第八步：启动并验证

bash

启动 Gateway

检查状态

打开 Web 控制台

浏览器会自动打开http://127.0.0.1:18789。

第九步（可选）：开机自启

让 OpenClaw 在 Windows 开机时自动运行：

bash

然后在Windows 管理员 PowerShell中创建计划任务，或使用 Windows Terminal 的“启动时打开 WSL”功能。

关键注意事项

与原生 Windows 版的差异

常见问题

1.openclaw: command not found

bash

检查是否安装

修复 PATH

2. Gateway 无法启动/服务装不上

确认 systemd 已启用：

bash

不应报错

3. 安装脚本卡住

国内网络问题，配置 npm 镜像后重试，或使用代理。