OpenClaw全平台部署教程

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

xcode-select --install

sudo apt-get update
sudo apt-get install -y build-essential python3

# 以CentOS 9.x为例
ssh root@你的服务器公网IP

yum update -y

yum install -y yum-utils device-mapper-persistent-data lvm2

yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

yum install -y docker-ce docker-ce-cli containerd.io

systemctl start docker

systemctl enable docker

# 安装Docker Compose
curl -L "https://github.com/docker/compose/releases/download/v2.26.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose

version: '3.8'

services:
  openclaw-gateway:
    container_name: openclaw-gateway
    image: ${OPENCLAW_IMAGE}
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
      - DAC_OVERRIDE
    # 可选：指定容器运行 UID:GID（例如 1000:1000）
    # 默认保持 root 启动，以便 init.sh 自动修复挂载卷权限后再降权运行网关
    user: ${OPENCLAW_RUN_USER:-0:0}
    environment:
      TZ: Asia/Shanghai
      HOME: /home/node
      TERM: xterm-256color
      # 模型配置
      MODEL_ID: ${MODEL_ID}
      BASE_URL: ${BASE_URL}
      API_KEY: ${API_KEY}
      API_PROTOCOL: ${API_PROTOCOL}
      CONTEXT_WINDOW: ${CONTEXT_WINDOW}
      MAX_TOKENS: ${MAX_TOKENS}
      # 通道配置
      TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN}
      FEISHU_APP_ID: ${FEISHU_APP_ID}
      FEISHU_APP_SECRET: ${FEISHU_APP_SECRET}
      DINGTALK_CLIENT_ID: ${DINGTALK_CLIENT_ID}
      DINGTALK_CLIENT_SECRET: ${DINGTALK_CLIENT_SECRET}
      DINGTALK_ROBOT_CODE: ${DINGTALK_ROBOT_CODE}
      DINGTALK_CORP_ID: ${DINGTALK_CORP_ID}
      DINGTALK_AGENT_ID: ${DINGTALK_AGENT_ID}
      QQBOT_APP_ID: ${QQBOT_APP_ID}
      QQBOT_CLIENT_SECRET: ${QQBOT_CLIENT_SECRET}
      # 企业微信配置
      WECOM_TOKEN: ${WECOM_TOKEN}
      WECOM_ENCODING_AES_KEY: ${WECOM_ENCODING_AES_KEY}
      # 工作空间配置
      WORKSPACE: ${WORKSPACE}
      # Gateway 配置
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_GATEWAY_BIND: ${OPENCLAW_GATEWAY_BIND}
      OPENCLAW_GATEWAY_PORT: ${OPENCLAW_GATEWAY_PORT}
      OPENCLAW_BRIDGE_PORT: ${OPENCLAW_BRIDGE_PORT}
    volumes:
      - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw
      # 使用匿名卷排除 extensions 目录，使用镜像中预装的插件
      - /home/node/.openclaw/extensions
    ports:
      - "${OPENCLAW_GATEWAY_PORT}:18789"
      - "${OPENCLAW_BRIDGE_PORT}:18790"
    init:true
    restart:unless-stopped

vim  .env

# OpenClaw Docker 环境变量配置示例
# 复制此文件为 .env 并修改相应的值

# Docker 镜像配置
OPENCLAW_IMAGE=docker.1ms.run/justlikemaki/openclaw-docker-cn-im:latest

# 模型配置
MODEL_ID=model id
BASE_URL=http://api.wow3.top/v1
API_KEY=123456
# API 协议类型: openai-completions 或 anthropic-messages
# openai-completions: OpenAI 协议 (适用于 OpenAI、Gemini 等模型)
# anthropic-messages: Claude 协议 (适用于 Claude 模型，支持 Prompt Caching)
API_PROTOCOL=openai-completions
# 模型上下文窗口大小
CONTEXT_WINDOW=200000
# 模型最大输出 tokens
MAX_TOKENS=8192

# Telegram 配置（可选，留空则不启用）
TELEGRAM_BOT_TOKEN=

# 飞书配置（可选，留空则不启用）
FEISHU_APP_ID=
FEISHU_APP_SECRET=

# 钉钉配置（可选，留空则不启用）
DINGTALK_CLIENT_ID=
DINGTALK_CLIENT_SECRET=
DINGTALK_ROBOT_CODE=
DINGTALK_CORP_ID=
DINGTALK_AGENT_ID=

# QQ 机器人配置（可选，留空则不启用）
QQBOT_APP_ID=
QQBOT_CLIENT_SECRET=

# 企业微信配置（可选，留空则不启用）
WECOM_TOKEN=
WECOM_ENCODING_AES_KEY=

# 工作空间配置（不要更改）
WORKSPACE=/home/node/.openclaw/workspace

# 挂载目录配置（按实际更改）
# OpenClaw 数据目录（包含配置文件、工作空间等所有数据）
OPENCLAW_DATA_DIR=~/.openclaw

