Docker

Docker वैकल्पिक है। इसका उपयोग केवल तब करें जब आप कंटेनरीकृत gateway चाहते हों या Docker flow को सत्यापित करना चाहते हों।

क्या Docker मेरे लिए सही है?

• हाँ: आप एक अलग-थलग, अस्थायी gateway परिवेश चाहते हैं या OpenClaw को ऐसे host पर चलाना चाहते हैं जहाँ local installs न हों।
• नहीं: आप अपनी मशीन पर चला रहे हैं और बस सबसे तेज dev loop चाहते हैं। इसके बजाय सामान्य install flow का उपयोग करें।
• Sandboxing नोट: जब sandboxing सक्षम होती है, default sandbox backend Docker का उपयोग करता है, लेकिन sandboxing default रूप से बंद होती है और पूरे gateway को Docker में चलाने की आवश्यकता नहीं होती। SSH और OpenShell sandbox backends भी उपलब्ध हैं। Sandboxing देखें।

पूर्वापेक्षाएँ

• Docker Desktop (या Docker Engine) + Docker Compose v2
• image build के लिए कम से कम 2 GB RAM (pnpm install 1 GB hosts पर exit 137 के साथ OOM-killed हो सकता है)
• images और logs के लिए पर्याप्त disk
• यदि VPS/public host पर चला रहे हैं, तो network exposure के लिए security hardening की समीक्षा करें, विशेष रूप से Docker DOCKER-USER firewall policy।

कंटेनरीकृत gateway

./scripts/docker/setup.sh

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"./scripts/docker/setup.sh

export OPENCLAW_IMAGE="openclaw/openclaw:latest"./scripts/docker/setup.sh

docker load -i openclaw-image.tarexport OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"./scripts/docker/setup.sh --offline

docker compose run --rm openclaw-cli dashboard --no-open

# WhatsApp (QR)docker compose run --rm openclaw-cli channels login # Telegramdocker compose run --rm openclaw-cli channels add --channel telegram --token "<token>" # Discorddocker compose run --rm openclaw-cli channels add --channel discord --token "<token>"

Manual flow

यदि आप setup script का उपयोग करने के बजाय प्रत्येक step स्वयं चलाना पसंद करते हैं:

docker build -t openclaw:local -f Dockerfile .docker compose run --rm --no-deps --entrypoint node openclaw-gateway \  dist/index.js onboard --mode local --no-install-daemondocker compose run --rm --no-deps --entrypoint node openclaw-gateway \  dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789"]}]'docker compose up -d openclaw-gateway

Environment variables

setup script ये optional environment variables स्वीकार करती है:

official Docker image Homebrew ship नहीं करती। onboarding के दौरान, OpenClaw brew-only skill dependency installers को तब छिपाता है जब वह brew के बिना Linux container में चल रहा होता है; वे dependencies custom image द्वारा प्रदान की जानी चाहिए या manually install की जानी चाहिए। Debian packages से उपलब्ध dependencies के लिए, image build के दौरान OPENCLAW_IMAGE_APT_PACKAGES का उपयोग करें। legacy OPENCLAW_DOCKER_APT_PACKAGES नाम अभी भी स्वीकार किया जाता है। Python dependencies के लिए, OPENCLAW_IMAGE_PIP_PACKAGES का उपयोग करें। यह image build के दौरान python3 -m pip install --break-system-packages चलाता है, इसलिए package versions pin करें और केवल उन package indexes का उपयोग करें जिन पर आप भरोसा करते हैं।

Maintainers packaged image के विरुद्ध bundled plugin source test कर सकते हैं, एक plugin source directory को उसके packaged source path पर mount करके, उदाहरण के लिए OPENCLAW_EXTRA_MOUNTS=/path/to/fork/extensions/synology-chat:/app/extensions/synology-chat:ro। वह mounted source directory उसी plugin id के लिए matching compiled /app/dist/extensions/synology-chat bundle को override करती है।

Observability

OpenTelemetry export Gateway container से आपके OTLP collector तक outbound होता है। इसके लिए published Docker port की आवश्यकता नहीं है। यदि आप image local रूप से build करते हैं और bundled OpenTelemetry exporter image के अंदर उपलब्ध चाहते हैं, तो इसकी runtime dependencies शामिल करें:

export OPENCLAW_EXTENSIONS="diagnostics-otel"export OTEL_EXPORTER_OTLP_ENDPOINT="http://otel-collector:4318"export OTEL_SERVICE_NAME="openclaw-gateway"./scripts/docker/setup.sh

