Win 11安装部署OpenClaw教程

文章内容如有错误或排版问题，请提交反馈，非常感谢！

OpenClaw的安装方案

方案一：再Windows中直接安装

在Windows上直接原生安装OpenClaw，最大的优势是入门门槛极低，能让你快速体验。但它的缺点非常突出，官方文档明确指出，原生Windows环境不是一个稳定、完整的生产级方案。

为了让你看得更清楚，我把它和官方推荐的WSL2方案做了个对比：

特性	✅ Windows 原生安装	⭐ WSL2 + Ubuntu (官方推荐)
安装门槛	极低。下载安装包“双击”即可，对新手友好。	较高。需要手动配置WSL2、Ubuntu、systemd等。
核心功能	不完整。 – Memory功能：不稳定或受限 – Skills扩展：依赖Linux环境（如Brew）的技能无法运行	完整。提供完整的Memory、Skills等功能。
后台运行	不完善。依赖Windows任务计划程序或Startup文件夹，可靠性较差。	完善。通过Linux的systemd进行稳定、可靠的服务管理。
稳定性	差。官方明确表示不稳定，不建议用于生产环境。	高。是官方推荐的最稳定方案。
适用场景	临时尝鲜/简单测试。	所有场景，尤其是开发和生产环境。

方案二：WSL2 + Ubuntu（最推荐）

核心优势：

环境隔离：WSL2提供一个独立的完整Linux内核环境，彻底避开Node-gyp、Python编译等依赖与Windows的冲突问题
近乎原生Linux性能：实测性能损耗低于5%，远优于VMware/VirtualBox中CUDA passthrough高达30%以上的性能衰减
生态兼容性：既能享受Linux生态，又能方便地访问Windows文件系统（位于/mnt/c/）
官方推荐路径：OpenClaw社区已验证并提供了大量避坑指南

对于担心的「无图形界面」问题的具体解决：

场景	解决方案	推荐度
浏览器自动化任务（数据采集）	OpenClaw支持 headless: true 无头模式配置	⭐⭐⭐⭐⭐
浏览器调试或有交互需求	Windows自带的Edge/Chrome DevTools Protocol + Remote Debugging	⭐⭐⭐⭐
需要完整图形界面的桌面应用	进阶方案：WSLg或临时切换到Windows端处理	⭐⭐⭐

需要提前避开的坑：

潜在问题	预防性措施
虚拟机动态内存膨胀，长期运行后内存不释放	配置 /etc/wsl.conf 中的 autoMemoryReclaim=yes
WSL2虚拟磁盘（ext4.vhdx）持续膨胀，无法自动收缩	定期执行 wsl –export/wsl –import 清理
Windows更新后WSL2 CUDA失效（如果要用GPU跑大模型）	严格遵循顺序：更新Windows NVIDIA驱动 → 更新WSL2内核 → 重装CUDA
WSL2默认NAT网络模式，宿主机无法直接访问WSL服务	使用 localhost:端口访问WSL2中运行的服务

以上很多属于“长期运行后才会出现的问题”，但如果仅作日常使用且定期关机重启，很多都不用特意处理，了解即可。

方案三：WSLg（WSL GUI的增强版）

方案概述：WSLg是Windows 11原生集成在WSL2之上的图形界面支持层，允许WSL中的Linux图形应用直接在Windows桌面无缝渲染，无需额外配置VcXsrv或Xming X Server。

核心优势：

完美继承了WSL2的全部性能优势（近乎原生Linux性能、CUDA on WSL2、完整Linux内核等）
额外增加了Linux图形应用直接在Windows桌面无缝运行的能力
彻底解决了WSL2无图形界面的限制，满足”需要图形界面操作”的各种场景

可能的坑：

搜索结果中关于WSLg在OpenClaw场景下的具体应用案例有限，说明社区验证尚不充分（多数官方文档仍直接建议标准WSL2 + 无头模式）
若某些图形依赖兼容性不好，可能需要额外调试。

如果你预期未来需要大量操作需要完整桌面GUI（如频繁可视化调试），WSLg是WSL2之后的自然升级方向。

方案四：VMware + Ubuntu

优势：

