介绍在 WSL2 环境下从零部署 OpenClaw AI 助手的完整流程，从开启 WSL2、安装 Ubuntu、配置 Node.js 到启动 OpenClaw 控制台，适合本地搭建 AI 助手及学习 Agent 开发。 第一部分：认识 WSL2—— Windows 中的 Linux 环境 WSL2 是什么？ **WSL2 (Windows Subsystem for Linux 2)** 是微…
本文介绍在 WSL2 环境下从零部署 OpenClaw AI 助手的完整流程，从开启 WSL2、安装 Ubuntu、配置 Node.js 到启动 OpenClaw 控制台，适合本地搭建 AI 助手及学习 Agent 开发。
WSL2 (Windows Subsystem for Linux 2) 是微软官方提供的一项功能，允许您在 Windows 系统内部直接运行一个原生、完整的 Linux 环境。
| 方案 | 优点 | 缺点 | 建议 |
| Docker Desktop | 环境隔离，便于部署迁移。 | 资源占用相对更多，配置稍复杂。 | 可选，适合熟悉 Docker 的用户。 |
| PowerShell 原生 | 无需额外环境。 | 兼容性问题多，易出错，不推荐。 | 不推荐 |
| WSL2 | 官方推荐。兼容性最好，性能佳，与 Windows 无缝集成。 | 需要启用 Windows 功能并安装一个小型虚拟机。 | 首选方案 |
Win + R 输入 winver，查看'版本'信息。
步骤：
wsl --install
用户名：推荐使用小写英文，不能包含空格。
密码：输入时屏幕上不会显示任何字符，这是正常的安全措施，输入完毕后按回车确认即可。
恭喜！至此，电脑上已经拥有了一个完整的 Linux 系统。接下来的所有操作，都将在这个 Ubuntu 终端中进行。
请严格遵循微软官方教程：
主安装指南（推荐，含一键安装）：https://learn.microsoft.com/zh-cn/windows/wsl/install
手动安装步骤（适用于旧版或特殊场景）：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual
应用商店搜索【wsl】选择 Ubuntu：https://apps.microsoft.com/search?query=wsl&hl=zh-CN&gl=SG
这是运行 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），则说明安装成功。
nvm install 22
这个命令会自动下载并安装 Node.js v22 的最新版本，并配置好 npm。
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 dashboard
看到 OpenClaw 的 Web 管理界面，就标志着已成功在 WSL2 上部署了自己的 AI 助手服务！
openclaw gateway start
openclaw gateway stop
openclaw gateway status
node -v 确认版本 ≥ 22。npm 或一键脚本成功安装 OpenClaw。http://127.0.0.1:18789 访问 OpenClaw 控制台。检查服务状态：
openclaw status
本地网页控制台：
openclaw dashboard
通过以上步骤，我们已经在 WSL2 环境下成功完成 OpenClaw AI 助手的部署、配置与运行。整个过程简单清晰，适合本地开发、调试与学习使用。
希望本文能为大家在 Windows 环境下体验与部署 AI 助手提供一份实用参考。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online