packaged Docker installs में export सक्षम करने से पहले ClawHub से official @openclaw/diagnostics-otel Plugin install करें। Custom source-built images अब भी local plugin source को OPENCLAW_EXTENSIONS=diagnostics-otel के साथ शामिल कर सकती हैं। export सक्षम करने के लिए, config में diagnostics-otel Plugin को allow और enable करें, फिर diagnostics.otel.enabled=true set करें या OpenTelemetry export में config example का उपयोग करें। Collector auth headers diagnostics.otel.headers के माध्यम से configure होते हैं, Docker environment variables के माध्यम से नहीं।

Prometheus metrics पहले से published Gateway port का उपयोग करते हैं। Install करें clawhub:@openclaw/diagnostics-prometheus, diagnostics-prometheus Plugin enable करें, फिर scrape करें:

http://<gateway-host>:18789/api/diagnostics/prometheus

route Gateway authentication द्वारा protected है। अलग public /metrics port या unauthenticated reverse-proxy path expose न करें। देखें Prometheus metrics.

Health checks

Container probe endpoints (auth required नहीं):

curl -fsS http://127.0.0.1:18789/healthz   # livenesscurl -fsS http://127.0.0.1:18789/readyz     # readiness

Docker image में built-in HEALTHCHECK शामिल है जो /healthz को ping करता है। यदि checks लगातार fail होते हैं, तो Docker container को unhealthy mark करता है और orchestration systems उसे restart या replace कर सकते हैं।

Authenticated deep health snapshot:

docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN"

LAN बनाम loopback

scripts/docker/setup.sh default रूप से OPENCLAW_GATEWAY_BIND=lan रखता है ताकि http://127.0.0.1:18789 तक host access Docker port publishing के साथ काम करे।

• lan (default): host browser और host CLI published gateway port तक पहुँच सकते हैं।
• loopback: केवल container network namespace के अंदर की processes सीधे gateway तक पहुँच सकती हैं।

Host Local Providers

जब OpenClaw Docker में चलता है, तो container के अंदर 127.0.0.1 container स्वयं होता है, आपकी host machine नहीं। host पर चलने वाले AI providers के लिए host.docker.internal का उपयोग करें:

बंडल किया गया Docker सेटअप उन होस्ट URL को LM Studio और Ollama ऑनबोर्डिंग डिफ़ॉल्ट के रूप में उपयोग करता है, और docker-compose.yml Linux Docker Engine के लिए host.docker.internal को Docker के होस्ट Gateway से मैप करता है। Docker Desktop macOS और Windows पर पहले से वही होस्टनाम उपलब्ध कराता है।

होस्ट सेवाओं को Docker से पहुंच योग्य पते पर भी सुनना चाहिए:

lms server start --port 1234 --bind 0.0.0.0OLLAMA_HOST=0.0.0.0:11434 ollama serve

यदि आप अपनी Compose फ़ाइल या docker run कमांड का उपयोग करते हैं, तो वही होस्ट मैपिंग स्वयं जोड़ें, उदाहरण के लिए --add-host=host.docker.internal:host-gateway.

Docker में Claude CLI बैकएंड

आधिकारिक OpenClaw Docker इमेज Claude Code को पहले से इंस्टॉल नहीं करती। उस कंटेनर उपयोगकर्ता के अंदर Claude Code इंस्टॉल करें और लॉग इन करें जो OpenClaw चलाता है, फिर उस कंटेनर होम को स्थायी रखें ताकि इमेज अपग्रेड बाइनरी या Claude प्रमाणीकरण स्थिति को मिटा न दें।

नए Docker इंस्टॉल के लिए, सेटअप चलाने से पहले एक स्थायी /home/node वॉल्यूम सक्षम करें:

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"export OPENCLAW_HOME_VOLUME="openclaw_home"./scripts/docker/setup.sh

मौजूदा Docker इंस्टॉल के लिए, पहले स्टैक रोकें और सेटअप दोबारा चलाने से पहले वर्तमान Docker .env मान फिर से लोड करें। सेटअप स्क्रिप्ट .env को स्वयं नहीं पढ़ती; यह वर्तमान शेल और डिफ़ॉल्ट से .env को फिर से लिखती है। जनरेट किए गए .env के लिए, चलाएँ:

set -a. ./.envset +aexport OPENCLAW_HOME_VOLUME="${OPENCLAW_HOME_VOLUME:-openclaw_home}"./scripts/docker/setup.sh

यदि आपके .env में ऐसे मान हैं जिन्हें आपका शेल स्रोत नहीं कर सकता, तो पहले उन मौजूदा मानों को मैन्युअल रूप से फिर से export करें जिन पर आप निर्भर हैं, जैसे OPENCLAW_IMAGE, पोर्ट, bind मोड, कस्टम पथ, OPENCLAW_EXTRA_MOUNTS, sandbox, और skip-onboarding सेटिंग्स। जनरेट किया गया overlay openclaw-gateway और openclaw-cli दोनों के लिए होम वॉल्यूम माउंट करता है।