环境隔离彻底：完全独立的虚拟硬件，Windows再怎么折腾也不会影响虚拟机内的运行环境
快照功能：部署前做快照，失败可以一键回滚，适合反复调试的折腾型部署
无需处理WSL特有的内存/磁盘膨胀问题：虚拟机的资源分配更加可控
NAT网络配置灵活：可以自定义网络，与宿主机互通更容易
Ubuntu Desktop社区更成熟，图形界面相关问题的排查经验更丰富

劣势：

资源占用更多：比WSL2多出1-2GB内存开销（需同时运行虚拟机+Windows宿主机）
性能有损耗：CUDA passthrough配置复杂，GPU性能损耗约30%以上
不建议用大模型推理（如果你要在本地跑7B级别以上的大模型），显存访问延迟高

适用于：纯粹的测试沙箱、轻度使用（不依赖GPU加速的本地大模型推理）、喜欢快照回滚带来的“零成本试错”体验。

OpenClaw的安装与配置

环境准备

确认系统版本：按Win + R，输入 winver，确保系统版本是 Windows 11 22H2 +。
检查虚拟化支持：虚拟化是 WSL2 正常运行的基础。打开任务管理器（Ctrl + Shift + Esc），进入“性能”标签页，在“CPU”部分查看“虚拟化”状态是否为“已启用”。如果显示“已禁用”，需要重启电脑进入BIOS，找到Intel VT-x选项并开启。
开启Windows功能：在Windows搜索栏输入“启用或关闭 Windows 功能”，然后在打开的窗口中，确保Virtual Machine Platform（虚拟机平台）和 Windows Subsystem for Linux（适用于 Linux 的 Windows 子系统）这两项都已勾选。选择后点击确定并重启电脑。

安装WSL2 与 Ubuntu

以管理员身份打开“Windows Terminal”或“PowerShell”：执行 wsl –install -d Ubuntu。安装完成后重启电脑。在 PowerShell 中用 wsl -l -v 命令检查，如果“VERSION”列显示为 2，说明 WSL2 安装成功。

我安装的时候遇到这个错误

Installing, this may take a few minutes...
WslRegisterDistribution failed with error: 0x800701bc
Error: 0x800701bc WSL 2 ?????????????????? https://aka.ms/wsl2kernel

Press any key to continue...

解决方案：访问 https://aka.ms/wsl2kernel，下载对应你系统架构（通常是 x64）的内核更新包。

基础优化

更新系统包：刚安装好的 Ubuntu，记得先更新一下。在 Ubuntu 终端中执行：sudo apt update && sudo apt upgrade -y
分配系统资源：为了让 WSL2 占用的系统资源更合理，可以在 Windows 用户目录（C:\Users\<你的用户名>）下创建一个名为.wslconfig 的文件。用记事本打开，写入以下内容进行配置：

[wsl2]
memory=8GB
processors=8
swap=4GB
localhostForwarding=true
autoMemoryReclaim=gradual

提示：完成此步后，打开 PowerShell 执行 wsl –shutdown 重启 WSL 使配置生效。

修改Ubuntu源

打开Ubuntu确认版本：lsb_release -a

qw@ROG-Strix-6-Plus:~$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description:    Ubuntu 24.04.4 LTS
Release:        24.04
Codename:       nobl

Ubuntu 24.04 开始使用新的 DEB822 格式，配置文件位于 /etc/apt/sources.list.d/ubuntu.sources

备份当前源：sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
编辑当前源：sudo nano /etc/apt/sources.list.d/ubuntu.sources

## See the sources.list(5) manual page for further settings.
Types: deb
URIs: http://archive.ubuntu.com/ubuntu/
Suites: noble noble-updates noble-backports
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

## Ubuntu security updates. Aside from URIs and Suites,
## this should mirror your choices in the previous section.
Types: deb
URIs: http://security.ubuntu.com/ubuntu/
Suites: noble-security
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

一般只要改第一个地址即可，将第一个URL改为：https://mirrors.tuna.tsinghua.edu.cn/ubuntu/。然后再执行更新：sudo apt update

部署核心环境

OpenClaw 的核心环境是 Node.js，这里推荐使用 nvm (Node Version Manager) 来安装，可以方便地管理 Node 版本。

