Docker

Docker वैकल्पिक है। इसका उपयोग अलग-थलग, अस्थायी Gateway परिवेश या स्थानीय इंस्टॉल रहित होस्ट के लिए करें। यदि आप पहले से अपनी मशीन पर विकास करते हैं, तो इसके बजाय सामान्य इंस्टॉल प्रक्रिया का उपयोग करें।

agents.defaults.sandbox सक्षम होने पर डिफ़ॉल्ट सैंडबॉक्स बैकएंड Docker का उपयोग करता है, लेकिन सैंडबॉक्सिंग डिफ़ॉल्ट रूप से बंद रहती है और इसके लिए Gateway को स्वयं Docker में चलाने की आवश्यकता नहीं होती। SSH और OpenShell सैंडबॉक्स बैकएंड भी उपलब्ध हैं; सैंडबॉक्सिंग देखें।

एकाधिक उपयोगकर्ताओं को होस्ट कर रहे हैं? प्रति टेनेंट एक सेल वाले मॉडल के लिए मल्टी-टेनेंट होस्टिंग देखें।

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

• Docker Desktop (या Docker Engine) + Docker Compose v2
• इमेज बिल्ड के लिए कम-से-कम 2 GB RAM (1 GB होस्ट पर pnpm install को निकास 137 के साथ OOM के कारण बंद किया जा सकता है)
• इमेज और लॉग के लिए पर्याप्त डिस्क स्थान
• VPS/सार्वजनिक होस्ट पर, नेटवर्क एक्सपोज़र के लिए सुरक्षा सुदृढ़ीकरण, विशेष रूप से Docker DOCKER-USER फ़ायरवॉल चेन की समीक्षा करें

कंटेनरयुक्त 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>"

मैन्युअल प्रक्रिया

BUILD_GIT_COMMIT="$(git rev-parse HEAD)"BUILD_TIMESTAMP="$(date -u +%Y-%m-%dT%H:%M:%SZ)"docker build \  --build-arg "GIT_COMMIT=${BUILD_GIT_COMMIT}" \  --build-arg "OPENCLAW_BUILD_TIMESTAMP=${BUILD_TIMESTAMP}" \  -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

Docker संदर्भ में .git शामिल नहीं है। ऊपर दिखाए अनुसार स्रोत पहचान को बिल्ड आर्ग्युमेंट के रूप में दें, ताकि इमेज की About स्क्रीन चेक-आउट किए गए कमिट और एक बिल्ड टाइमस्टैम्प की सूचना दे। scripts/docker/setup.sh दोनों मान स्वचालित रूप से हल करके भेजता है।

कंटेनर इमेज अपग्रेड करना

जब आप OpenClaw इमेज बदलते हैं लेकिन वही माउंट की गई स्थिति/कॉन्फ़िगरेशन बनाए रखते हैं, तो नया Gateway तैयार होने से पहले स्टार्टअप-सुरक्षित अपग्रेड माइग्रेशन और Plugin अभिसरण चलाता है। नियमित इमेज अपग्रेड के लिए अलग openclaw doctor --fix प्रक्रिया की आवश्यकता नहीं होनी चाहिए।

यदि स्टार्टअप उन सुधारों को सुरक्षित रूप से पूरा नहीं कर सकता, तो Gateway स्वस्थ स्थिति की सूचना देने के बजाय बाहर निकल जाता है। पुनः प्रारंभ नीति होने पर Docker, Podman या Kubernetes में Gateway कंटेनर पुनः प्रारंभ होता हुआ दिखाई दे सकता है। माउंट किया हुआ स्थिति वॉल्यूम बनाए रखें, फिर उसी इमेज को एक बार कंटेनर कमांड के रूप में openclaw doctor --fix के साथ चलाएँ और वही स्थिति/कॉन्फ़िगरेशन माउंट उपयोग करें जिन्हें Gateway उपयोग करता है:

docker run --rm -v <openclaw-state>:/home/node/.openclaw <image> openclaw doctor --fixpodman run --rm -v <openclaw-state>:/home/node/.openclaw <image> openclaw doctor --fix

डॉक्टर पूरा होने के बाद Gateway कंटेनर को उसके डिफ़ॉल्ट कमांड के साथ पुनः प्रारंभ करें। Kubernetes में वही कमांड एकबारगी Job या उसी PVC पर माउंट किए गए डीबग पॉड में चलाएँ, फिर Deployment या StatefulSet पुनः प्रारंभ करें।

पर्यावरण चर

