Docker

Docker اختياري. استخدمه لبيئة Gateway معزولة وقابلة للتخلص منها، أو على مضيف بلا عمليات تثبيت محلية. إذا كنت تطوّر بالفعل على جهازك، فاستخدم مسار التثبيت المعتاد بدلًا من ذلك.

تستخدم الواجهة الخلفية الافتراضية للعزل Docker عند تمكين agents.defaults.sandbox، لكن العزل معطّل افتراضيًا ولا يتطلب تشغيل Gateway نفسه داخل Docker. تتوفر أيضًا واجهات خلفية للعزل عبر SSH وOpenShell؛ راجع العزل.

هل تستضيف عدة مستخدمين؟ راجع الاستضافة متعددة المستأجرين للاطلاع على نموذج خلية واحدة لكل مستأجر.

المتطلبات الأساسية

• Docker Desktop (أو Docker Engine) + Docker Compose v2
• ذاكرة RAM بسعة 2 GB على الأقل لبناء الصورة (قد تُنهى pnpm install بسبب نفاد الذاكرة على مضيفين بسعة 1 GB مع رمز الخروج 137)
• مساحة قرص كافية للصور والسجلات
• على VPS/مضيف عام، راجع تعزيز الأمان عند التعرض للشبكة، ولا سيما سلسلة جدار الحماية DOCKER-USER في Docker

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. مرّر هوية المصدر كوسيطات بناء كما هو موضح أعلاه، لكي تعرض شاشة «حول» في الصورة الالتزام المسحوب وطابعًا زمنيًا واحدًا للبناء. يحل 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

بعد انتهاء أداة doctor، أعد تشغيل حاوية Gateway باستخدام أمرها الافتراضي. في Kubernetes، شغّل الأمر نفسه ضمن Job لمرة واحدة أو حجرة تصحيح أخطاء موصولة بوحدة PVC نفسها، ثم أعد تشغيل Deployment أو StatefulSet.

متغيرات البيئة

المتغيرات الاختيارية التي تقبلها scripts/docker/setup.sh (وكذلك docker-compose.yml مباشرةً بالنسبة إلى حاوية Gateway):