安装 nvm，在 Ubuntu 终端中执行以下命令：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

安装完成后，关闭并重新打开 Ubuntu 终端，或执行 source ~/.bashrc 使其生效。

OpenClaw 需要Node 22.19 或更高版本，官方推荐 Node 24。

nvm install 24
nvm use 24
nvm alias default 24

验证安装：

node --version
npm --version

配置国内镜像源（解决网络问题）

# 设置淘宝镜像源
npm config set registry https://registry.npmmirror.com
# 验证设置
npm config get registry

安装与启动 OpenClaw

安装 OpenClaw

在 Ubuntu 终端中，通过 npm 全局安装 OpenClaw（这里以 openclaw（英文原版）为例）：

npm install -g openclaw@latest

OpenClaw目前没有官方中文版，但国内开发者维护了汉化版（不太建议，就怕后期不维护或更新不及时）。

https://github.com/mf-yang/openclaw-cn
https://github.com/MaoTouHU/OpenClawChinese

启用 systemd 并验证

OpenClaw 的 Gateway 服务依赖于 systemd，我们需要在 WSL2 中手动启用它。

在 Ubuntu 终端中执行以下命令：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

重启 WSL2：在 PowerShell 中执行 wsl –shutdown，然后重新启动 Ubuntu。在 Ubuntu 终端中执行 systemctl –user status，如果看到服务列表输出，说明 systemd 已成功启用。

qw@ROG-Strix-6-Plus:~$ systemctl --user status
Failed to connect to bus: No medium found

如果你遇到和我一样的问题，需要更新WSL：wsl –update

重新执行后：

qw@ROG-Strix-6-Plus:~$ systemctl --user status
● ROG-Strix-6-Plus
    State: running
    Units: 160 loaded (incl. loaded aliases)
     Jobs: 0 queued
   Failed: 0 units
    Since: Wed 2026-06-17 10:28:21 CST; 7min ago
  systemd: 255.4-1ubuntu8.16
   CGroup: /user.slice/user-1000.slice/user@1000.service
           └─init.scope
             ├─482 /usr/lib/systemd/systemd --user
             └─483 "(sd-pam)"

初始化配置向导

OpenClaw 提供了一个交互式的配置向导，它会引导你完成初始设置。

# 运行安装向导

openclaw onboard –install-daemon

启动 Gateway 服务

为了让 OpenClaw 在后台持续运行，强烈建议将它安装为系统服务。

安装 Gateway 服务：openclaw gateway install

启动服务并检查状态：openclaw gateway start

openclaw status

Gateway 默认会在 http://localhost:18789 上启动服务。此网关需要身份验证。添加令牌或密码，然后点击连接。

openclaw dashboard –no-open → 生成带令牌的URL

有可能生成的链接没有带token，可以使用以下命令生成token：

openclaw doctor –generate-gateway-token

如果不想每次都通过doctor命令生成新Token，也可以直接从配置文件获取已配置的Token：

cat ~/.openclaw/openclaw.json | grep -A2 ‘”auth”‘

Win 11安装部署OpenClaw教程

OpenClaw的安装方案

方案一：再Windows中直接安装

方案二：WSL2 + Ubuntu（最推荐）

方案三：WSLg（WSL GUI的增强版）

方案四：VMware + Ubuntu

OpenClaw的安装与配置

环境准备

安装WSL2 与 Ubuntu

部署核心环境

安装与启动 OpenClaw

移动端自动化测试工具Appium

下一代Python包管理器uv

Python地理空间数据可视化利器：Cartopy

发表回复取消回复

Win 11安装部署OpenClaw教程

OpenClaw的安装方案

方案一：再Windows中直接安装

方案二：WSL2 + Ubuntu（最推荐）

方案三：WSLg（WSL GUI的增强版）

方案四：VMware + Ubuntu

OpenClaw的安装与配置

环境准备

安装WSL2 与 Ubuntu

部署核心环境

安装与启动 OpenClaw

移动端自动化测试工具Appium

下一代Python包管理器uv

Python地理空间数据可视化利器：Cartopy

发表回复 取消回复

发表回复取消回复