# 檢查 Node.js 版本
node --version
# 期望輸出: v22.x.x 或更高
# 檢查 npm 版本
npm --version
# 期望輸出: 10.x.x 或更高
# 檢查操作系統(tǒng)
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
# 設(shè)置默認(rèn)版本
nvm alias default 24
# 驗(yàn)證安裝
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
# 驗(yàn)證安裝
openclaw --version
# 期望輸出: 1.x.x

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

# 創(chuàng)建 npm 全局目錄
mkdir ~/.npm-global
# 配置 npm 使用新目錄
npm config set prefix '~/.npm-global'
# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

{
  "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
  }
}

# 創(chuàng)建配置目錄
mkdir -p ~/.openclaw
# 創(chuàng)建配置文件
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

# 前臺運(yùn)行，顯示詳細(xì)日志
openclaw gateway --verbose
# 輸出示例
# [INFO] Gateway starting on port 18789...
# [INFO] Loaded 5 skills
# [INFO] Connected to model: gpt-4o-mini
# [INFO] Gateway ready

# 安裝為系統(tǒng)服務(wù)
openclaw onboard --install-daemon
# 啟動(dòng)服務(wù)
openclaw gateway start
# 查看狀態(tài)
openclaw gateway status
# 停止服務(wù)
openclaw gateway stop
# 重啟服務(wù)
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

# 啟動(dòng)
docker-compose up -d
# 查看日志
docker-compose logs -f
# 停止
docker-compose down

# 檢查 Gateway 狀態(tài)
openclaw gateway status
# 期望輸出
# Gateway is running on port 18789
# Uptime: 2 minutes
# Active sessions: 0
# Model: gpt-4o-mini

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

# 查看實(shí)時(shí)日志
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

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

# 檢查當(dāng)前令牌
openclaw config get gateway.authToken
# 重新生成令牌
openclaw config set gateway.authToken $(openssl rand -hex 32)
# 重啟 Gateway
openclaw gateway restart

# 驗(yàn)證 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 內(nèi)存限制
export NODE_OPTIONS="--max-old-space-size=4096"
# 或在啟動(dòng)命令中指定
node --max-old-space-size=4096 $(which openclaw) gateway