WSL2 从零部署 OpenClaw AI 助手：安装配置指南

2. 一键安装 WSL2 与 Ubuntu（最简单的方法）

步骤：

1. 以管理员身份打开 PowerShell：

   • 点击 Windows '开始'按钮。
   • 搜索 'PowerShell'。
   • 在'Windows PowerShell'应用上右键单击，选择'以管理员身份运行(A)'。

2. 执行一键安装命令：wsl --install

3. 这个命令会：

   • 自动启用'适用于 Linux 的 Windows 子系统'和'虚拟机平台'功能。
   • 下载并安装最新的 WSL2 Linux 内核。
   • 将 WSL2 设置为默认版本。
   • 下载并安装默认的 Linux 发行版——Ubuntu。

4. 重启计算机。

5. 初始化 Ubuntu：

   • 重启后，系统可能会自动弹出一个黑色的 Ubuntu 终端窗口。
   • 如果没有，请点击'开始'菜单，找到并启动新安装的'Ubuntu'应用。
   • 首次启动需要几分钟来解包文件。
   • 完成后，系统会提示您创建一个新的 UNIX 用户名和密码。 用户名：推荐使用小写英文，不能包含空格。 密码：输入时屏幕上不会显示任何字符，这是正常的安全措施，输入完毕后按回车确认即可。

恭喜！至此，电脑上已经拥有了一个完整的 Linux 系统。接下来的所有操作，都将在这个 Ubuntu 终端中进行。

3. 如果'一键安装'失败或想手动控制

请严格遵循微软官方教程：

主安装指南（推荐，含一键安装）：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

阶段二：在 WSL2 的 Ubuntu 中安装 Node.js

这是运行 OpenClaw 的核心前提。

OpenClaw 要求 Node.js 版本 >= 22。在 Linux 中，我们通常使用 nvm 来管理 Node.js 版本。

1. 打开您的 Ubuntu 终端。
2. 安装 nvm 通过 curl 下载并运行 nvm 的安装脚本：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

3. 激活 nvm 关闭当前终端并重新打开一个新的 Ubuntu 终端，或者运行以下命令使 nvm 立即生效：

source ~/.bashrc

4. 验证 nvm 是否安装成功

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

7. 验证 Node.js 和 npm 是否安装正确

node -v # 应输出 v22.x.x
npm -v # 应输出对应的 npm 版本号

提示：如果您看到 command not found 错误，请确保已执行 source ~/.bashrc 或完全重启了 Ubuntu 终端。

阶段三：安装 OpenClaw

现在，您的 WSL2 Ubuntu 环境中已经具备了运行 OpenClaw 的条件。以下是几种安装方式：

方式 1：官方一键脚本安装

自动化程度最高，包含交互式配置向导

curl -fsSL https://openclaw.ai/install.sh | bash

执行后，脚本会自动检测环境并引导您完成后续配置。

方式 2：通过 npm 手动安装

1. 全局安装 OpenClaw

npm install -g openclaw@latest

2. 安装完成后，运行配置向导

openclaw onboard --install-daemon

方式 3：通过 Docker 安装

此方法在 WSL2 中安装 Docker 后使用，能获得最佳的环境隔离性。

1. 在 WSL2 Ubuntu 中安装 Docker：参考官方 Docker 安装指南。
2. 使用 docker-compose 启动 OpenClaw。

对于大多数用户，推荐使用 方式 1 或 方式 2。

阶段四：初始配置与启动服务

无论通过哪种方式安装，最终都会进入 OpenClaw 配置向导。

这个向导会像一位助手一样，引导完成最关键的四步：

1. 风险提示：阅读后输入 Yes 继续。
2. 配置 AI 模型：
   • 选择您想使用的 AI 模型提供商（例如 OpenAI GPT、DeepSeek 等）。
   • 输入对应平台的 有效 API 密钥（这里使用了百度千帆，API 密钥需要提前在相应官网申请）。
3. 选择通信渠道（可选）：
   • 首次配置可以先输入 Skip 跳过。
   • 后续可以在 OpenClaw 的 Web 控制台中通过插件，接入飞书等。
4. 选择初始技能（可选）： 同样可以输入 Skip 跳过，后续在控制台中按需安装。

完成配置后，向导会自动启动 OpenClaw 的核心服务（网关 Gateway）。

当您在终端看到类似以下信息时，说明服务启动成功

OpenClaw daemon started successfully! Gateway URL: http://127.0.0.1:18789

这里启动过了，就用 openclaw gateway status 命令展示一下启动成功信息。

访问您的 OpenClaw 控制台：

1. 直接在 Ubuntu 终端中输入 openclaw dashboard
2. 或者，在 Windows 系统的浏览器（如 Chrome, Edge）地址栏中，手动输入 http://127.0.0.1:18789

看到 OpenClaw 的 Web 管理界面，就标志着已成功在 WSL2 上部署了自己的 AI 助手服务！

# 启动 OpenClaw 网关服务
openclaw gateway start
# 停止 OpenClaw 网关服务
openclaw gateway stop
# OpenClaw 状态检查
openclaw gateway status

安装完成检查清单

• WSL2 已安装，并成功启动 Ubuntu。
• 在 Ubuntu 中，通过 node -v 确认版本 ≥ 22。
• 已通过 npm 或一键脚本成功安装 OpenClaw。
• 已通过配置向导绑定 AI 模型的 API 密钥。
• 能在浏览器中通过 http://127.0.0.1:18789 访问 OpenClaw 控制台。

检查服务状态及访问 Web 控制台

检查服务状态：openclaw status

本地网页控制台：openclaw dashboard