OpenClaw · 全平台部署教程

OpenClaw 是一款开源 AI 助手框架，支持 7×24 小时挂机运行，可接入 Claude、GPT、Gemini 等主流大模型。本教程面向零基础用户。

前提条件

  • Node.js 18+（推荐 v20 LTS）
  • 内存：最低 1GB，推荐 2GB+
  • 硬盘：500MB 可用空间
  • 网络：可访问公网

注意

内存不足 1GB 时安装可能卡死，请确保服务器或本机内存充足。

Windows

1. 开启 WSL2

以管理员身份打开 PowerShell，执行以下命令后重启电脑：

powershell
wsl --install

提示

命令执行完成后需要重启电脑，重启后 WSL2 和 Ubuntu 将自动完成安装。

2. 安装 Node.js

在 WSL2 终端（Ubuntu）中，使用 nvm 安装 Node.js：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

验证安装：

bash
node -v
npm -v

3. 安装 OpenClaw

bash
npm install -g openclaw@latest

验证安装：

bash
openclaw --version

4. 运行初始化

bash
openclaw onboard --mode QuickStart

macOS

1. 安装 Homebrew

如果尚未安装 Homebrew，先执行以下命令：

bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Node.js

bash
brew install node

3. 安装 OpenClaw 并初始化

bash
npm install -g openclaw@latest && openclaw onboard --mode QuickStart

Linux

1. 更新系统并安装 Node.js 20

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

2. 安装 OpenClaw

bash
sudo npm install -g openclaw@latest
bash
openclaw onboard --mode QuickStart

3. PM2 后台运行（推荐）

使用 PM2 实现进程守护和开机自启：

bash
sudo npm install -g pm2
pm2 start openclaw -- onboard --mode QuickStart
pm2 startup
pm2 save

提示

执行 pm2 startup 后会输出一条命令，需要复制并执行该命令以完成开机自启配置。

Docker

1. 确认 Docker 已安装

bash
docker --version

2. 一键运行

bash
docker run -d \
  --name openclaw \
  --restart unless-stopped \
  -p 18789:18789 \
  -v openclaw-data:/data \
  openclaw/openclaw:latest

3. docker-compose 方式（推荐）

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/data
    restart: unless-stopped

volumes:
  openclaw-data:

启动服务：

bash
docker compose up -d

数据持久化

使用 volume 挂载确保配置数据在容器重启后不会丢失。

安装后配置

安装完成后，打开浏览器访问：

text
http://localhost:18789

进入管理面板后，你需要配置大模型 API Key 才能开始使用。推荐使用零壹跃迁中转站获取聚合 API Key，支持 Claude、GPT、Gemini 等主流模型：

https://01ai8.com

提示

配置 API Key 后即可在面板中测试各模型的连通性，确保一切就绪。

常见问题

npm install 卡住不动

切换为国内 npmmirror 镜像源后重试：

bash
npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

permission denied 权限错误

Linux / macOS 下使用 sudo 运行；Windows 下以管理员身份运行 PowerShell。

bash
sudo npm install -g openclaw@latest

命令未找到（command not found）

重新打开终端或手动加载环境变量：

bash
source ~/.bashrc

内存不足导致安装卡死

添加 swap 交换空间后重试：

bash
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

WSL2 无法安装

如果 wsl --install 失败，请手动启用虚拟化功能：

powershell
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

注意

执行以上命令后需要重启电脑，并确保 BIOS 中已开启 CPU 虚拟化（VT-x / AMD-V）。