在 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)进行后续开发。赶紧动手试试吧!

相关推荐
tellmewhoisi16 小时前
深度学习0:数学知识:(L1正则化和L2正则化)
人工智能·深度学习
AI_Gump16 小时前
AutoGLM 两年演进深度解读:一篇讲透智谱的手机 Agent 路线
人工智能·智能手机
玄枢AI16 小时前
AI把待办整理成JSON后,用Python检查漏字段、类型错误和未知值
人工智能
VIP_CQCRE16 小时前
GPT Image 2.6 选型别只看首张:用盲评与合格图耗时比较 Flare、Sunburst
软件测试·图像处理·人工智能
程序员cxuan16 小时前
REA 靠边站,逆向圈又一新王诞生了
人工智能·后端·程序员
AI算力16 小时前
企业调研——工业边缘计算隐形黑马,腾视科技以“硬件+算法”加速出海落地!
人工智能·ai·边缘计算·ai算力·无人叉车·物理ai·ainas
Csvn16 小时前
所有问题都喂最贵的模型?规则路由实测:30 个问题里 16 个能交给便宜模型(C03)
人工智能·aigc·agent
Vex2une16 小时前
电脑装双系统怎么弄?Win+Win 与 Win+Linux 安装及启动菜单管理全攻略
linux·windows·电脑·uefi·双系统安装·bcdedit启动项
网易云信16 小时前
再也不用做 AI 的“传话筒”了:拆解云信 SynergyHub 的 Agent 协作工作流
人工智能
真上帝的左手17 小时前
26. AI-Agent-技术架构:Harness、Runtime、Orchestrator、Framework
人工智能·架构·agent·ai编程·智能体