scripts/docker/setup.sh द्वारा स्वीकार किए जाने वाले वैकल्पिक चर (और Gateway कंटेनर के लिए सीधे docker-compose.yml द्वारा):

आधिकारिक इमेज में Homebrew शामिल नहीं है। ऑनबोर्डिंग के दौरान, OpenClaw brew रहित Linux कंटेनर में केवल-brew Skills निर्भरता इंस्टॉलर छिपाता है; वे निर्भरताएँ कस्टम इमेज के माध्यम से उपलब्ध कराएँ या मैन्युअल रूप से इंस्टॉल करें। Debian-पैकेज वाली निर्भरताओं के लिए OPENCLAW_IMAGE_APT_PACKAGES और Python निर्भरताओं के लिए OPENCLAW_IMAGE_PIP_PACKAGES का उपयोग करें (यह बिल्ड के समय python3 -m pip install --break-system-packages चलाता है, इसलिए संस्करण पिन करें और केवल विश्वसनीय इंडेक्स का उपयोग करें)।

यदि Docker ResourceExhausted, cannot allocate memory की सूचना देता है या tsdown के दौरान निरस्त हो जाता है, तो Docker बिल्डर की मेमोरी सीमा बढ़ाएँ या छोटे स्पष्ट हीप के साथ पुनः प्रयास करें:

OPENCLAW_DOCKER_BUILD_NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_DOCKER_BUILD_TSDOWN_MAX_OLD_SPACE_MB=4096

चयनित plugins वाली स्रोत से बनी इमेज

OPENCLAW_EXTENSIONS स्रोत चेकआउट से Plugin मेनिफ़ेस्ट आईडी चुनता है; अलग होने पर मौजूदा स्रोत-डायरेक्टरी नाम भी स्वीकार किए जाते हैं। Docker बिल्ड चयन को एक बार स्रोत डायरेक्टरियों में बदलता है, प्रोडक्शन निर्भरताएँ इंस्टॉल करता है और, जब कोई चयनित Plugin openclaw.build.bundledDist: false के साथ अलग से प्रकाशित होता है, तो उसके रनटाइम को रूट बंडल किए गए dist में कंपाइल करता है। केवल Docker की यह पैकेजिंग Plugin के npm या ClawHub आर्टिफ़ैक्ट अनुबंध को नहीं बदलती। अज्ञात, अमान्य या अस्पष्ट आईडी से इमेज बिल्ड विफल हो जाता है। ज्ञात निर्भरता/केवल-स्रोत आईडी, कंपाइल की गई रूट dist प्रविष्टि प्राप्त किए बिना, अपनी मौजूदा स्रोत और निर्भरता स्टेजिंग बनाए रखते हैं। एकीकृत बिल्ड प्रविष्टियों वाले चयनित Plugin को सफलतापूर्वक कंपाइल होना आवश्यक है; अचयनित बाहरी Plugin स्रोत और रनटाइम आउटपुट हटा दिए जाते हैं।

उदाहरण के लिए, ये कमांड ClickClack, Slack और Microsoft Teams के लिए अलग-अलग, बहु-आर्किटेक्चर स्टैंडअलोन FakeCo Gateway इमेज बनाते हैं। ClawRouter पहले से ही रूट OpenClaw रनटाइम का भाग है, इसलिए ClickClack इमेज केवल clickclack चुनती है। स्पष्ट रूप से खाली ब्राउज़र आर्ग्युमेंट डिफ़ॉल्ट इमेज को Chromium से मुक्त रखता है:

SOURCE_SHA="$(git rev-parse HEAD)"BUILD_TIMESTAMP="$(date -u +%Y-%m-%dT%H:%M:%SZ)"REGISTRY="registry.example.com/fakeco" build_gateway_image() {  gateway="$1"  selected_plugin="$2"  docker buildx build \    --platform linux/amd64,linux/arm64 \    --build-arg "GIT_COMMIT=${SOURCE_SHA}" \    --build-arg "OPENCLAW_BUILD_TIMESTAMP=${BUILD_TIMESTAMP}" \    --build-arg "OPENCLAW_EXTENSIONS=${selected_plugin}" \    --build-arg OPENCLAW_INSTALL_BROWSER= \    --provenance=mode=max \    --sbom=true \    --tag "${REGISTRY}/openclaw-${gateway}:${SOURCE_SHA}" \    --push \    .} build_gateway_image clickclack clickclackbuild_gateway_image slack slackbuild_gateway_image teams msteams