बाकी कमांड जनरेट किए गए Compose overlay के साथ चलाएँ ताकि दोनों सेवाएँ स्थायी होम माउंट करें। यदि आपका सेटअप docker-compose.override.yml भी उपयोग करता है, तो उसे docker-compose.extra.yml से पहले शामिल करें।

उस स्थायी होम में Claude Code इंस्टॉल करें:

docker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  --entrypoint sh openclaw-cli -lc \  'curl -fsSL https://claude.ai/install.sh | bash'

नेटिव इंस्टॉलर claude बाइनरी को /home/node/.local/bin/claude के अंतर्गत लिखता है। OpenClaw को वह कंटेनर पथ उपयोग करने के लिए कहें:

docker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  openclaw-cli config set \  agents.defaults.cliBackends.claude-cli.command \  /home/node/.local/bin/claude

उसी स्थायी कंटेनर होम के अंदर से लॉग इन करें और सत्यापित करें:

docker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  --entrypoint /home/node/.local/bin/claude openclaw-cli auth logindocker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  --entrypoint /home/node/.local/bin/claude openclaw-cli auth status --textdocker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  openclaw-cli models auth login \  --provider anthropic --method cli --set-defaultdocker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  openclaw-cli models list --provider anthropic

उसके बाद, आप बंडल किए गए claude-cli बैकएंड का उपयोग कर सकते हैं:

docker compose -f docker-compose.yml -f docker-compose.extra.yml run --rm \  openclaw-cli agent \  --agent main \  --model claude-cli/claude-sonnet-4-6 \  --message "Say hello from Docker Claude CLI"

OPENCLAW_HOME_VOLUME नेटिव Claude Code इंस्टॉल को /home/node/.local/bin और /home/node/.local/share/claude के अंतर्गत, साथ ही Claude Code सेटिंग्स और प्रमाणीकरण स्थिति को /home/node/.claude और /home/node/.claude.json के अंतर्गत स्थायी रखता है। Claude CLI के पुनः उपयोग के लिए केवल /home/node/.openclaw को स्थायी रखना पर्याप्त नहीं है। यदि आप होम वॉल्यूम के बजाय OPENCLAW_EXTRA_MOUNTS उपयोग करते हैं, तो उन सभी Claude पथों को दोनों Docker सेवाओं में माउंट करें।

Bonjour / mDNS

Docker bridge networking आमतौर पर Bonjour/mDNS multicast (224.0.0.251:5353) को विश्वसनीय रूप से forward नहीं करता। इसलिए बंडल किया गया Compose सेटअप डिफ़ॉल्ट रूप से OPENCLAW_DISABLE_BONJOUR=1 रखता है ताकि bridge द्वारा multicast ट्रैफ़िक छोड़ने पर Gateway crash-loop न करे या बार-बार विज्ञापन restart न करे।

Docker होस्ट के लिए प्रकाशित Gateway URL, Tailscale, या wide-area DNS-SD का उपयोग करें। OPENCLAW_DISABLE_BONJOUR=0 केवल तब सेट करें जब host networking, macvlan, या किसी अन्य नेटवर्क पर चला रहे हों जहाँ mDNS multicast के काम करने की पुष्टि हो।

समस्याओं और troubleshooting के लिए, Bonjour discovery देखें।

स्टोरेज और स्थायित्व

Docker Compose OPENCLAW_CONFIG_DIR को /home/node/.openclaw पर bind-mount करता है, OPENCLAW_WORKSPACE_DIR को /home/node/.openclaw/workspace पर, और OPENCLAW_AUTH_PROFILE_SECRET_DIR को /home/node/.config/openclaw पर, ताकि वे पथ कंटेनर बदलने के बाद भी बने रहें। जब कोई variable unset हो, तो बंडल किया गया docker-compose.yml ${HOME} के अंतर्गत fallback करता है, या जब HOME स्वयं भी न हो तो /tmp पर। इससे bare environments पर docker compose up खाली-source volume spec उत्सर्जित करने से बचता है।

वह माउंट की गई config directory वह जगह है जहाँ OpenClaw रखता है:

• व्यवहार config के लिए openclaw.json
• संग्रहीत प्रदाता OAuth/API-key auth के लिए agents/<agentId>/agent/auth-profiles.json
• env-backed runtime secrets जैसे OPENCLAW_GATEWAY_TOKEN के लिए .env

