OpenClaw 安装教程（WSL 版本）

前提条件

在开始安装前，您需要确保已在 Windows 10 或 Windows 11 操作系统上完成 WSL2 的安装，并已配置好 Linux 发行版（本文以 Ubuntu 为例）。若尚未完成，请先参考相关的 WSL 详细安装教程进行配置。

一：检查 WSL 状态

首先，请验证 WSL 环境是否已正确启用。操作步骤如下：

以管理员身份打开 Windows PowerShell（或终端），输入并执行以下命令：

wsl --list --verbose

此命令将列出所有已安装的 Linux 发行版及其当前的运行状态（如 Running 或 Stopped），请确认您的 Ubuntu 发行版已就绪。

二：更新 Ubuntu 系统

确保系统环境处于最新状态是稳定运行的基础。接下来，我们进入 WSL 环境并对 Ubuntu 系统进行更新。

1. 启动并进入您安装的 Ubuntu 发行版终端：

wsl -d Ubuntu-24.04

2. 执行系统包更新与升级命令：

sudo apt update && sudo apt upgrade -y

此过程将拉取软件源列表并安装所有可用更新。所需时间视您的网络速度和更新包大小而定。

三：安装 Node.js 22+

OpenClaw 的运行依赖于 Node.js 运行时环境，因此必须安装 Node.js 22 或更高版本。您可以通过 NodeSource 或 nvm 等工具进行安装，具体步骤可参考详细教程：《Windows下WSL(Ubuntu24.04)安装Nodejs》。

安装 OpenClaw

基础环境配置完成后，即可开始安装 OpenClaw。建议首先切换到用户主目录，便于后续操作：

cd ~

一. 全局安装

1. 使用 pnpm 或 npm 全局安装 OpenClaw：

# 使用 pnpm
pnpm add -g openclaw@latest
# 或使用 npm
npm install -g openclaw@latest

2. 启动OpenClaw 安装向导：

# 运行初始化向导（此命令会同时安装守护进程）
openclaw onboard --install-daemon

随后，请根据终端中显示的图形化或命令行向导，逐步完成初始配置。

3. 启动OpenClaw 网关

# 启动网关服务，指定端口并开启详细日志
openclaw gateway --port 18789 --verbose

二. 源码安装

若您希望基于最新代码进行体验、或计划进行二次开发，可以选择通过源码编译安装。

1、克隆项目仓库到本地：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

2、安装项目所需的所有依赖：

# 请注意使用 --ignore-scripts=false 参数
pnpm install --ignore-scripts=false

3、构建项目：

# 首先构建前端UI界面（首次运行时会自动安装UI依赖）
pnpm ui:build
# 然后构建核心项目
pnpm build

4、启动-开发模式：

# 启动UI开发服务器（支持热重载，边改边看）
pnpm ui:dev
# 启动Gateway开发模式（代码变动时自动重载）
pnpm gateway:watch

5、启动-生产模式：

# 在项目目录下启动生产环境的网关
pnpm openclaw gateway --port 18789 --verbose
# 或者，如果你已经全局安装了，可以直接用
openclaw gateway --port 18789 --verbose

测试 OpenClaw

安装完成后，建议进行功能性测试以验证部署是否成功。以下是两个快速验证方法：

发送一条测试消息，检查通信链路是否正常：

# 将 +1234567890 替换为你的目标号码
openclaw message send --to +1234567890 --message “Hello from OpenClaw”

或者，直接与集成的 AI 智能体进行对话，体验其核心交互能力：

# 开启深度思考模式，问它一个任务，比如“Ship Checklist”
openclaw agent --message “Ship checklist” --thinking high

常见问题解决

安装过程中可能会遇到一些典型问题，以下是相应的排查与解决方法：

• 网络问题：若在更新系统或安装依赖时出现超时、速度缓慢，通常是由于默认软件源连接不畅所致。建议将 Ubuntu 的 APT 源替换为国内镜像（如阿里云、清华大学源），可显著提升下载速度。
• 权限问题：在 Linux 环境下执行全局安装或系统级操作时，请务必在命令前添加 sudo 以获取超级用户权限。
• Node.js 版本问题：请确保已安装 Node.js 22 或更高版本，版本不符会导致运行时错误或功能异常。可使用 node -v 命令进行确认。
• 端口占用：如果启动网关时提示 18789 端口已被占用，可通过修改 –port 参数指定其他空闲端口，例如 –port 18790。

后续操作

至此，OpenClaw 应该已在您的 WSL 环境中成功部署。后续您可以执行以下操作：

• 随时查阅详细技术文档：openclaw docs
• 检查 OpenClaw 服务的运行状态：openclaw status
• 当有新版本发布时，执行一键更新命令：openclaw update

遵循以上步骤，您即可在 Windows 的 WSL2 子系统内顺利搭建并运行个人专属的 OpenClaw AI 智能体平台。若遇到本文未涵盖的疑难问题，建议优先查阅 OpenClaw 官方文档，或加入其 Discord 官方社区 与其他开发者交流讨论。祝您使用愉快！