एकल नेटिव स्थानीय बिल्ड के लिए --platform linux/arm64 --load या --platform linux/amd64 --load का उपयोग करें। बहु-प्लेटफ़ॉर्म आउटपुट और संलग्न SBOM/प्रोवेनेंस के लिए ऐसी रजिस्ट्री या अन्य Buildx आउटपुट आवश्यक है जो सत्यापन विवरणों को सुरक्षित रखता हो। पुश करने के बाद, मेनिफ़ेस्ट की जाँच करें और परिवर्तनशील स्रोत-SHA टैग के बजाय अपरिवर्तनीय डाइजेस्ट डिप्लॉय करें:

docker buildx imagetools inspect \  "${REGISTRY}/openclaw-clickclack:${SOURCE_SHA}"# डिप्लॉय करें: registry.example.com/fakeco/openclaw-clickclack@sha256:<manifest-digest>

ये इमेज स्टैंडअलोन OCI-आधारित Gateway और सामान्य Docker उपयोगकर्ताओं के लिए हैं। Crabhelm द्वारा प्रबंधित Gateway इनका उपयोग नहीं करते: वह डिलीवरी पथ एक अलग x86_64 अप्लायंस आर्काइव बनाता है जिसमें OpenClaw npm टारबॉल होता है और Node, आर्काइव तथा मेनिफ़ेस्ट डाइजेस्ट पिन किए जाते हैं। उस अप्लायंस को उसी लैंड किए गए OpenClaw स्रोत से स्वतंत्र रूप से बनाएँ।

पैकेज की गई इमेज के विरुद्ध बंडल किए गए Plugin स्रोत का परीक्षण करने के लिए, एक Plugin स्रोत डायरेक्टरी को उसके पैकेज किए गए स्रोत पथ पर माउंट करें, जैसे OPENCLAW_EXTRA_MOUNTS=/path/to/fork/extensions/synology-chat:/app/extensions/synology-chat:ro। यह उसी Plugin आईडी के मेल खाते कंपाइल किए गए /app/dist/extensions/synology-chat बंडल को ओवरराइड करता है।

अवलोकनीयता

OpenTelemetry निर्यात Gateway कंटेनर से आपके OTLP कलेक्टर की ओर आउटबाउंड होता है; इसके लिए कोई Docker पोर्ट प्रकाशित करने की आवश्यकता नहीं है। स्थानीय रूप से बनाई गई इमेज में बंडल किया गया एक्सपोर्टर शामिल करने के लिए:

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

आधिकारिक पूर्वनिर्मित इमेज में diagnostics-otel पहले से बंडल होता है; केवल तभी clawhub:@openclaw/diagnostics-otel स्वयं इंस्टॉल करें, जब आपने इसे हटा दिया हो। निर्यात सक्षम करने के लिए, कॉन्फ़िग में diagnostics-otel Plugin को अनुमति देकर सक्षम करें, फिर diagnostics.otel.enabled=true सेट करें (OpenTelemetry निर्यात में पूरा उदाहरण देखें)। कलेक्टर प्रमाणीकरण हेडर Docker पर्यावरण वेरिएबल के बजाय diagnostics.otel.headers के माध्यम से जाते हैं।

Prometheus मेट्रिक्स पहले से प्रकाशित Gateway पोर्ट का पुनः उपयोग करते हैं। clawhub:@openclaw/diagnostics-prometheus इंस्टॉल करें, diagnostics-prometheus Plugin सक्षम करें, फिर स्क्रेप करें:

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

यह रूट Gateway प्रमाणीकरण से सुरक्षित है; अलग सार्वजनिक /metrics पोर्ट या अप्रमाणीकृत रिवर्स-प्रॉक्सी पथ उजागर न करें। Prometheus मेट्रिक्स देखें।

स्वास्थ्य जाँच

कंटेनर प्रोब एंडपॉइंट (प्रमाणीकरण आवश्यक नहीं):

curl -fsS http://127.0.0.1:18789/healthz   # सक्रियताcurl -fsS http://127.0.0.1:18789/readyz     # तत्परता

इमेज का अंतर्निहित HEALTHCHECK, /healthz को पिंग करता है; बार-बार विफलता होने पर कंटेनर को unhealthy चिह्नित किया जाता है, ताकि ऑर्केस्ट्रेटर उसे पुनः आरंभ या प्रतिस्थापित कर सकें।

प्रमाणीकृत विस्तृत स्वास्थ्य स्नैपशॉट:

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

LAN बनाम लूपबैक

scripts/docker/setup.sh का डिफ़ॉल्ट OPENCLAW_GATEWAY_BIND=lan है, ताकि होस्ट पर http://127.0.0.1:18789, Docker पोर्ट प्रकाशन के साथ काम करे।

