安装指南

安装指南

OpenClaw 可以安装在 macOS、Linux 和 Windows（通过 WSL2）上。它是一个基于 Node.js 的个人 AI 助手平台，在您的设备上本地运行。

前置条件

在安装 OpenClaw 之前，请确保您已安装：

  • Node.js 22 或更高版本（必需）
  • npm、pnpm（推荐）或 bun（包管理器）
  • Git（可选，用于开发）

检查您的 Node.js 版本：

node --version  # 应该是 v22.0.0 或更高

如果需要安装或升级 Node.js，请访问 nodejs.org。

推荐安装方式（CLI 向导）

安装 OpenClaw 最简单的方法是使用 CLI 向导：

# 使用 npm 全局安装
npm install -g openclaw@latest

# 或使用 pnpm（推荐）
pnpm add -g openclaw@latest

# 或使用 bun
bun add -g openclaw@latest

然后运行引导向导来设置网关、工作区、渠道和技能：

openclaw onboard --install-daemon

向导将引导您完成：

  • 设置网关（控制平面）
  • 配置您的工作区
  • 连接通信渠道（WhatsApp、Telegram、Slack 等）
  • 从 ClawHub 安装技能
  • 安装守护进程服务（macOS 上的 launchd，Linux 上的 systemd）

从源码安装（开发）

用于开发或使用最新功能：

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖（使用 pnpm）
pnpm install

# 构建 UI 和项目
pnpm ui:build
pnpm build

# 运行引导
pnpm openclaw onboard --install-daemon

# 开发模式（自动重载）
pnpm gateway:watch

验证安装

验证 OpenClaw 是否正确安装：

openclaw --version

您应该看到版本号输出到控制台。

启动网关

启动 OpenClaw 网关（控制平面）：

openclaw gateway --port 18789 --verbose

网关在 ws://127.0.0.1:18789 上运行 WebSocket，管理会话、渠道、工具和事件。

下一步

现在您已经安装了 OpenClaw：

  • 查看快速开始指南发送您的第一条消息
  • 了解代理系统及其工作原理
  • 探索 ClawHub 上可用的技能
  • 连接您喜欢的通信渠道

故障排除

Node.js 版本过旧

OpenClaw 需要 Node.js 22 或更高版本。使用以下方式升级：

# 使用 nvm（Node 版本管理器）
nvm install 22
nvm use 22

# 或从 nodejs.org 下载

权限被拒绝

如果在全局安装期间遇到权限错误：

# 使用 sudo（不推荐）
sudo npm install -g openclaw

# 或配置 npm 使用不同的目录
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

网关无法启动

确保端口 18789 未被占用：

# 检查端口是否被占用
lsof -i :18789

# 使用不同的端口
openclaw gateway --port 18790

Windows 上的 WSL2

对于 Windows 用户，OpenClaw 在 WSL2 上运行效果最佳：

  1. 安装 WSL2：wsl --install
  2. 从 Microsoft Store 安装 Ubuntu
  3. 在 WSL2 内按照 Linux 安装步骤操作