在 WSL2 上部署 OpenClaw 的实操记录

在 Ubuntu 里装 Node.js 22

OpenClaw 这一步绕不开，要求 Node.js >= 22。我这里用的是 nvm，原因很简单：以后切版本不会折腾系统环境。

先装 nvm：

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

然后让当前 shell 生效，或者直接重开一个 Ubuntu 终端：

source ~/.bashrc

确认一下 nvm 是否可用：

nvm --version

接着安装 Node.js 22：

nvm install 22

设置默认版本：

nvm alias default 22

最后检查版本：

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

如果这里报 command not found，通常不是装坏了，而是 source ~/.bashrc 没生效，或者终端还停留在旧会话里。

安装 OpenClaw

环境准备好之后，OpenClaw 的安装方式有三种，差别主要在于你想省事还是想自己控一点。

方式一：官方一键脚本

这是最省事的办法，脚本会带着你把后续配置一起做完：

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

运行后会自动检测环境并进入配置流程。

方式二：通过 npm 安装

如果你更习惯手动控制版本，这种方式也很直接：

npm install -g openclaw@latest

安装完再执行初始化：

openclaw onboard --install-daemon

方式三：通过 Docker 安装

如果你本来就在 WSL2 里配了 Docker，这条路也能走。只是对大多数人来说，OpenClaw 本身并不需要把部署复杂度再抬高一层。

1. 先在 WSL2 Ubuntu 里装 Docker，按官方文档来：https://docs.docker.com/engine/install/ubuntu/
2. 再用 docker-compose 启动 OpenClaw。

进入配置向导并启动服务

不管你是用脚本、npm 还是 Docker，最后都会进 OpenClaw 的配置向导。这里真正需要你确认的，也就四件事。

• 先读风险提示，输入 Yes 继续。
• 选择 AI 模型提供商，比如 OpenAI GPT、DeepSeek 等，然后填 API 密钥。这里示例里用的是百度千帆，密钥要提前去对应平台申请。
• 通信渠道可以先跳过，后面再从 Web 控制台接插件。
• 初始技能也可以先跳过，后续按需要再装。

配置完成后，OpenClaw 会启动核心服务，也就是网关。终端里如果看到类似这行，就说明已经起来了：

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

可以再查一次状态：

openclaw gateway status

访问控制台有两种方式：

openclaw dashboard

或者直接在 Windows 浏览器里打开：

http://127.0.0.1:18789

能看到 Web 管理界面，基本就算部署完成了。

常用命令

openclaw gateway start

openclaw gateway stop

openclaw gateway status

openclaw status

openclaw dashboard

安装后的检查清单

• WSL2 已安装并能正常启动 Ubuntu。
• Ubuntu 里 node -v 显示的是 22 或更高版本。
• OpenClaw 已通过一键脚本或 npm 安装完成。
• 配置向导已经绑定好 AI 模型的 API 密钥。
• 浏览器可以访问 http://127.0.0.1:18789/。

这套流程的好处是路径短，问题也集中。只要 WSL2、Node.js 版本和 API 密钥这三件事没出错，OpenClaw 在本地跑起来并不费劲。对 Windows 用户来说，这比在原生环境里硬扛兼容性问题要实在得多。