# 可选：容器启动用户 UID:GID
# 默认 0:0（root）用于 init.sh 自动修复挂载目录权限，再降权为 node 启动服务
# 如需与宿主机用户对齐，可设置为 1000:1000 或 Linux 上的 $(id -u):$(id -g)
OPENCLAW_RUN_USER=0:0

# Gateway 配置
## 网关 token，用于认证（按实际更改）
OPENCLAW_GATEWAY_TOKEN=123456
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790

docker-compose up -d

pkg update && pkg upgrade -y
pkg install nodejs git openssh tmux -y

npm config set prefix ~/.npm-global
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm i -g openclaw@latest

node -e "const fs = require('fs');const file = process.env.HOME + '/.npm-global/lib/node_modules/clawdbot/node_modules/@mariozechner/clipboard/index.js';let c = fs.readFileSync(file, 'utf8');if(!c.includes('isAndroidTermux')) {c = c.replace(/if $$ !nativeBinding $$ \{/, 'const isAndroidTermux = platform===\"android\"||(platform===\"linux\"&&process.env.TERMUX_VERSION);if(!nativeBinding&&isAndroidTermux){nativeBinding={availableFormats:()=>[],getText:()=>\"\",setText:()=>false,hasText:()=>false,getImageBinary:()=>null,getImageBase64:()=>null,setImageBinary:()=>false,setImageBase64:()=>false,hasImage:()=>false,getHtml:()=>\"\",setHtml:()=>false,hasHtml:()=>false,getRtf:()=>\"\",setRtf:()=>false,hasRtf:()=>false,clear:()=>{},watch:()=>({stop:()=>{}}),callThreadsafeFunction:()=>{}}}else if(!nativeBinding){');fs.writeFileSync(file, c);console.log('✅ Clipboard patched!');}"

node -e "const fs = require('fs');const file = process.env.HOME + '/.npm-global/lib/node_modules/clawdbot/dist/logging/logger.js';let c = fs.readFileSync(file, 'utf8');c = c.replace('const DEFAULT_LOG_DIR = \"/tmp/clawdbot\";', 'const DEFAULT_LOG_DIR = (process.env.TMPDIR||process.env.HOME)+\"/clawdbot-logs\";');fs.writeFileSync(file, c);console.log('✅ Logger patched!');"

echo 'export TERMUX_VERSION=1' >> ~/.bashrc
echo 'export TMPDIR=$HOME/tmp' >> ~/.bashrc
mkdir -p ~/tmp ~/clawdbot-logs
source ~/.bashrc

tmux new -s claw
openclaw gateway --port 18789

# 重新进入会话
tmux attach -t claw

# 查看所有会话
tmux list-sessions

# 后台运行时查看日志
tail -f ~/clawdbot-logs/*.log

# 手机端Termux中执行，查看用户名和IP
whoami
ifconfig | grep "inet "

# 电脑端终端连接
ssh -p 8022 u0_aXXX@192.168.1.XX

iwr -useb https://openclaw.ai/install.ps1 | iex

curl -fsSL https://openclaw.ai/install.sh | bash

openclaw --version

openclaw channels add

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "你的 App Secret",
          "botName": "我的 AI 助手"
        }
      }
    }
  }
}

{
  "models": {
    "mode": "merge",
    "providers": {
      "custom-proxy": {
        "baseUrl": "https://api.wow3.top/v1",
        "apiKey": "你的 API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "claude-sonnet-4-6",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 32000
          }
        ]
      }
    },
    "bedrockDiscovery": {
      "defaultContextWindow": 1
    }
  },
"agents": {
    "defaults": {
      "model": {
        "primary": "custom-proxy/claude-sonnet-4-6"
      },
      "models": {
        "custom-proxy/claude-sonnet-4-5-20250929": {}
      },
      "workspace": "/home/你的用户名/.openclaw/workspace",  // 替换为实际路径
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

openclaw gateway restart

{
  "channels": {
    "feishu": {
      "groupPolicy": "open",      // 允许所有群聊（默认 requireMention: true）
      "groups": {
        "oc_xxx": {                // 针对特定群聊覆盖设置
          "requireMention": false  // 该群聊无需 @ 即可响应
        }
      },
      "groupAllowFrom": ["ou_xxx", "ou_yyy"] // 仅允许指定用户所在的群聊（需配合 groupPolicy: "allowlist"）
    }
  }
}

{
  "channels": {
    "feishu": {
      "groupPolicy": "open"
    }
  }
}

{
  "channels": {
    "feishu": {
      "groups": {
        "oc_xxx": {
          "requireMention": false
        }
      }
    }
  }
}

{
  "channels": {
    "feishu": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["ou_xxx", "ou_yyy"]
    }
  }
}

{
  "channels": {
    "feishu": {
      "streaming": true,
      "blockStreaming": true   // 使用卡片块流式
    }
  }
}