去评论
dz插件网

Docker-Compose部署OpenClaw New

镖师
2026/02/22 14:32:12
feed/19
使用docker-compose部署不失为最省心最快速体验openclaw的方式之一。
但是docker里面的openclaw能干的事情太少，卒之还是建议部署在宿主机上。
直入主题
创建一个目录，创建如下两个文件
.env
  1. OPENCLAW_IMAGE=ghcr.io/openclaw/openclaw:latest
  2. OPENCLAW_GATEWAY_TOKEN=可以先留空，等QuickStart之后再看openclaw.json
  3. OPENCLAW_DATA_DIR=./data
docker-compose.yml
  1. services:
  2.   # --- 主服务：WebUI 和 Gateway (常驻) ---
  3.   openclaw-gateway:
  4.     image: ${OPENCLAW_IMAGE}
  5.     container_name: openclaw-gateway
  6.     restart: unless-stopped
  7.     init: true
  8.     environment:
  9.       # 必须配置
  10.       OPENCLAW_GATEWAY_MODE: local
  11.       OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
  12.       # 基础环境
  13.       HOME: /home/node
  14.       TERM: xterm-256color
  15.       # 绑定设置
  16.       OPENCLAW_GATEWAY_BIND: "lan"
  17.       OPENCLAW_GATEWAY_PORT: 18789
  18.     volumes:
  19.       - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw
  20.       - ${OPENCLAW_DATA_DIR}/workspace:/home/node/.openclaw/workspace
  21.     ports:
  22.       - "18789:18789"
  23.       - "18790:18790"
  24.     command:
  25.       [
  26.         "node",
  27.         "dist/index.js",
  28.         "gateway",
  29.         "--bind",
  30.         "lan",
  31.         "--port",
  32.         "18789",
  33.       ]
  34.   # --- 工具箱：CLI (默认不启动) ---
  35.   openclaw-cli:
  36.     profiles: ["tools"]
  37.     image: ${OPENCLAW_IMAGE}
  38.     container_name: openclaw-cli
  39.     init: true
  40.     stdin_open: true # -i 允许输入
  41.     tty: true        # -t 伪终端
  42.     environment:
  43.       OPENCLAW_GATEWAY_MODE: local
  44.       OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
  45.       HOME: /home/node
  46.       TERM: xterm-256color
  47.       BROWSER: echo # 防止尝试打开宿主机浏览器
  48.     volumes:
  49.       # 挂载相同的配置目录，确保 CLI 修改的是同一份文件
  50.       - ${OPENCLAW_DATA_DIR}:/home/node/.openclaw
  51.       - ${OPENCLAW_DATA_DIR}/workspace:/home/node/.openclaw/workspace
  52.     entrypoint: ["node", "dist/index.js"]
  53. networks:
  54.   default:
  55.     enable_ipv6: true
  56.     driver: bridge
  57.     ipam:
  58.       driver: default
  59.       config:
  60.         - subnet: 172.18.0.0/16
  61.         - subnet: fd00:dead:beee::/48
  62.     driver_opts:
  63.       com.docker.network.bridge.enable_ip_masquerade: "true"
  64.       com.docker.network.bridge.name: "openclaw"
需要注意的是

有太多预购建好的openclaw镜像，可以根据需求挑选。
进入放docker-compose.yml的目录之后，docker compose run --rm openclaw-cli onboard 开始交互式引导向导
之后 docker compose up -d openclaw-gateway
如果你的docker没有启用ipv6，请删掉docker-compose.yml关于ipv6的那几行
如果要关掉Control UI的设备配对，请在openclaw.json的gateway中加入下面的内容
  1.   "gateway": {
  2.     "controlUi": {
  3.       "allowInsecureAuth": true,
  4.       "dangerouslyDisableDeviceAuth": true
  5.     },
  6.     "trustedProxies": ["*"],
  7.   ...
  8.   },
Nvidia免费提供多款开源大模型

在openclaw.json的models.providers部分添加配置

下面是我给出的一份参考
  1.   "models": {
  2.     "providers": {
  3.       "nvidia": {
  4.         "baseUrl": "https://integrate.api.nvidia.com/v1",
  5.         "apiKey": "nvapi-填入你的apiKey",
  6.         "api": "openai-completions",
  7.         "models": [
  8.           {
  9.             "id": "z-ai/glm5",
  10.             "name": "GLM-5",
  11.             "api": "openai-completions",
  12.             "reasoning": false,
  13.             "input": [
  14.               "text"
  15.             ],
  16.             "contextWindow": 200000,
  17.             "maxTokens": 8192
  18.           },
  19.           {
  20.             "id": "minimaxai/minimax-m2.1",
  21.             "name": "MMinimax-M2.1",
  22.             "api": "openai-completions",
  23.             "reasoning": false,
  24.             "input": [
  25.               "text"
  26.             ],
  27.             "contextWindow": 195000,
  28.             "maxTokens": 8192
  29.           },
  30.           {
  31.             "id": "moonshotai/kimi-k2.5",
  32.             "name": "Kimi-K2.5",
  33.             "api": "openai-completions",
  34.             "reasoning": false,
  35.             "input": [
  36.               "text"
  37.             ],
  38.             "contextWindow": 250000,
  39.             "maxTokens": 8192
  40.           },
  41.           {
  42.             "id": "qwen/qwen3.5-397b-a17b",
  43.             "name": "Qwen3.5-397B-A17B",
  44.             "api": "openai-completions",
  45.             "reasoning": false,
  46.             "input": [
  47.               "text"
  48.             ],
  49.             "contextWindow": 250000,
  50.             "maxTokens": 8192
  51.           }
  52.         ]
  53.       }
  54.     }
  55.   },
在agents.defaults.models部分添加配置
  1.   "agents": {
  2.     "defaults": {
  3.       "model": {
  4.         "primary": "nvidia/minimaxai/minimax-m2.1"
  5.       },
  6.       "models": {
  7.         "nvidia/z-ai/glm5": {},
  8.         "nvidia/minimaxai/minimax-m2.1": {},
  9.         "nvidia/moonshotai/kimi-k2.5": {},
  10.         "nvidia/qwen/qwen3.5-397b-a17b": {}
  11.       },
  12.   ...
  13.     }
  14.   },
进入原文参与互动