• lan (डिफ़ॉल्ट): होस्ट ब्राउज़र और होस्ट CLI प्रकाशित Gateway पोर्ट तक पहुँच सकते हैं।
• loopback: केवल कंटेनर नेटवर्क नेमस्पेस के अंदर की प्रक्रियाएँ सीधे Gateway तक पहुँच सकती हैं।

होस्ट के स्थानीय प्रोवाइडर

कंटेनर के अंदर, 127.0.0.1 स्वयं कंटेनर है, होस्ट नहीं। होस्ट पर चल रहे प्रोवाइडर के लिए host.docker.internal का उपयोग करें:

बंडल किया गया सेटअप उन URL को LM Studio/Ollama ऑनबोर्डिंग डिफ़ॉल्ट के रूप में उपयोग करता है, और docker-compose.yml, Linux Docker Engine पर host.docker.internal को होस्ट 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 बैकएंड

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

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

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

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

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

यदि .env में ऐसे मान हैं जिन्हें आपका शेल सोर्स नहीं कर सकता, तो पहले जिन पर आप निर्भर हैं उन्हें मैन्युअल रूप से पुनः एक्सपोर्ट करें (OPENCLAW_IMAGE, पोर्ट, बाइंड मोड, कस्टम पथ, OPENCLAW_EXTRA_MOUNTS, सैंडबॉक्स, ऑनबोर्डिंग छोड़ना)। जनरेट किया गया ओवरले openclaw-gateway और openclaw-cli दोनों के लिए होम वॉल्यूम माउंट करता है; शेष कमांड उस ओवरले के साथ चलाएँ (और यदि आप किसी docker-compose.override.yml का उपयोग करते हैं, तो उसे पहले रखें):

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 "Docker Claude CLI से नमस्ते कहें"

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

Bonjour / mDNS

Docker ब्रिज नेटवर्किंग आमतौर पर Bonjour/mDNS मल्टीकास्ट (224.0.0.251:5353) को विश्वसनीय रूप से अग्रेषित नहीं करती। जब OPENCLAW_DISABLE_BONJOUR सेट नहीं होता, तो बंडल किया गया Bonjour Plugin कंटेनर में चलने का पता लगाते ही LAN विज्ञापन स्वतः अक्षम कर देता है, ताकि ब्रिज द्वारा छोड़े गए मल्टीकास्ट को बार-बार आज़माते हुए क्रैश-लूप न हो। पहचान की परवाह किए बिना इसे बंद करने के लिए OPENCLAW_DISABLE_BONJOUR=1 सेट करें, या इसे चालू करने के लिए 0 सेट करें (केवल होस्ट नेटवर्किंग, macvlan या ऐसे अन्य नेटवर्क पर जहाँ mDNS मल्टीकास्ट का काम करना ज्ञात हो)।

अन्यथा Docker होस्ट के लिए प्रकाशित Gateway URL, Tailscale या वाइड-एरिया DNS-SD का उपयोग करें। सावधानियों और समस्या निवारण के लिए Bonjour खोज देखें।

संग्रहण और स्थायित्व

Docker Compose, OPENCLAW_CONFIG_DIR को /home/node/.openclaw, OPENCLAW_WORKSPACE_DIR को /home/node/.openclaw/workspace, और OPENCLAW_AUTH_PROFILE_SECRET_DIR को /home/node/.config/openclaw पर बाइंड-माउंट करता है, इसलिए ये पथ कंटेनर प्रतिस्थापन के बाद भी बने रहते हैं। जब कोई वेरिएबल सेट नहीं होता, तो docker-compose.yml, ${HOME} के अंतर्गत फ़ॉलबैक करता है, या यदि स्वयं HOME अनुपस्थित हो तो /tmp के अंतर्गत, ताकि सामान्य परिवेशों में docker compose up कभी भी खाली-स्रोत वॉल्यूम विनिर्देश न बनाए।

उस माउंट की गई कॉन्फ़िग डायरेक्टरी में ये होते हैं:

• openclaw.json व्यवहार कॉन्फ़िग के लिए
• agents/<agentId>/agent/auth-profiles.json संग्रहीत प्रोवाइडर OAuth/API-कुंजी प्रमाणीकरण के लिए
• .env OPENCLAW_GATEWAY_TOKEN जैसे पर्यावरण-समर्थित रनटाइम सीक्रेट के लिए

