​

Docker (اختياري)

​

هل Docker مناسب لي؟

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

​

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

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

​

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 gateway.mode local
docker compose run --rm --no-deps --entrypoint node openclaw-gateway \
  dist/index.js config set gateway.bind lan
docker compose run --rm --no-deps --entrypoint node openclaw-gateway \
  dist/index.js config set gateway.controlUi.allowedOrigins \
  '["http://localhost:18789","http://127.0.0.1:18789"]' --strict-json
docker compose up -d openclaw-gateway

​

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

​

فحوصات الصحة

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

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

​

مساعدات shell (اختياري)

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؟

​

Agent Sandbox

• Sandboxing — المرجع الكامل لـ sandbox
• OpenShell — وصول shell تفاعلي إلى حاويات sandbox
• Multi-Agent Sandbox and Tools — تجاوزات لكل وكيل

​

تمكين سريع

{
  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 gateway.mode local
docker compose run --rm openclaw-cli config set gateway.bind lan
docker compose run --rm openclaw-cli devices list --url ws://127.0.0.1:18789

​

ذو صلة

• Install Overview — جميع طرق التثبيت
• Podman — بديل Podman لـ Docker
• ClawDock — إعداد Docker Compose مجتمعي
• Updating — إبقاء OpenClaw محدثًا
• Configuration — تكوين gateway بعد التثبيت