لا تتضمن الصورة الرسمية Homebrew. أثناء التهيئة الأولية، يخفي OpenClaw مثبّتات اعتماديات Skills التي تعمل عبر brew فقط داخل حاوية Linux لا تحتوي على brew؛ وفّر تلك الاعتماديات من خلال صورة مخصصة أو ثبّتها يدويًا. استخدم OPENCLAW_IMAGE_APT_PACKAGES للاعتماديات المحزّمة لـ Debian وOPENCLAW_IMAGE_PIP_PACKAGES لاعتماديات Python (يشغّل 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 يحدّد معرّفات بيانات تعريف Plugins من نسخة المصدر؛ كما تُقبل أسماء أدلة المصدر الحالية عندما تختلف. يحوّل بناء Docker التحديد إلى أدلة مصدر مرة واحدة، ويثبّت تبعيات الإنتاج، وعندما يُنشر Plugin محدد بصورة منفصلة باستخدام openclaw.build.bundledDist: false، يترجم وقت تشغيله إلى حزمة dist الجذرية المضمّنة. لا تغيّر هذه الحزمة الخاصة بـ Docker عقد عناصر npm أو ClawHub الخاصة بالـ Plugin. تؤدي المعرّفات المجهولة أو غير الصالحة أو الملتبسة إلى فشل بناء الصورة. تحتفظ معرّفات التبعيات/المصدر فقط المعروفة بتجهيز المصدر والتبعيات الحالي من دون الحصول على مُدخل dist جذري مترجم. يجب أن ينجح تجميع Plugin محدد ذي مُدخلات بناء موحّدة؛ وتُزال مخرجات المصدر ووقت التشغيل الخاصة بـ Plugins الخارجية غير المحددة.

على سبيل المثال، تنشئ هذه الأوامر صور Gateway مستقلة ومنفصلة ومتعددة البنى لـ FakeCo من أجل ClickClack وSlack وMicrosoft Teams. يشكّل 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 ولمستخدمي Docker العموميين. لا تستخدمها البوابات التي يديرها Crabhelm: إذ ينشئ مسار التسليم هذا أرشيف جهاز x86_64 منفصلًا يحتوي على حزمة OpenClaw من npm ويثبّت ملخصات Node والأرشيف والبيان. أنشئ ذلك الجهاز بصورة مستقلة من مصدر OpenClaw المدمج نفسه.

لاختبار مصدر Plugin مضمّن مقابل صورة محزّمة، ثبّت دليل مصدر Plugin واحدًا فوق مسار مصدره المحزّم، مثل OPENCLAW_EXTRA_MOUNTS=/path/to/fork/extensions/synology-chat:/app/extensions/synology-chat:ro. يتجاوز ذلك حزمة /app/dist/extensions/synology-chat المترجمة المطابقة لمعرّف Plugin نفسه.

قابلية الرصد

يكون تصدير 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 بنفسك فقط إذا أزلته. لتمكين التصدير، اسمح بالـ Plugin ‏diagnostics-otel وفعّله في الإعدادات، ثم عيّن diagnostics.otel.enabled=true (راجع المثال الكامل في تصدير OpenTelemetry). تمر ترويسات مصادقة الجامع عبر diagnostics.otel.headers، وليس عبر متغيرات بيئة Docker.

تعيد مقاييس Prometheus استخدام منفذ Gateway المنشور بالفعل. ثبّت clawhub:@openclaw/diagnostics-prometheus، وفعّل Plugin ‏diagnostics-prometheus، ثم نفّذ الاستخلاص:

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"

الشبكة المحلية مقابل الاسترجاع الحلقي

يضبط 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 ‏host.docker.internal ببوابة المضيف على Docker Engine في Linux (يوفّر 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.

الواجهة الخلفية لـ Claude CLI في Docker

لا تثبّت الصورة الرسمية 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 "قل مرحبًا من Claude CLI داخل Docker"

يجعل OPENCLAW_HOME_VOLUME التثبيت الأصلي دائمًا ضمن /home/node/.local/bin و/home/node/.local/share/claude، بالإضافة إلى إعدادات/مصادقة Claude Code ضمن /home/node/.claude و/home/node/.claude.json. لا يكفي جعل /home/node/.openclaw دائمًا وحده؛ إذا كنت تستخدم OPENCLAW_EXTRA_MOUNTS بدلًا من وحدة تخزين رئيسية، فثبّت جميع مسارات Claude تلك في كلتا الخدمتين.

Bonjour / mDNS

لا تمرّر شبكة جسر Docker عادةً بث Bonjour/mDNS المتعدد (224.0.0.251:5353) بصورة موثوقة. عندما لا يكون OPENCLAW_DISABLE_BONJOUR معيّنًا، يعطّل Plugin ‏Bonjour المضمّن تلقائيًا الإعلان على الشبكة المحلية بمجرد اكتشاف أنه يعمل داخل حاوية، كي لا يدخل في حلقة أعطال أثناء إعادة محاولة البث المتعدد الذي يسقطه الجسر. عيّن OPENCLAW_DISABLE_BONJOUR=1 لفرض تعطيله بصرف النظر عن الاكتشاف، أو 0 لفرض تفعيله (على شبكة المضيف أو macvlan أو شبكة أخرى يُعرف أن بث mDNS المتعدد يعمل عليها فقط).

استخدم عنوان URL المنشور لـ Gateway أو Tailscale أو DNS-SD واسع النطاق لمضيفي Docker في الحالات الأخرى. راجع اكتشاف 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}، أو /tmp إذا كان HOME نفسه مفقودًا، بحيث لا يُنتج docker compose up أبدًا مواصفة وحدة تخزين ذات مصدر فارغ في البيئات الأساسية.

يحتوي دليل الإعدادات المثبّت على:

• openclaw.json لإعدادات السلوك
• agents/<agentId>/agent/auth-profiles.json لمصادقة OAuth/مفتاح API المخزنة الخاصة بالمزوّد
• .env لأسرار وقت التشغيل المدعومة بالبيئة مثل OPENCLAW_GATEWAY_TOKEN

يخزّن دليل أسرار ملف تعريف المصادقة مفتاح التشفير المحلي لمواد رموز ملف تعريف المصادقة المدعومة بـ OAuth. احتفظ به مع حالة مضيف Docker، لكن بصورة منفصلة عن OPENCLAW_CONFIG_DIR.

تخزّن Plugins المثبّتة القابلة للتنزيل حالة الحزمة ضمن مجلد OpenClaw الرئيسي المثبّت، بحيث تبقى سجلات التثبيت وجذور الحزم بعد استبدال الحاوية؛ ولا تعيد بداية تشغيل Gateway إنشاء أشجار تبعيات Plugins المضمّنة.

للحصول على التفاصيل الكاملة حول الاستمرارية في الجهاز الافتراضي، راجع وقت تشغيل جهاز Docker الافتراضي - ما الذي يبقى وأين.

مواضع النمو السريع للقرص: media/، وقواعد بيانات SQLite لكل وكيل، ونصوص جلسات JSONL القديمة، وقاعدة بيانات حالة SQLite المشتركة، وجذور حزم Plugins المثبّتة، وسجلات الملفات المتعاقبة ضمن /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؟

راجع Hetzner ‏(Docker VPS) ووقت تشغيل Docker VM لمعرفة خطوات النشر على آلة افتراضية مشتركة، بما يشمل تضمين الملفات الثنائية في الصورة والاستمرارية والتحديثات.

عزل الوكيل

عند تمكين agents.defaults.sandbox مع الواجهة الخلفية لـ Docker، يشغّل 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 — بديل Podman لـ Docker
• ClawDock — إعداد Docker Compose من المجتمع
• التحديث — إبقاء OpenClaw محدّثًا
• الإعداد — إعداد Gateway بعد التثبيت