- 1. 系统更新
- 2. 安装nvm
- 3. 执行生效 nvm（或重启终端）
- 4. 安装Node.js 22
- 5. 设置Node.js 22为默认版本
- 6. 验证安装结果，显示版本号
- 7. 安装pnpm
- 执行官方一键安装脚本，自动下载最新稳定版
- 验证安装结果
- npm安装
- 或pnpm安装
- 验证安装
- 1. 克隆 OpenClaw 仓库
- 2. 进入项目目录
- 3. 安装依赖（推荐pnpm）
- 4. 构建项目
- 5. 链接到全局，方便终端调用
- 6. 验证安装
- 启动新手引导向导，并安装后台守护进程（开机自启）
- Gateway 状态
- 命令启动
- 前台运行并查看日志
安装依赖 Node.js（版本≥22），推荐 Node版本管理工具 nvm 安装，避免版本冲突：
1. 系统更新
sudo apt update && sudo apt upgrade -y
2. 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
3. 执行生效 nvm（或重启终端）
source ~/.bashrc
4. 安装Node.js 22
nvm install 22
5. 设置Node.js 22为默认版本
nvm use 22
6. 验证安装结果，显示版本号
node --version
npm --version
7. 安装pnpm
npm install -g pnpm
OpenClaw 提供脚本安装、npm/pnpm安装、源码安装三种方式：
脚本一键安装（首选）
执行官方一键安装脚本，自动下载最新稳定版
curl -fsSL https://openclaw.ai/install.sh | bash
验证安装结果
openclaw --version
npm/pnpm全局安装
npm安装
npm install -g openclaw@latest
或pnpm安装
pnpm add -g openclaw@latest
验证安装
openclaw --version
源码安装适合需要自定义开发或体验最新功能的用户：
1. 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
2. 进入项目目录
cd openclaw
3. 安装依赖（推荐pnpm）
pnpm install
4. 构建项目
pnpm build
5. 链接到全局，方便终端调用
pnpm link --global
6. 验证安装
openclaw --version
基础配置向导快速完成模型配置、网关设置等核心步骤：
启动新手引导向导，并安装后台守护进程（开机自启）
openclaw onboard --install-daemon
向导全程交互完成以下配置：
模型配置：选择需要对接的AI模型（如Kimi、豆包、OpenAI），按提示输入API密钥完成授权；
工作区配置：默认路径为~/.openclaw/workspace，无需修改，直接确认即可（用于存储配置、技能、任务数据）；
通道配置：暂时跳过，后续专门配置飞书通道；
守护进程安装：确认安装Gateway守护进程，让OpenClaw在后台持续运行，支持开机自启；
完成配置：向导自动保存所有设置，无需手动操作。
Gateway 网关启动与验证
Gateway 状态
openclaw gateway status
命令启动
openclaw gateway start
前台运行并查看日志
openclaw gateway --port 18789 --verbose
启动成功后，通过浏览器访问仪表盘，打开浏览器进入聊天界面：
http://127.0.0.1:18789/
输入网关令牌（默认存储在~/.openclaw/openclaw.json中，搜索token字段）。