​

Docker (اختياري)

​

هل Docker مناسب لي؟

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

​

المتطلبات المسبقة

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

​

Gateway داخل حاوية

./scripts/docker/setup.sh

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

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

# WhatsApp (QR)
docker compose run --rm openclaw-cli channels login

# Telegram
docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>"

# Discord
docker compose run --rm openclaw-cli channels add --channel discord --token "<token>"

​

التدفق اليدوي

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-daemon
docker 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

​

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

​

فحوصات السلامة

curl -fsS http://127.0.0.1:18789/healthz   # فحص الحيوية
curl -fsS http://127.0.0.1:18789/readyz     # فحص الجاهزية

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

​

LAN مقابل loopback المحلي

• lan (الافتراضي): يمكن لمتصفح المضيف وCLI المضيف الوصول إلى منفذ Gateway المنشور.
• loopback: لا يمكن سوى للعمليات داخل مساحة أسماء شبكة الحاوية الوصول إلى Gateway مباشرةً.

​

التخزين والاستمرارية

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

​

مساعدات الصدفة (اختياري)

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

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

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

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

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

FROM node:24-bookworm
RUN curl -fsSL https://bun.sh/install | bash
ENV PATH="/root/.bun/bin:${PATH}"
RUN corepack enable
WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build
ENV NODE_ENV=production
CMD ["node","dist/index.js"]

​

هل تعمل على VPS؟

​

عزل الوكيل

• العزل — المرجع الكامل للعزل
• OpenShell — وصول shell تفاعلي إلى حاويات العزل
• العزل والأدوات متعددة الوكلاء — تجاوزات لكل وكيل

​

تمكين سريع

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

scripts/sandbox-setup.sh

​

استكشاف الأخطاء وإصلاحها

docker compose run --rm openclaw-cli dashboard --no-open
docker compose run --rm openclaw-cli devices list
docker 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 بعد التثبيت