在 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 子系统”# 按 Win X → 选择 终端(管理员) 或 Windows PowerShell(管理员)在弹出的管理员窗口中执行 Set-Location D:\Your\Pathdism.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 # 以下命令有结果则安装成功 wsl --version2. 下载并安装 Ubuntu 22.04继续在刚才的 PowerShell 窗口中下载 Ubuntu 22.04 的安装包并手动安装这种方式网络更稳定# 下载 Ubuntu 22.04 安装包 Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile Ubuntu2204.AppxBundle -UseBasicParsing # 执行安装 Add-AppxPackage .\Ubuntu2204.AppxBundle3. 初始化 Ubuntu安装完成后点击 Windows 的开始菜单找到刚刚安装的Ubuntu图标并打开。系统会进行几分钟的初始化随后会要求你设置 Linux 系统的用户名和密码。 提示为了本地测试方便本教程中我们设置用户名为root密码为1234。注意在输入密码时屏幕上不会显示任何字符这是 Linux 的安全机制盲敲后回车即可。**阶段二关键配置 —— 启用 SystemdOpenClaw 及其依赖的某些后台服务需要systemd的支持。WSL2 默认不开启此功能我们需要手动配置。1. 修改 WSL 配置文件在 Ubuntu 终端中输入以下命令修改/etc/wsl.conf文件以启用 systemd初始化系统守护进程sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue EOF2. 重启 WSL 应用配置回到 Windows 的PowerShell管理员窗口彻底关闭 WSL 以便让配置生效wsl --shutdown # 查看已安装的系统 wsl -l -v3. 验证 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 -v2. 配置包管理器 pnpm现代 Node.js 推荐使用corepack来管理包管理器。我们将使用它来激活pnpm# 启用 corepackNode 自带的包管理器管理器 sudo corepack enable # 激活最新版 pnpm corepack prepare pnpmlatest --activate # 验证 pnpm 版本 pnpm -v阶段四安装与启动 OpenClaw环境准备就绪重头戏来了1. 一键安装 OpenClaw在 Ubuntu 中运行官方的安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后刷新环境变量以激活openclaw命令source ~/.bashrc2. 开启守护进程 (Daemon)执行以下命令让 OpenClaw 在后台驻留运行openclaw onboard --install-daemon3. 访问 Web 控制台OpenClaw 启动后会生成一个网关 token。你可以在 Ubuntu 的openclaw.json文件中找到它。在 Windows 的浏览器中输入带有 token 的本地地址即可访问请替换为你自己的 tokenhttp://127.0.0.1:18789/#token7fa931c43a89f43173064f44a73f39305c6422c86cb51546 附加小技巧在 Windows 中访问 WSL 文件很多时候我们需要在 Windows 资源管理器中直接查看或修改 Ubuntu 里的文件。你只需要在 Windows 的任意文件夹地址栏中输入\\wsl$\Ubuntu按下回车你就能像访问本地普通文件夹一样直接管理 Ubuntu 的根目录/了极其方便。其他的wsl -d 发行版 -- bash # 启动操作系统总结通过以上四个阶段我们成功在 Windows 上利用 WSL2 搭建了完美的 OpenClaw 运行环境。这种方式不仅比虚拟机轻量还能无缝利用 Windows 的各种开发工具如 VS Code进行后续开发。赶紧动手试试吧
在 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 子系统”# 按 Win X → 选择 终端(管理员) 或 Windows PowerShell(管理员)在弹出的管理员窗口中执行 Set-Location D:\Your\Pathdism.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 # 以下命令有结果则安装成功 wsl --version2. 下载并安装 Ubuntu 22.04继续在刚才的 PowerShell 窗口中下载 Ubuntu 22.04 的安装包并手动安装这种方式网络更稳定# 下载 Ubuntu 22.04 安装包 Invoke-WebRequest -Uri https://aka.ms/wslubuntu2204 -OutFile Ubuntu2204.AppxBundle -UseBasicParsing # 执行安装 Add-AppxPackage .\Ubuntu2204.AppxBundle3. 初始化 Ubuntu安装完成后点击 Windows 的开始菜单找到刚刚安装的Ubuntu图标并打开。系统会进行几分钟的初始化随后会要求你设置 Linux 系统的用户名和密码。 提示为了本地测试方便本教程中我们设置用户名为root密码为1234。注意在输入密码时屏幕上不会显示任何字符这是 Linux 的安全机制盲敲后回车即可。**阶段二关键配置 —— 启用 SystemdOpenClaw 及其依赖的某些后台服务需要systemd的支持。WSL2 默认不开启此功能我们需要手动配置。1. 修改 WSL 配置文件在 Ubuntu 终端中输入以下命令修改/etc/wsl.conf文件以启用 systemd初始化系统守护进程sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue EOF2. 重启 WSL 应用配置回到 Windows 的PowerShell管理员窗口彻底关闭 WSL 以便让配置生效wsl --shutdown # 查看已安装的系统 wsl -l -v3. 验证 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 -v2. 配置包管理器 pnpm现代 Node.js 推荐使用corepack来管理包管理器。我们将使用它来激活pnpm# 启用 corepackNode 自带的包管理器管理器 sudo corepack enable # 激活最新版 pnpm corepack prepare pnpmlatest --activate # 验证 pnpm 版本 pnpm -v阶段四安装与启动 OpenClaw环境准备就绪重头戏来了1. 一键安装 OpenClaw在 Ubuntu 中运行官方的安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后刷新环境变量以激活openclaw命令source ~/.bashrc2. 开启守护进程 (Daemon)执行以下命令让 OpenClaw 在后台驻留运行openclaw onboard --install-daemon3. 访问 Web 控制台OpenClaw 启动后会生成一个网关 token。你可以在 Ubuntu 的openclaw.json文件中找到它。在 Windows 的浏览器中输入带有 token 的本地地址即可访问请替换为你自己的 tokenhttp://127.0.0.1:18789/#token7fa931c43a89f43173064f44a73f39305c6422c86cb51546 附加小技巧在 Windows 中访问 WSL 文件很多时候我们需要在 Windows 资源管理器中直接查看或修改 Ubuntu 里的文件。你只需要在 Windows 的任意文件夹地址栏中输入\\wsl$\Ubuntu按下回车你就能像访问本地普通文件夹一样直接管理 Ubuntu 的根目录/了极其方便。其他的wsl -d 发行版 -- bash # 启动操作系统总结通过以上四个阶段我们成功在 Windows 上利用 WSL2 搭建了完美的 OpenClaw 运行环境。这种方式不仅比虚拟机轻量还能无缝利用 Windows 的各种开发工具如 VS Code进行后续开发。赶紧动手试试吧
