OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)
發(fā)布時間：2026-03-26 16:41:27 作者：改一下配置文件 
我要評論
我要評論文章詳細記錄了使用Docker部署OpenClaw的全過程,強調了使用官方鏡像而非本地build的重要性,并提供了完整的docker-compose配置文件,文章還指導了部署流程和訪問地址,最后解釋了官方文檔中環(huán)境變量的來源,需要的朋友可以參考下
很多人第一次部署 OpenClaw，都會踩一個坑： 官方文檔默認讓你 clone + build + 配環(huán)境變量 但實際體驗下來只有兩個字：折騰 這篇文章，我直接給你一套更干凈、更穩(wěn)定的方案：純Docker Compose部署（無需本地build）
一、選擇docker部署
- 不污染宿主機 → Node、依賴、配置全部隔離在容器里
- 不會和本地環(huán)境沖突 → 不用擔心你機器上已有 Node/npm/版本問題
- 可復制性極強 → 同一份
docker-compose.yml，在哪都能跑@改一下配置文件
二、準備工作
2.1 選擇鏡像
之前的文檔里面有下面這段話，現(xiàn)在不知道為啥沒有了。鏈接：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 — 最新開發(fā)版（不穩(wěn)定） latest — 穩(wěn)定版本 2026.x.x — 指定版本
所以直接執(zhí)行下面的命令就行, 這一步可能需要魔法。不行的話去渡渡鳥 docker.aityp.com/image/ghcr.… 去下載鏡像，注意電腦架構。@改一下配置文件
docker pull ghcr.io/openclaw/openclaw:2026.3.23
2.2 我的目錄結構
openclaw/
├── docker-compose.yml
└── data/
├── config/
└── workspace/
說明：
config：存配置（必須）workspace：工作目錄（可選）
2.3 docker-compose文件
這是我實際跑通的版本
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 下面還有一個地方的token也得改
OPENCLAW_GATEWAY_TOKEN: YOUR_TOKEN
# 是否允許ws（一般不用改）
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: "false"
# Claude 相關（按需填寫）
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 過程如下
docker-compose run --rm openclaw-cli onboard 方向鍵控制，回車確認，按空格多選 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
四、訪問地址
因為我做了端口映射：
http://127.0.0.1:18889
打開看到頁面，復制token，密碼不用填就能登錄進去@改一下配置文件
五、官方的問題
- 官網(wǎng)是需要git拉下來之后手動build，每次太麻煩了，不如把docker-compose.yml文件復制下來改改了。
- 如果你用官網(wǎng)的build方式，會生成一個.env文件，可以看openclaw/scripts/docker/setup.sh這個文件里面。
- 我之前一直納悶官方docker compose的文件的環(huán)境變量是哪里來的，結果找啊找啊在這里找到了@改一下配置文件
以上就是OpenClaw Docker部署踩坑全記錄(OpenClaw v2026.3.23)的詳細內(nèi)容，更多關于OpenClaw Docker部署踩坑記錄的資料請關注腳本之家其它相關文章！
相關文章
一文教你OpenClaw Docker 部署并調用本地Qwen3.5 9B模型
本文詳細介紹了在 Ubuntu 24.04 系統(tǒng)上通過 Docker 部署 Ollama 并運行 Qwen3.5-9B的完整流程，同時對接 OpenClaw 實現(xiàn) Web 交互,文中通過示例代碼介紹的非常詳細，需要的2026-03-12
Windows、macOS、Linux三系統(tǒng)本地部署OpenClaw+避坑指南+Docker一鍵部署,30分鐘搞定
本文給大家分享全網(wǎng)最全的OpenClaw安裝部署教程，覆蓋Windows、macOS、Linux三系統(tǒng)本地部署，并最終提供Docker一鍵部署方案，感興趣的朋友一起看看吧2026-03-10
本文詳細介紹了在MacBook Air M4芯片上使用Docker部署OpenClaw的過程,通過本文的步驟和技巧,讀者可以成功部署并使用OpenClaw作為智能助理，感興趣的朋友跟隨小編一起看看吧2026-03-05
