5分钟部署 OpenClaw从零到运行的完整流程

# 检查 Node.js 版本
node --version
# 期望输出: v22.x.x 或更高
# 检查 npm 版本
npm --version
# 期望输出: 10.x.x 或更高
# 检查操作系统
uname -a  # Linux/macOS
# 或
ver       # Windows

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载终端配置
source ~/.bashrc  # 或 source ~/.zshrc
# 安装 Node.js 24
nvm install 24
nvm use 24
# 设置默认版本
nvm alias default 24
# 验证安装
node --version

# 安装 Homebrew（如果还没有）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js
brew install node@24

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

# 添加 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
# 安装 Node.js
sudo yum install -y nodejs

# 使用 npm 安装
npm install -g openclaw@latest
# 或使用 pnpm（更快更省空间）
npm install -g pnpm
pnpm add -g openclaw@latest
# 验证安装
openclaw --version
# 期望输出: 1.x.x

# 配置淘宝镜像
npm config set registry https://registry.npmmirror.com
# 或使用 pnpm
pnpm config set registry https://registry.npmmirror.com

# 创建 npm 全局目录
mkdir ~/.npm-global
# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'
# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

openclaw onboard

{
  "gateway": {
    "port": 18789,
    "authToken": "your-secret-token",    "verbose": false
  },
  "models": {
    "default": {
      "provider": "openai",
      "model": "gpt-4o-mini",
      "apiKey": "sk-xxx"
    }
  },
  "channels": {
    "telegram": {
      "enabled": false,
      "botToken": ""
    },
    "whatsapp": {
      "enabled": false
    }
  },
  "sessions": {
    "maxContextTokens": 4000,
    "timeout": 3600
  }
}

# 创建配置目录
mkdir -p ~/.openclaw
# 创建配置文件
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "gateway": {
    "port": 18789,
    "authToken": "your-strong-password-here"
  },
  "models": {
    "default": {
      "provider": "openai",
      "model": "gpt-4o-mini",
      "apiKey": "sk-your-api-key"
    }
  }
}
EOF

# 前台运行，显示详细日志
openclaw gateway --verbose
# 输出示例
# [INFO] Gateway starting on port 18789...
# [INFO] Loaded 5 skills
# [INFO] Connected to model: gpt-4o-mini
# [INFO] Gateway ready

# 安装为系统服务
openclaw onboard --install-daemon
# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart

# docker-compose.yml
version: '3.8'
services:
  openclaw:
    image: openclaw/gateway:latest
    container_name: openclaw-gateway
    ports:
      - "18789:18789"
    volumes:
      - ./config:/root/.openclaw
      - ./workspace:/workspace
    environment:
      - OPENCLAW_AUTH_TOKEN=${AUTH_TOKEN}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
    restart: unless-stopped
    # 安全加固
    read_only: true
    user: "1000:1000"
    security_opt:
      - no-new-privileges:true

# 启动
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止
docker-compose down

# 检查 Gateway 状态
openclaw gateway status
# 期望输出
# Gateway is running on port 18789
# Uptime: 2 minutes
# Active sessions: 0
# Model: gpt-4o-mini

# 方式一：CLI 发送
openclaw agent --message "你好，请介绍一下你自己"
# 方式二：HTTP 请求
curl -X POST http://localhost:18789/api/chat \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '{"message": "你好"}'

# 查看实时日志
openclaw logs --follow
# 查看最近 100 行
openclaw logs --lines 100
# 日志文件位置
cat ~/.openclaw/logs/gateway.log

[2026-03-15 22:30:00] INFO  Gateway started on port 18789
[2026-03-15 22:30:01] INFO  Loaded 5 skills from ~/.openclaw/skills
[2026-03-15 22:30:02] INFO  Connected to OpenAI API
[2026-03-15 22:30:15] INFO  Session created: session_abc123
[2026-03-15 22:30:16] INFO  Message received, processing...
[2026-03-15 22:30:18] INFO  Response sent successfully

# 查找占用端口的进程
lsof -i :18789
# 输出示例
# COMMAND   PID USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
# node     12345 user   22u  IPv6 123456      0t0  TCP *:18789 (LISTEN)
# 终止进程
kill -9 12345
# 或更换端口
openclaw gateway --port 18888

# 检查当前令牌
openclaw config get gateway.authToken
# 重新生成令牌
openclaw config set gateway.authToken $(openssl rand -hex 32)
# 重启 Gateway
openclaw gateway restart

# 验证 API Key 配置
openclaw config get models.default.apiKey
# 更新 API Key
openclaw config set models.default.apiKey "sk-xxx"
# 测试 API 连接
openclaw agent --message "test" --verbose

# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
# 或在启动命令中指定
node --max-old-space-size=4096 $(which openclaw) gateway