Windows 10/11 安装 WSL2 + Ubuntu + OpenClaw 完整指南

在 Windows 上折腾 OpenClaw,是不是怕因为安全性问题被人窃取数据隐私?那我们今天就来通过 Windows 下的 WSL2 来安装 OpenClaw,保证数据安全。

这是一份保姆级的「Win10 及以上系统 + WSL2(Ubuntu 22.04)安装 OpenClaw」实战教程。通过 WSL2 的沙盒隔离环境,既能保证你的核心数据安全,又能丝滑运行。

一、先检查保底配置

系统方面,Win10 用户需要确保你的版本在 1903(内部版本 18362)或以上,Win11 任何版本都可以。

系统要求:

  • Windows 10 1903 及以上(内部版本 ≥ 18362)
  • CPU 在主板 BIOS 里开启虚拟化
  • 内存至少 8GB
  • C盘或装 WSL 的盘,至少留出 20GB 空闲空间
  • 正常网络连接

查看 Windows 版本:

打开 PowerShell,输入:

winver

看「操作系统内部版本」。低于 19041 要先升级 Windows。

升级地址:https://www.microsoft.com/zh-cn/software-download/windows10/

二、安装 WSL2(无报错版)

第一步:以管理员身份打开 PowerShell

右键点击「开始」菜单 → 选择「Windows PowerShell (管理员)」

第二步:启用 WSL 功能

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

第三步:重启电脑

shutdown /r 0

第四步:安装 WSL2 内核(必须装!)

下载:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

第五步:设置 WSL2 为默认

wsl --set-default-version 2

第六步:验证安装

wsl --status

应该看到「默认版本: 2」

三、安装 Ubuntu

1. 查看可用发行版本

wsl --list --online

2. 更新 WSL

wsl --update

3. 安装 Ubuntu

wsl --install -d Ubuntu

安装过程会弹出窗口要求设置用户名和密码。

四、Ubuntu 初始化

1. 更新软件包列表

sudo apt update && sudo apt upgrade -y

2. 安装编译工具和基础依赖

sudo apt install -y build-essential cmake git pkg-config libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev libglew-dev libgl1-mesa-dev libenet-dev libtinyxml-dev

五、WSL2 性能优化配置

1. 创建 .wslconfig

在 C:\Users\你的用户名 新建 .wslconfig,内容:

[wsl2]
memory=8GB
processors=8
networkingMode=mirrored
dnsTunneling=true
firewall=true

[experimental]
autoMemoryReclaim=gradual
hostAddressLoopback=true

如果电脑配置比较低,把上面的 8 都改为 4。

2. 开启 systemd

sudo nano /etc/wsl.conf

写入:

[boot]
systemd=true

保存:Ctrl+O → 退出:Ctrl+X

3. 重启 WSL

wsl --shutdown

六、安装 OpenClaw

1. 安装基础工具

sudo apt install git curl python3-pip -y

2. 安装 nvm

mkdir -p ~/.nvm
git clone https://gitee.com/mirrors/nvm.git ~/.nvm
cd ~/.nvm
git checkout v0.40.1
cat >> ~/.bashrc << 'EOF'
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
EOF
source ~/.bashrc

3. 安装 Node.js

nvm install 24
nvm use 24
npm install -g pnpm
node -v

应该输出类似 v24.xx.x

4. 安装 OpenClaw

方法一:换国内镜像安装(推荐)

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

方法二:官方脚本安装

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

5. 确认安装成功

openclaw --version
openclaw onboard --install-daemon

七、访问 OpenClaw

http://localhost:18788

八、完全卸载

卸载 OpenClaw

sudo systemctl stop openclaw
sudo systemctl disable openclaw
rm -rf ~/.openclaw
rm -rf ~/openclaw-cn
npm rm -g openclaw

卸载 WSL2 + Ubuntu

wsl --unregister Ubuntu-22.04
wsl --uninstall

关闭 Windows 功能

dism /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux /norestart
dism /online /disable-feature /featurename:VirtualMachinePlatform /norestart

删除残留文件

Remove-Item -Recurse -Force $env:LOCALAPPDATA\WSL
Remove-Item -Recurse -Force $env:USERPROFILE\.wslconfig

官方工具下载地址

  • Windows Terminal:https://apps.microsoft.com/detail/9n0dx20hk701 或 winget install --id Microsoft.WindowsTerminal -e
  • WSL 官方文档:https://learn.microsoft.com/zh-cn/windows/wsl/install
  • Ubuntu 22.04:https://apps.microsoft.com/detail/9PN20MSR04DW
  • OpenClaw 国内一键脚本:https://open-claw.org.cn/install-cn.sh
  • OpenClaw 中文文档:https://claw-docs.dx3n.cn/

有问题欢迎评论区留言!

发表评论