Win系统部署OpenClaw(WSL2)

2026 年 2 月 27 日 AI
  • OpenClaw是一个能直接操作你的电脑、替你动手完成复杂任务的AI智能体
  • 操作系统：win10 (安装虚拟机WSL2)
  • 国内需要用到科学上网
  • 官方社区指南：https://docs.openclaw.ai/zh-CN
  • 代码后 #表示备注

安装步骤

1. Windows (PowerShell)，鼠标右键左下脚win窗口，以管理员身份打开PowerShell终端，进入终端后copy代码：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
#永久修改当前用户的 PowerShell 安全设置，允许本地脚本运行，但网上下载的脚本需要签名才让运行

2. 在Windows (PowerShell)安装 WSL2：

wsl --install

安装完成后查看当前WSL版本是1还是2，在  PowerShell（管理员） 中运行：

wsl --list --verbose
# 查看当前 Ubuntu 的 WSL 版本

如果 Ubuntu-24.04 对应的版本是 1，请执行以下命令升级到 2：

wsl --set-version Ubuntu-24.04 2
# 等待转换完成,可能需要几分钟

转换完成后重启 WSL 服务，在 PowerShell（管理员）中运行：

wsl --shutdown

如果出现WSL2需要更新其内核组件，就需要手动下载更新：
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

或者在 PowerShell 中运行：

wsl --update
# 自动更新(需要科学上网)

下载安装后重启系统，确保内核组件生效

重启后，以管理员身份打开 PowerShell，再次运行：

wsl --set-version Ubuntu-24.04 2
# 应该转换成功了

验证： 

wsl --list --verbose
#确认版本已变为 2

3. 自动或者手动安装 Ubuntu

【自动】WSL 组件安装后，可以直接用 PowerShell 安装 24.04：(推荐安装高版本的)

wsl --install -d Ubuntu-24.04

【手动】下载并安装 Ubuntu 24.04 LTS（x64，arm64）

https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#downloading-distributions

安装成功后Ubuntu会自动弹出终端，需要设置用户名+密码，其中密码输入时是看不见的，所以回车键后会要求你再输入一遍相同密码验证

4. 更新系统并解决依赖冲突，在Ubuntu终端输入：

sudo apt update && sudo apt upgrade -y

如果中间出现依赖关系损坏，输入：

sudo apt --fix-broken install # 自动修复系统中损坏的依赖关系

等待修复完成，再次运行 sudo apt upgrade -y 确认无错误。

重启 WSL 以确保所有服务（包括 D-Bus）正确启动：

关闭Ubuntu 终端后，在PowerShell（管理员）中运行：

wsl --shutdown

再重新打开 Ubuntu 终端（开始菜单点击 Ubuntu 图标）

5. 安装 Node.js 22.x 及 npm

执行（添加 NodeSource 仓库并安装）：

sudo apt remove nodejs -y
sudo apt autoremove -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证：

node --version # 应输出 v22.x.x
npm --version # 应输出 10.x.x

6.安装 OpenClaw

安装编译工具：

sudo apt update
sudo apt install -y build-essential

设置国内镜像加速：

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

开始安装OpenClaw：

sudo npm install -g openclaw@latest

如果遇到 sudo: npm: command not found，请改用以下命令：

sudo env "PATH=$PATH" npm install -g openclaw@latest

验证是否安装成功：

openclaw --version # 出现类似 🦞 OpenClaw 2026.2.26 (bc50708) 即成功。

7. 配置 OpenClaw

运行配置向导：

openclaw onboard

启动网关（前台运行）

openclaw gateway --verbose #终端开始输出日志，网关运行在 ws://127.0.0.1:18789

8. 连接 Web 控制界面

生成带令牌的 URL 直接访问：

openclaw dashboard --no-open

复制输出的完整 URL（如 http://127.0.0.1:18789/?token=...）粘贴到浏览器地址栏，自动认证。

9. 如果出现URL令牌不是永久的情况，解决方法（可选）

编辑配置文件：

nano ~/.openclaw/openclaw.json

找到 "gateway" 部分，在 "auth" 中添加 "enabled": false：

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
        "enabled": false,
        "mode": "token",
        "token": "你的令牌"
    }
}

保存文件，重启网关，按Ctrl+C停止后,重新运行：

openclaw gateway --verbose

在Ubuntu终端修改文件后：

保存文件：
按键盘组合键 Ctrl + O（字母O，不是数字0）。
屏幕底部会显示 File Name to Write: /home/用户名/.openclaw/openclaw.json，直接按 Enter 确认文件名，文件就会被保存。

退出 nano：
按 Ctrl + X，即可退出编辑器并返回到终端命令行

注意：修改后若网关启动失败，请检查 JSON 格式是否正确（括号、逗号是否多余或缺失）。

10. 结束：

之后Ubuntu终端输入：

openclaw gateway --verbose # 开启openclaw

Share

分类