介绍如何在 Windows 环境下通过 WSL2 部署 OpenClaw AI 助手。主要步骤包括安装并配置 WSL2 与 Ubuntu 系统，使用 nvm 安装 Node.js 22+ 版本，通过脚本或 npm 安装 OpenClaw 客户端，配置 AI 模型 API 密钥，最后启动服务并通过浏览器访问 Web 控制台进行管理。该方法解决了 Windows 原生部署的兼容性问题，适合本地搭建 AI 助手及学习 Agent 开发。
WSL2 (Windows Subsystem for Linux 2) 是微软官方提供的一项功能，允许您在 Windows 系统内部直接运行一个原生、完整的 Linux 环境。
| 方案 | 优点 | 缺点 | 建议 |
|---|---|---|---|
| Docker Desktop | 环境隔离，便于部署迁移。 | 资源占用相对更多，配置稍复杂。 | 可选，适合熟悉 Docker 的用户。 |
| PowerShell 原生 | 无需额外环境。 | 兼容性问题多，易出错，不推荐。 | 不推荐 |
| WSL2 | 官方推荐。兼容性最好，性能佳，与 Windows 无缝集成。 | 需要启用 Windows 功能并安装一个小型虚拟机。 | 首选方案 |
Win + R 输入 winver，查看'版本'信息。步骤：
以管理员身份打开 PowerShell：
执行一键安装命令：wsl --install
该命令会：
重启计算机。
初始化 Ubuntu：
恭喜！至此，电脑上已经拥有了一个完整的 Linux 系统。接下来的所有操作，都将在这个 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 gateway status 命令展示一下启动成功信息。
访问您的 OpenClaw 控制台：
openclaw dashboardhttp://127.0.0.1:18789看到 OpenClaw 的 Web 管理界面，就标志着已成功在 WSL2 上部署了自己的 AI 助手服务！
常用命令参考：
# 启动 OpenClaw 网关服务
openclaw gateway start
# 停止 OpenClaw 网关服务
openclaw gateway stop
# OpenClaw 状态检查
openclaw gateway status
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
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online