OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)

發(fā)布時(shí)間：2026-03-26 16:41:27 作者：改一下配置文件

文章詳細(xì)記錄了使用Docker部署OpenClaw的全過(guò)程,強(qiáng)調(diào)了使用官方鏡像而非本地build的重要性,并提供了完整的docker-compose配置文件,文章還指導(dǎo)了部署流程和訪問(wèn)地址,最后解釋了官方文檔中環(huán)境變量的來(lái)源,需要的朋友可以參考下

很多人第一次部署 OpenClaw，都會(huì)踩一個(gè)坑：官方文檔默認(rèn)讓你 clone + build + 配環(huán)境變量 但實(shí)際體驗(yàn)下來(lái)只有兩個(gè)字：折騰這篇文章，我直接給你一套更干凈、更穩(wěn)定的方案：純Docker Compose部署（無(wú)需本地build）

一、選擇docker部署

不污染宿主機(jī) → Node、依賴(lài)、配置全部隔離在容器里
不會(huì)和本地環(huán)境沖突 → 不用擔(dān)心你機(jī)器上已有 Node/npm/版本問(wèn)題
可復(fù)制性極強(qiáng) → 同一份 docker-compose.yml，在哪都能跑@改一下配置文件

二、準(zhǔn)備工作

2.1 選擇鏡像

之前的文檔里面有下面這段話(huà)，現(xiàn)在不知道為啥沒(méi)有了。鏈接：https://docs.openclaw.ai/install/docker
Use a remote image (skip local build)Official pre-built images are published at:
GitHub Container Registry packageUse image name ghcr.io/openclaw/openclaw (not similarly named Docker Hub images).Common tags:
main — latest build from main
<version> — release tag builds (for example 2026.2.26)
latest — latest stable release tag@改一下配置文件

大意就是

正確鏡像名是：ghcr.io/openclaw/openclaw，而不是Docker Hub上的同名鏡像，鏈接：https://github.com/openclaw/openclaw/pkgs/container/openclaw
常用tag：
main — 最新開(kāi)發(fā)版（不穩(wěn)定）
latest — 穩(wěn)定版本
2026.x.x — 指定版本

所以直接執(zhí)行下面的命令就行, 這一步可能需要魔法。不行的話(huà)去渡渡鳥(niǎo) docker.aityp.com/image/ghcr.… 去下載鏡像，注意電腦架構(gòu)。@改一下配置文件

docker pull ghcr.io/openclaw/openclaw:2026.3.23

2.2 我的目錄結(jié)構(gòu)

openclaw/
├── docker-compose.yml
└── data/
    ├── config/
    └── workspace/

說(shuō)明：

config：存配置（必須）
workspace：工作目錄（可選）

2.3 docker-compose文件

這是我實(shí)際跑通的版本

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:2026.3.23
    container_name: openclaw-gateway
    environment:
      HOME: /home/node
      TERM: xterm-256color
      TZ: Asia/Shanghai
      # 必填 改成你自己的token 下面還有一個(gè)地方的token也得改
      OPENCLAW_GATEWAY_TOKEN: YOUR_TOKEN
      # 是否允許ws（一般不用改）
      OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: "false"
      # Claude 相關(guān)（按需填寫(xiě)）
      CLAUDE_AI_SESSION_KEY: ""
      CLAUDE_WEB_SESSION_KEY: ""
      CLAUDE_WEB_COOKIE: ""
    volumes:
      - ./data/config:/home/node/.openclaw
      # - ./data/workspace:/home/node/.openclaw/workspace
    ports:
      - "18889:18789"   # Web / API
      - "18890:18790"   # 內(nèi)部 bridge
    # restart: unless-stopped # @改一下配置文件
    init: true
    command:
      [ "node", "dist/index.js", "gateway", "--bind", "lan", "--port", "18789",]
    healthcheck:
      test:
        [
          "CMD",
          "node",
          "-e",
          "fetch('http://127.0.0.1:18789/healthz').then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))",
        ]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 20s
  openclaw-cli:
    image: ghcr.io/openclaw/openclaw:2026.3.23
    container_name: openclaw-cli
    network_mode: "service:openclaw-gateway"
    cap_drop:
      - NET_RAW
      - NET_ADMIN
    security_opt:
      - no-new-privileges:true
    environment:
      HOME: /home/node
      TERM: xterm-256color
      TZ: Asia/Shanghai
      OPENCLAW_GATEWAY_TOKEN: YOUR_TOKEN
      OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: "false"
      BROWSER: echo
      CLAUDE_AI_SESSION_KEY: ""
      CLAUDE_WEB_SESSION_KEY: ""
      CLAUDE_WEB_COOKIE: ""
    volumes:
      - ./data/config:/home/node/.openclaw
      # - ./data/workspace:/home/node/.openclaw/workspace
    stdin_open: true
    tty: true
    init: true
    entrypoint: ["node", "dist/index.js"]
    depends_on:
      - openclaw-gateway

