安装引导

本文档将引导你完成 OpenClaw 的安装过程。

前置条件

1. Node.js: 版本 22.16+ 或 24（推荐）
2. 包管理器: npm、pnpm 或 bun

安装步骤

步骤 1: 安装 Node.js

使用 nvm (推荐)

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 安装 Node.js 24
nvm install 24
nvm use 24

使用 Homebrew (macOS)

brew install node

使用 apt (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

步骤 2: 安装 OpenClaw

# 使用 npm
npm install -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

步骤 3: 运行初始化向导

openclaw onboard

这个命令会引导你完成：

• Gateway 配置
• 模型选择
• 渠道连接
• Skills 安装

步骤 4: 启动 Gateway

openclaw gateway --port 18789

验证安装

# 检查版本
openclaw --version

# 检查健康状态
openclaw doctor

常见问题

Node 版本过低

确保你的 Node.js 版本 >= 22.16。可以使用 node -v 检查。

权限问题

在 macOS/Linux 上，如果遇到权限问题：

sudo chown -R $(whoami) ~/.npm

网络问题

如果在国内网络环境下遇到下载问题，可以配置镜像：

npm config set registry https://registry.npmmirror.com

下一步

• 快速开始 - 发送你的第一条消息
• 配置模型 - 接入你喜欢的 AI 模型
• 连接渠道 - 连接消息平台