OpenClaw 安装教程（WSL 版本）

2026-05-06阅读 0热度 0

ai Ubuntu OpenClaw

前提条件

开始之前，你需要确保你的 Windows 10 或 11 系统已经安装好 WSL2，并且已经配置了 Linux 发行版（这里我们以 Ubuntu 为例）。如果还没完成这一步，可以参考详细的安装指南。

一：检查 WSL 状态

首先，得确认 WSL 是否已经准备就绪。操作很简单：

打开 PowerShell，运行这条命令看看：

wsl --list --verbose

如果一切正常，你会看到当前安装的 Linux 发行版及其状态。

二：更新 Ubuntu 系统

好的开端是成功的一半，接下来我们进入 WSL 环境，把系统更新到最新。

1. 启动并进入你的 Ubuntu 终端：

wsl -d Ubuntu-24.04

2. 一口气更新所有系统包：

sudo apt update && sudo apt upgrade -y

这个过程可能会花点时间，取决于你的网络和更新包的大小。

三：安装 Node.js 22+

OpenClaw 的运行依赖 Node.js 环境，所以这一步必不可少。安装 Node.js 22 或更高版本，具体的步骤可以参考这篇详细的指南：《Windows下WSL(Ubuntu24.04)安装Nodejs》。

安装 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 更换一个国内的软件源，速度会有立竿见影的提升。
权限问题：在 Linux 下安装全局包或操作系统文件时，记得在命令前加上 sudo 来获取必要的管理员权限。
Node.js 版本问题：请务必确认你安装的是 Node.js 22 或更高版本，版本不符是导致各种诡异错误的常见原因。
端口占用：如果启动网关时提示 18789 端口被占用，换一个其他空闲端口即可，比如 –port 18790。

后续操作

恭喜你，到这里应该已经大功告成了。之后你可以：

随时查看详细文档：openclaw docs
检查 OpenClaw 的运行状态：openclaw status
当有新版本发布时，一键更新：openclaw update

按照以上步骤操作，你就能在 WSL 环境中成功部署并运行属于你个人的 OpenClaw AI 助手了。如果过程中遇到了本文未涵盖的问题，最好的去处是查阅 OpenClaw 官方文档，或者加入其 Discord 社区 向其他开发者寻求帮助。祝您使用愉快！