介绍在 Windows 环境下通过 WSL2 部署 OpenClaw AI 助手的完整流程。主要步骤包括安装并配置 WSL2 Ubuntu 环境，使用 nvm 安装 Node.js 22+ 版本，通过脚本或 npm 安装 OpenClaw，配置 AI 模型 API 密钥，最后启动网关服务并通过浏览器访问 Web 控制台。该方案解决了 Windows 原生部署的环境兼容性问题，适合本地开发和学习 Agent 开发。
第一部分：认识 WSL2—— Windows 中的 Linux 环境
WSL2 (Windows Subsystem for Linux 2) 是微软官方提供的一项功能，允许您在 Windows 系统内部直接运行一个原生、完整的 Linux 环境。
| 方案 | 优点 | 缺点 | 建议 |
| Docker Desktop | 环境隔离，便于部署迁移。 | 资源占用相对更多，配置稍复杂。 | 可选，适合熟悉 Docker 的用户。 |
| PowerShell 原生 | 无需额外环境。 | 兼容性问题多，易出错，不推荐。 | 不推荐 |
| WSL2 | 官方推荐。兼容性最好，性能佳，与 Windows 无缝集成。 | 需要启用 Windows 功能并安装一个小型虚拟机。 | 首选方案 |
第二部分：详细安装与配置指南
Win + R 输入 winver，查看'版本'信息。
步骤：
以管理员身份打开 PowerShell：
执行一键安装命令：wsl --install
这个命令会：
重启计算机。
初始化 Ubuntu：
请严格遵循微软官方教程：
主安装指南（推荐，含一键安装）：https://learn.microsoft.com/zh-cn/windows/wsl/install
手动安装步骤（适用于旧版或特殊场景）：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual
这是运行 OpenClaw 的核心前提。
OpenClaw 要求 Node.js 版本 >= 22。在 Linux 中，我们通常使用 nvm 来管理 Node.js 版本。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm --version
如果显示出版本号（例如 0.40.1），则说明安装成功。
5. 使用 nvm 安装 Node.js 22（LTS 版本）：
nvm install 22
这个命令会自动下载并安装 Node.js v22 的最新版本，并配置好 npm。 6. 将刚安装的 Node.js 22 设置为默认版本：
nvm alias default 22
node -v # 应输出 v22.x.x
npm -v # 应输出对应的 npm 版本号
提示：若出现
command not found错误，请确保已执行source ~/.bashrc或完全重启了 Ubuntu 终端。
现在，您的 WSL2 Ubuntu 环境中已经具备了运行 OpenClaw 的条件。以下是几种安装方式：
自动化程度最高，包含交互式配置向导
curl -fsSL https://openclaw.ai/install.sh | bash
执行后，脚本会自动检测环境并引导您完成后续配置。
npm install -g openclaw@latest
openclaw onboard --install-daemon
此方法在 WSL2 中安装 Docker 后使用，能获得最佳的环境隔离性。
docker-compose 启动 OpenClaw。推荐使用 方式 1 或 方式 2。
无论通过哪种方式安装，最终都会进入 OpenClaw 配置向导。
这个向导会像一位助手一样，引导完成最关键的四步：
Yes 继续。Skip 跳过。Skip 跳过，后续在控制台中按需安装。
完成配置后，向导会自动启动 OpenClaw 的核心服务（网关 Gateway）。
当您在终端看到类似以下信息时，说明服务启动成功：
OpenClaw daemon started successfully! Gateway URL: http://127.0.0.1:18789
可使用以下命令管理服务：
# 启动 OpenClaw 网关服务
openclaw gateway start
# 停止 OpenClaw 网关服务
openclaw gateway stop
# OpenClaw 状态检查
openclaw gateway status
访问您的 OpenClaw 控制台：
openclaw dashboard看到 OpenClaw 的 Web 管理界面，即表示已成功在 WSL2 上部署了自己的 AI 助手服务！
node -v 确认版本 ≥ 22。npm 或一键脚本成功安装 OpenClaw。http://127.0.0.1:18789 访问 OpenClaw 控制台。检查服务状态：openclaw status
本地网页控制台：openclaw dashboard
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online