在 Windows WSL2 中完整部署 OpenClaw

OpenClaw “龙虾”：让AI从“理解”到“执行”的桌面智能体

这款备受关注的AI“宠物” OpenClaw，其核心价值在于将指令执行从云端“对话”落地为本地“操作”。它不仅能处理信息整理、邮件收发、报表生成等办公任务，更重要的是能像真人一样，直接操纵你的电脑软件来完成这些工作。更关键的是，它能完全在本地运行，保障数据私密性，普通Windows电脑即可部署。在Windows上部署OpenClaw，主要有两条技术路径：原生Windows安装或基于WSL2的Linux环境。官方文档明确推荐后者，WSL2方案在兼容性与功能完整性上更为成熟可靠。

选择WSL2模式，本质上是在Windows内核之上建立一个轻量级、无缝的Linux虚拟机环境。这有效规避了原生Windows环境中可能存在的库依赖冲突与运行稳定性问题，确保你获得OpenClaw设计中的所有自动化能力。下面，我们具体演示如何在WSL2环境下，完成一次高效、无差错的OpenClaw部署流程。

部署前，请完成以下四项核心系统检查：

首先，确认你的Windows版本为Windows 10 19041及以上或Windows 11，这是WSL2的硬性要求。
其次，确保当前登录的Windows账户拥有管理员权限，用于执行系统级安装命令。
再次，进入任务管理器，切换至“性能”标签页，在CPU信息部分确认“虚拟化”状态已启用，这是运行虚拟化环境的基础。
最后，保证稳定的网络连接，安装过程需要从GitHub及包管理器下载必要的组件和脚本。

一、配置WSL2与安装Ubuntu发行版

1、以管理员身份启动PowerShell：
在Windows开始菜单上右键单击，选择“Windows PowerShell (管理员)”或“终端(管理员)”。

2、执行WSL2统一安装命令：
在打开的PowerShell窗口中，输入并执行以下命令：

wsl --install

此命令将自动启用“虚拟机平台”和“Windows子系统 for Linux”两项必需功能，并默认安装Ubuntu发行版。

若需指定安装特定版本的Ubuntu（推荐使用最新的长期支持版），可采用分步操作：

# 列出所有可在线安装的Linux发行版
wsl --list --online
# 安装指定版本，例如Ubuntu 24.04 LTS
wsl --install -d Ubuntu-24.04

3、重启操作系统：
安装命令执行完毕后，根据提示完全重启Windows，以确保所有虚拟化组件正确加载。

4、完成Ubuntu初始配置：
系统重启后，通常会自动弹出Ubuntu终端窗口。若未弹出，可从开始菜单手动搜索并启动“Ubuntu”应用。

首次启动会要求创建新的Linux用户名和密码。请注意，密码输入时终端不会回显字符，这是正常的安全设计。请务必牢记此密码，后续的`sudo`提权操作需要用到。建议不要使用“root”作为用户名，该账户为系统保留。

5、验证安装状态：
为确认WSL2及Ubuntu安装正确，可在Ubuntu终端或PowerShell中运行版本检查命令：

wsl -l -v

命令输出应显示你安装的Ubuntu发行版名称，且“VERSION”列标识为“2”，即表示基础环境已就绪。