WSL2 环境下的 OpenClaw 部署指南
在 Windows 系统上运行 Linux 原生的 Node.js 服务，WSL2（Windows Subsystem for Linux 2）是目前最平衡的选择。本文介绍如何在 WSL2 中从零搭建并运行 OpenClaw AI 助手。
为什么选择 WSL2？
相比 Docker Desktop 或 PowerShell 原生环境，WSL2 具有显著优势：
- 兼容性：OpenClaw 依赖的 Node.js、pnpm 等工具链源自 Linux 生态，WSL2 提供近乎 100% 的兼容。
- 性能：基于真实 Linux 内核，文件 I/O 和系统调用效率远高于 WSL1。
- 互通性：Windows 资源管理器可直接访问 WSL2 文件，网络端口也能无缝映射到浏览器。
| 方案 | 优点 | 缺点 | 建议 |
|---|---|---|---|
| Docker Desktop | 环境隔离好 | 资源占用高，配置复杂 | 适合熟悉 Docker 的用户 |
| PowerShell 原生 | 无需额外环境 | 兼容性问题多 | 不推荐 |
| WSL2 | 官方推荐，性能佳 | 需启用虚拟机平台 | 首选方案 |
第一步：安装 WSL2 与 Ubuntu
确保您的系统满足以下要求：
- 操作系统：Windows 10 版本 2004+ (内部版本 19041) 或 Windows 11。
- 虚拟化：BIOS/UEFI 中已开启，任务管理器'性能'->'CPU'可查看状态。
一键安装
以管理员身份打开 PowerShell，执行以下命令：
wsl --install
该命令会自动启用子系统功能、下载最新内核并安装默认发行版 Ubuntu。完成后重启计算机。
首次启动时，系统会提示创建 UNIX 用户名和密码。注意密码输入时不会显示字符，这是正常的安全机制。
如果自动安装失败，可参考微软官方文档进行手动安装或从应用商店搜索 Ubuntu。
第二步：配置 Node.js 环境
OpenClaw 要求 Node.js 版本 >= 22。推荐使用 nvm 管理版本。
-
安装 nvm 在 Ubuntu 终端中运行：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash -
激活 nvm 关闭当前终端重新打开，或执行：
source ~/.bashrc -
安装 Node.js 22