三、docker部署流程

看你安裝的是docker compose還是docker-compose，執(zhí)行：

docker-compose run --rm openclaw-cli onboard
docker-compose -f docker-compose.yml run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["*"]' --strict-json
docker-compose -f docker-compose.yml run --rm openclaw-cli config set gateway.controlUi.dangerouslyDisableDeviceAuth true
docker-compose up -d openclaw-gateway

3.1 過(guò)程如下

docker-compose run --rm openclaw-cli onboard
方向鍵控制，回車(chē)確認(rèn)，按空格多選
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  Yes

◇  Setup mode
│  QuickStart

◇  Model/auth provider
│  vLLM

◇  vLLM base URL
│  http://xx.xx.xx.xx:xxxxx/v1
│
◇  vLLM API key
│  token-xxxxxx
│
◇  vLLM model
│  Qwen3

◇  Default model
│  Keep current (vllm/Qwen3)
│
◇  Select channel (QuickStart)
│  Skip for now
│
◇  Search provider
│  Skip for now
│
◇  Configure skills now? (recommended)
│  No
│
◇  Set GOOGLE_PLACES_API_KEY for goplaces?
│  No
│
◇  Set NOTION_API_KEY for notion?
│  No
│
◇  Set OPENAI_API_KEY for openai-whisper-api?
│  No
│
◇  Set ELEVENLABS_API_KEY for sag?
│  No
│
◇  Enable hooks? 按空格多選@改一下配置文件
│  ?? command-logger, ?? session-memory

四、訪問(wèn)地址

因?yàn)槲易隽硕丝谟成洌?/p>

http://127.0.0.1:18889

打開(kāi)看到頁(yè)面，復(fù)制token，密碼不用填就能登錄進(jìn)去@改一下配置文件

五、官方的問(wèn)題

官網(wǎng)是需要git拉下來(lái)之后手動(dòng)build，每次太麻煩了，不如把docker-compose.yml文件復(fù)制下來(lái)改改了。
如果你用官網(wǎng)的build方式，會(huì)生成一個(gè).env文件，可以看openclaw/scripts/docker/setup.sh這個(gè)文件里面。
我之前一直納悶官方docker compose的文件的環(huán)境變量是哪里來(lái)的，結(jié)果找啊找啊在這里找到了@改一下配置文件

以上就是OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)的詳細(xì)內(nèi)容，更多關(guān)于OpenClaw Docker部署踩坑記錄的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

Tag：OpenClaw Docker 部署

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)

目錄

一、選擇docker部署

二、準(zhǔn)備工作

2.1 選擇鏡像

2.2 我的目錄結(jié)構(gòu)

2.3 docker-compose文件

三、docker部署流程

3.1 過(guò)程如下

四、訪問(wèn)地址

五、官方的問(wèn)題

相關(guān)文章

最新評(píng)論

文章分類(lèi)

大家感興趣的內(nèi)容

最近更新的內(nèi)容

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)

目錄

一、選擇docker部署

二、準(zhǔn)備工作

2.1 選擇鏡像

2.2 我的目錄結(jié)構(gòu)

2.3 docker-compose文件

三、docker部署流程

3.1 過(guò)程如下

四、訪問(wèn)地址

五、官方的問(wèn)題

相關(guān)文章

最新評(píng)論

文章分類(lèi)

大家感興趣的內(nèi)容

最近更新的內(nèi)容

二、準(zhǔn)備工作

三、docker部署流程

五、官方的問(wèn)題