प्रमाणीकरण-प्रोफ़ाइल सीक्रेट डायरेक्टरी, OAuth-समर्थित प्रमाणीकरण प्रोफ़ाइल टोकन सामग्री के लिए स्थानीय एन्क्रिप्शन कुंजी संग्रहीत करती है। इसे अपनी Docker होस्ट स्थिति के साथ रखें, लेकिन OPENCLAW_CONFIG_DIR से अलग रखें।

इंस्टॉल किए गए डाउनलोड करने योग्य Plugin, माउंट किए गए OpenClaw होम के अंतर्गत पैकेज स्थिति संग्रहीत करते हैं, इसलिए इंस्टॉल रिकॉर्ड और पैकेज रूट कंटेनर प्रतिस्थापन के बाद भी बने रहते हैं; Gateway स्टार्टअप बंडल किए गए Plugin की निर्भरता ट्री दोबारा जनरेट नहीं करता।

पूर्ण VM स्थायित्व विवरण के लिए, Docker VM रनटाइम - कहाँ क्या बना रहता है देखें।

डिस्क वृद्धि के प्रमुख स्थान: media/, प्रति-एजेंट SQLite डेटाबेस, पुराने सत्र JSONL ट्रांसक्रिप्ट, साझा SQLite स्थिति डेटाबेस, इंस्टॉल किए गए Plugin पैकेज रूट और /tmp/openclaw/ के अंतर्गत रोलिंग फ़ाइल लॉग।

शेल सहायक (वैकल्पिक)

रोज़मर्रा के छोटे कमांड के लिए, 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

यदि आपने पुराने scripts/shell-helpers/clawdock-helpers.sh पथ से इंस्टॉल किया था, तो ऊपर दिया गया कमांड फिर से चलाएँ, ताकि आपका स्थानीय सहायक वर्तमान स्थान को ट्रैक करे। इसके बाद clawdock-start, clawdock-stop, clawdock-dashboard, आदि का उपयोग करें (पूरी सूची के लिए clawdock-help चलाएँ)।

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 पर चला रहे हैं?

बाइनरी को इमेज में शामिल करने, स्थायित्व और अपडेट सहित साझा VM परिनियोजन चरणों के लिए Hetzner (Docker VPS) और Docker VM रनटाइम देखें।

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

जब Docker बैकएंड के साथ agents.defaults.sandbox सक्षम होता है, तो Gateway एजेंट टूल निष्पादन (शेल, फ़ाइल पढ़ना/लिखना आदि) को अलग-थलग Docker कंटेनरों के भीतर चलाता है, जबकि Gateway स्वयं होस्ट पर रहता है—इससे पूरे Gateway को कंटेनर में डाले बिना अविश्वसनीय या बहु-टेनेंट एजेंट सत्रों के चारों ओर एक कठोर सुरक्षा-दीवार बनती है।

सैंडबॉक्स का दायरा प्रति-एजेंट (डिफ़ॉल्ट), प्रति-सत्र या साझा हो सकता है; प्रत्येक दायरे को /workspace पर माउंट किया गया अपना कार्यक्षेत्र मिलता है। आप अनुमति/अस्वीकृति टूल नीतियाँ, नेटवर्क पृथक्करण, संसाधन सीमाएँ और ब्राउज़र कंटेनर भी कॉन्फ़िगर कर सकते हैं।

पूर्ण कॉन्फ़िगरेशन, इमेज, सुरक्षा नोट और बहु-एजेंट प्रोफ़ाइल के लिए:

• सैंडबॉक्सिंग -- संपूर्ण सैंडबॉक्स संदर्भ
• OpenShell -- सैंडबॉक्स कंटेनरों तक इंटरैक्टिव शेल पहुँच
• बहु-एजेंट सैंडबॉक्स और टूल -- प्रति-एजेंट ओवरराइड

तुरंत सक्षम करें

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // बंद | गैर-मुख्य | सभी        scope: "agent", // सत्र | एजेंट | साझा      },    },  },}

डिफ़ॉल्ट सैंडबॉक्स इमेज बनाएँ (स्रोत चेकआउट से):

scripts/sandbox-setup.sh

स्रोत चेकआउट के बिना npm इंस्टॉल के लिए, इनलाइन docker build कमांड हेतु सैंडबॉक्सिंग § इमेज और सेटअप देखें।

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

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

संबंधित

• इंस्टॉलेशन अवलोकन — सभी इंस्टॉलेशन विधियाँ
• Podman — Docker का Podman विकल्प
• ClawDock — Docker Compose सामुदायिक सेटअप
• अपडेट करना — OpenClaw को अद्यतित रखना
• कॉन्फ़िगरेशन — इंस्टॉल के बाद Gateway कॉन्फ़िगरेशन