auth-profile secret key directory OAuth-backed auth profile token material के लिए उपयोग की जाने वाली स्थानीय encryption key संग्रहीत करती है। इसे अपने Docker host state के साथ रखें, लेकिन OPENCLAW_CONFIG_DIR से अलग।

इंस्टॉल किए गए डाउनलोड करने योग्य plugins अपनी package state को माउंट किए गए OpenClaw home के अंतर्गत संग्रहीत करते हैं, इसलिए plugin install records और package roots कंटेनर बदलने के बाद भी बने रहते हैं। Gateway startup bundled-plugin dependency trees जनरेट नहीं करता।

VM deployments पर पूर्ण persistence विवरण के लिए, Docker VM Runtime - What persists where देखें।

डिस्क वृद्धि hotspots: media/, session JSONL files, shared SQLite state database, installed plugin package roots, और rolling file logs /tmp/openclaw/ के अंतर्गत देखें।

शेल helpers (वैकल्पिक)

दैनिक Docker प्रबंधन को आसान बनाने के लिए, ClawDock इंस्टॉल करें:

mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

यदि आपने ClawDock को पुराने scripts/shell-helpers/clawdock-helpers.sh raw path से इंस्टॉल किया था, तो ऊपर दिया install command दोबारा चलाएँ ताकि आपकी local helper file नई जगह को track करे।

फिर clawdock-start, clawdock-stop, clawdock-dashboard, आदि का उपयोग करें। सभी commands के लिए clawdock-help चलाएँ। पूर्ण helper guide के लिए ClawDock देखें।

export OPENCLAW_SANDBOX=1./scripts/docker/setup.sh

export OPENCLAW_SANDBOX=1export OPENCLAW_DOCKER_SOCKET=/run/user/1000/docker.sock./scripts/docker/setup.sh

docker compose run -T --rm openclaw-cli gateway probedocker compose run -T --rm openclaw-cli devices list --json

printf '%s\n' \  'services:' \  '  openclaw-cli:' \  '    cap_drop: !reset []' \  > docker-compose.cli-no-dropped-caps.local.yml docker compose -f docker-compose.yml -f docker-compose.cli-no-dropped-caps.local.yml run --rm openclaw-cli plugins install <package>

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace

FROM node:24-bookwormRUN curl -fsSL https://bun.sh/install | bashENV PATH="/root/.bun/bin:${PATH}"RUN corepack enableWORKDIR /appCOPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./COPY ui/package.json ./ui/package.jsonCOPY scripts ./scriptsRUN pnpm install --frozen-lockfileCOPY . .RUN pnpm buildRUN pnpm ui:installRUN pnpm ui:buildENV NODE_ENV=productionCMD ["node","dist/index.js"]

VPS पर चला रहे हैं?

binary baking, persistence, और updates सहित shared VM deployment steps के लिए Hetzner (Docker VPS) और Docker VM Runtime देखें।

एजेंट सैंडबॉक्स

जब agents.defaults.sandbox Docker backend के साथ enabled हो, तो Gateway agent tool execution (shell, file read/write, आदि) को isolated Docker containers के अंदर चलाता है, जबकि Gateway खुद host पर रहता है। इससे आपको पूरे Gateway को containerize किए बिना untrusted या multi-tenant agent sessions के चारों ओर एक मज़बूत दीवार मिलती है।

Sandbox scope per-agent (default), per-session, या shared हो सकता है। हर scope को /workspace पर mounted अपना workspace मिलता है। आप allow/deny tool policies, network isolation, resource limits, और browser containers भी configure कर सकते हैं।

पूरी configuration, images, security notes, और multi-agent profiles के लिए देखें:

• Sandboxing -- पूरा sandbox संदर्भ
• OpenShell -- sandbox containers के लिए interactive shell access
• Multi-Agent Sandbox and Tools -- per-agent overrides

जल्दी enable करें

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // off | non-main | all        scope: "agent", // session | agent | shared      },    },  },}

default sandbox image build करें (source checkout से):

scripts/sandbox-setup.sh

source checkout के बिना npm installs के लिए, inline docker build commands के लिए Sandboxing § Images and setup देखें।

समस्या निवारण

docker compose run --rm openclaw-cli dashboard --no-opendocker compose run --rm openclaw-cli devices listdocker compose run --rm openclaw-cli devices approve <requestId>

docker compose run --rm openclaw-cli config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"}]'docker compose run --rm openclaw-cli devices list --url ws://127.0.0.1:18789

संबंधित

• Install Overview — सभी installation methods
• Podman — Docker का Podman alternative
• ClawDock — Docker Compose community setup
• Updating — OpenClaw को up to date रखना
• Configuration — install के बाद Gateway configuration