OpenClaw安装方法指南

OpenClaw安装指南，支持多种安装方式：

一、快速安装（推荐）

环境要求

• Node.js ≥ 22（必须）

• 内存 ≥ 2GB（建议 4GB）

• 操作系统：Linux / macOS / Windows (WSL2)

1. 安装 Node.js（如未安装）

macOS（使用 Homebrew）：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install node
node -v  # 确认版本 ≥ 22

Linux（使用 NVM）：

# 国内镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 或国外源
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

source ~/.bashrc
nvm install 22
node -v  # 确认版本 ≥ 22

2. 安装 OpenClaw

使用 npm：

npm install -g openclaw@latest 不推荐

使用 pnpm（更快）：

npm install -g pnpm
pnpm add -g openclaw@latest 推荐，因为速度快

使用 bun：

bun add -g openclaw@latest

3. 运行安装向导

openclaw onboard --install-daemon

--install-daemon 表示安装开机自动启动openclaw服务。daemon代表的是开机自动启动的openclaw服务。

比如onboard这个向导会引导你完成：

• ✅ 网关守护进程安装（自动配置 systemd/launchd）

• ✅ 工作区配置

• ✅ AI 模型选择（支持 OpenAI、Anthropic、通义千问等）

• ✅ 聊天渠道设置（WhatsApp、Telegram、Slack 等）

二、国内用户专用（汉化版）

由于网络原因，国内用户可以使用 OpenClaw 中文本地化版本，已适配国内网络环境：

# 安装汉化版（淘宝镜像源可快速下载）
npm install -g @qingchencloud/openclaw-zh@latest

# 或 openclaw-cn
npm install -g openclaw-cn@latest
pnpm add -g openclaw-cn@latest  速度快

# 运行初始化向导
openclaw-cn onboard --install-daemon

# 启动控制台
openclaw-cn dashboard

汉化版特性：

• 🇨🇳 CLI、Web 界面、配置向导全中文

• 🏠 国内 npm 镜像源支持，下载更快

• 📱 适配飞书、微信（开发中）等国内渠道

三、Docker 安装（适合服务器部署）

# 创建项目目录
mkdir openclaw && cd openclaw

# 下载 Docker 配置
curl -fsSL https://openclaw.ai/docker-setup.sh | bash

# 编辑 .env 文件配置 API 密钥和渠道令牌
nano .env

# 启动服务
docker compose up -d

# 查看日志
docker compose logs -f openclaw

支持架构：AMD64 和 ARM64（Apple Silicon、树莓派等）

四、从源码构建（开发者）

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

# 安装依赖（推荐 pnpm）
pnpm install

# 构建 UI
pnpm ui:build

# 构建项目
pnpm build

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

# 或运行向导
pnpm openclaw onboard --install-daemon

五、Android 手机安装（Termux）

无需 Root，在 Android 上通过 Termux 运行：

pkg install -y wget openssl

wget https://github.com/androidmalware/OpenClaw_Termux/blob/main/install_openclaw_termux.sh
chmod +x install_openclaw_termux.sh
./install_openclaw_termux.sh

脚本会自动安装 Ubuntu (proot-distro) → Node 22 → OpenClaw，并启动网关。

六、安装后验证

# 检查版本
openclaw --version

# 查看帮助
openclaw --help

# 启动网关（前台运行，调试用）
openclaw gateway --port 18789 --verbose

# 发送测试消息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 与 AI 助手对话
openclaw agent --message "Ship checklist" --thinking high

七、常见问题解决

1. npm install 失败/超时

# 切换国内镜像源
npm config set registry https://registry.npmmirror.com

# 清理缓存
npm cache clean --force

# 安装系统构建依赖（Linux）
sudo apt update
sudo apt install -y build-essential python3 make gcc g++

2. 权限问题（避免使用 sudo）

# 配置 npm 全局路径到用户目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc  # 或 ~/.bashrc
source ~/.zshrc

3. 内存不足（< 4GB）

建议配置 Swap 空间：

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

推荐路径：

普通用户用 npm install -g openclaw@latest + openclaw onboard --install-daemon；
国内用户用汉化版 @qingchencloud/openclaw-zh；
服务器部署用 Docker。