在 Windows 上部署龙虾OpenClaw：基于 WSL2 的详细教程

在 Windows 上部署龙虾 OpenClaw：基于 WSL2 的详细教程

想要在 Windows 环境下体验 OpenClaw，但又不想折腾复杂的虚拟机？利用 Windows Subsystem for Linux (WSL2) 是目前最优雅、最高效的解决方案。

本文将手把手教你如何从零开始，在 Windows 系统中通过 WSL2 安装 Ubuntu，并完成 OpenClaw 的部署与运行。全文包含详细的代码说明，小白也能轻松上手！

特别提醒：OpenClaw权限较大，谨慎使用，建议在独立的电脑上使用。

前提

系统	版本要求	内部版本号
Windows 11	任何版本均可	自带 WSL2 支持（推荐）
Windows 10 (x64)	版本 1903 或更高	内部版本 18362.1049 或更高
Windows 10 (ARM64)	版本 2004 或更高	内部版本 19041 或更高

阶段一：准备 WSL2 与 Ubuntu 系统

首先，我们需要在 Windows 上准备好一个纯净的 Linux 环境。

1. 更新 WSL2 组件

以管理员身份打开 PowerShell，启用"适用于 Linux 的 Windows 子系统"

复制代码

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

执行以下命令更新 WSL，确保我们使用的是最新版本：

复制代码

# 更新wsl2
wsl --update --web-download

2. 下载并安装 Ubuntu 22.04

继续在刚才的 PowerShell 窗口中，下载 Ubuntu 22.04 的安装包并手动安装（这种方式网络更稳定）：

复制代码

# 下载 Ubuntu 22.04 安装包
Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile Ubuntu2204.AppxBundle -UseBasicParsing

# 执行安装
Add-AppxPackage .\Ubuntu2204.AppxBundle

3. 初始化 Ubuntu

安装完成后，点击 Windows 的开始菜单 ，找到刚刚安装的 Ubuntu 图标并打开。

系统会进行几分钟的初始化，随后会要求你设置 Linux 系统的用户名和密码。

💡 提示 ：为了本地测试方便，本教程中我们设置用户名为 root，密码为 1234。（注意：在输入密码时，屏幕上不会显示任何字符，这是 Linux 的安全机制，盲敲后回车即可）。

阶段二：关键配置 ------ 启用 Systemd

OpenClaw 及其依赖的某些后台服务需要 systemd 的支持。WSL2 默认不开启此功能，我们需要手动配置。

1. 修改 WSL 配置文件

在 Ubuntu 终端中，输入以下命令修改 /etc/wsl.conf 文件以启用 systemd：

复制代码

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

2. 重启 WSL 应用配置

回到 Windows 的 PowerShell（管理员） 窗口，彻底关闭 WSL 以便让配置生效：

复制代码

wsl --shutdown

3. 验证 Systemd 状态

重新从开始菜单打开 Ubuntu，输入以下命令查看 systemd 是否正常运行：

复制代码

systemctl --user status

如果看到绿色的 running 或类似正常状态的输出，说明配置成功！

阶段三：配置基础运行环境

OpenClaw 依赖 Node.js 环境，接下来我们在 Ubuntu 中安装相关的依赖。

1. 安装 Node.js 22.x

依次在 Ubuntu 终端中执行以下命令，安装基础工具 curl 以及 Node.js 22 版本：

复制代码

# 1. 安装 curl（如果没有）
sudo apt update
sudo apt install -y curl

# 2. 添加 NodeSource 官方源（Node.js 22.x）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -

# 3. 安装 Node.js 22
sudo apt install -y nodejs

# 4. 验证版本是否安装成功
node -v

2. 配置包管理器 pnpm

现代 Node.js 推荐使用 corepack 来管理包管理器。我们将使用它来激活 pnpm：

复制代码

# 启用 corepack（Node 自带的包管理器管理器）
sudo corepack enable

# 激活最新版 pnpm
corepack prepare pnpm@latest --activate

# 验证 pnpm 版本
pnpm -v

阶段四：安装与启动 OpenClaw

环境准备就绪，重头戏来了！

1. 一键安装 OpenClaw

在 Ubuntu 中运行官方的安装脚本：

复制代码

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

安装完成后，刷新环境变量以激活 openclaw 命令：

复制代码

source ~/.bashrc

2. 开启守护进程 (Daemon)

执行以下命令，让 OpenClaw 在后台驻留运行：

复制代码

openclaw onboard --install-daemon

3. 访问 Web 控制台

OpenClaw 启动后，会生成一个网关 token。你可以在 Ubuntu 的 openclaw.json 文件中找到它。

在 Windows 的浏览器中，输入带有 token 的本地地址即可访问（请替换为你自己的 token）：

http://127.0.0.1:18789/#token=7fa931c43a89f43173064f44a73f39305c6422c86cb51546

🎁 附加小技巧：在 Windows 中访问 WSL 文件

很多时候我们需要在 Windows 资源管理器中直接查看或修改 Ubuntu 里的文件。你只需要在 Windows 的任意文件夹地址栏中输入：

复制代码

\\wsl$\Ubuntu

按下回车，你就能像访问本地普通文件夹一样，直接管理 Ubuntu 的根目录（/）了！极其方便。

总结

通过以上四个阶段，我们成功在 Windows 上利用 WSL2 搭建了完美的 OpenClaw 运行环境。这种方式不仅比虚拟机轻量，还能无缝利用 Windows 的各种开发工具（如 VS Code）进行后续开发。赶紧动手试试吧！

在 Windows 上部署 龙虾OpenClaw：基于 WSL2 的详细教程