العزل الأمني

​

ما الذي يُعزل

• تنفيذ الأدوات (exec، read، write، edit، apply_patch، process، إلخ).
• المتصفح المعزول الاختياري (agents.defaults.sandbox.browser).

• عملية Gateway نفسها.
• أي أداة يُسمح لها صراحةً بالعمل خارج البيئة المعزولة (مثل tools.elevated).
  • يتجاوز التنفيذ المرفوع العزل ويستخدم مسار الخروج المضبوط (gateway افتراضيًا، أو node عندما يكون هدف التنفيذ هو node).
  • إذا كان العزل متوقفًا، فإن tools.elevated لا يغير التنفيذ (فهو بالفعل على المضيف). راجع الوضع المرفوع.

​

الأوضاع

​

النطاق

• "agent" (الافتراضي): حاوية واحدة لكل وكيل.
• "session": حاوية واحدة لكل جلسة.
• "shared": حاوية واحدة مشتركة بين جميع الجلسات المعزولة.

​

الخلفية

• "docker" (الافتراضي عند تفعيل العزل): بيئة تشغيل عزل محلية مدعومة بـ Docker.
• "ssh": بيئة تشغيل عزل بعيدة عامة مدعومة بـ SSH.
• "openshell": بيئة تشغيل عزل مدعومة بـ OpenShell.

​

اختيار خلفية

​

خلفية Docker

​

خلفية SSH

{
  agents: {
    defaults: {
      sandbox: {
        mode: "all",
        backend: "ssh",
        scope: "session",
        workspaceAccess: "rw",
        ssh: {
          target: "user@gateway-host:22",
          workspaceRoot: "/tmp/openclaw-sandboxes",
          strictHostKeyChecking: true,
          updateHostKeys: true,
          identityFile: "~/.ssh/id_ed25519",
          certificateFile: "~/.ssh/id_ed25519-cert.pub",
          knownHostsFile: "~/.ssh/known_hosts",
          // Or use SecretRefs / inline contents instead of local files:
          // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" },
          // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" },
          // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" },
        },
      },
    },
  },
}

​

خلفية OpenShell

{
  agents: {
    defaults: {
      sandbox: {
        mode: "all",
        backend: "openshell",
        scope: "session",
        workspaceAccess: "rw",
      },
    },
  },
  plugins: {
    entries: {
      openshell: {
        enabled: true,
        config: {
          from: "openclaw",
          mode: "remote", // mirror | remote
          remoteWorkspaceDir: "/sandbox",
          remoteAgentWorkspaceDir: "/agent",
        },
      },
    },
  },
}

• mirror (الافتراضي): تبقى مساحة العمل المحلية هي المرجع. يزامن OpenClaw الملفات المحلية إلى OpenShell قبل exec ويزامن مساحة العمل البعيدة مرة أخرى بعد exec.
• remote: تكون مساحة عمل OpenShell هي المرجع بعد إنشاء البيئة المعزولة. يبذر OpenClaw مساحة العمل البعيدة مرة واحدة من مساحة العمل المحلية، ثم تعمل أدوات الملفات وexec مباشرةً على البيئة المعزولة البعيدة دون مزامنة التغييرات مرة أخرى.

​

أوضاع مساحة العمل

​

دورة حياة OpenShell

• يعرض openclaw sandbox list أوقات تشغيل OpenShell وكذلك أوقات تشغيل Docker
• يحذف openclaw sandbox recreate وقت التشغيل الحالي ويتيح لـ OpenClaw إعادة إنشائه عند الاستخدام التالي
• منطق التنظيف مدرك للواجهة الخلفية أيضًا

• تحذف إعادة الإنشاء مساحة العمل البعيدة المرجعية لذلك النطاق
• يهيئ الاستخدام التالي مساحة عمل بعيدة جديدة من مساحة العمل المحلية

​

الوصول إلى مساحة العمل

• ما زال وضع mirror يستخدم مساحة العمل المحلية كمصدر مرجعي بين أدوار exec
• يستخدم وضع remote مساحة عمل OpenShell البعيدة كمصدر مرجعي بعد التهيئة الأولية
• يظل workspaceAccess: "ro" و"none" يقيدان سلوك الكتابة بالطريقة نفسها

​

عمليات تثبيت الربط المخصصة

• عند ضبطه (بما في ذلك [])، يستبدل agents.defaults.sandbox.docker.binds لحاوية المتصفح.
• عند حذفه، ترجع حاوية المتصفح إلى agents.defaults.sandbox.docker.binds (متوافق مع الإصدارات السابقة).

{
  agents: {
    defaults: {
      sandbox: {
        docker: {
          binds: ["/home/user/source:/source:ro", "/var/data/myapp:/data:ro"],
        },
      },
    },
    list: [
      {
        id: "build",
        sandbox: {
          docker: {
            binds: ["/mnt/cache:/cache:rw"],
          },
        },
      },
    ],
  },
}

​

الصور والإعداد

scripts/sandbox-setup.sh

docker build -t openclaw-sandbox:bookworm-slim - <<'DOCKERFILE'
FROM debian:bookworm-slim
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y --no-install-recommends \
  bash ca-certificates curl git jq python3 ripgrep \
  && rm -rf /var/lib/apt/lists/*
RUN useradd --create-home --shell /bin/bash sandbox
USER sandbox
WORKDIR /home/sandbox
CMD ["sleep", "infinity"]
DOCKERFILE

scripts/sandbox-common-setup.sh

scripts/sandbox-browser-setup.sh

​

setupCommand (إعداد الحاوية لمرة واحدة)

• عام: agents.defaults.sandbox.docker.setupCommand
• لكل وكيل: agents.list[].sandbox.docker.setupCommand

​

سياسة الأدوات ومخارج التجاوز

• استخدم openclaw sandbox explain لفحص وضع sandbox الفعال، وسياسة الأدوات، ومفاتيح إعداد الإصلاح.
• راجع Sandbox مقابل سياسة الأدوات مقابل Elevated للحصول على النموذج الذهني لسؤال “لماذا تم حظر هذا؟”.

​

تجاوزات الوكلاء المتعددين

​

مثال تمكين بسيط

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",
        scope: "session",
        workspaceAccess: "none",
      },
    },
  },
}

​

ذات صلة

• Sandbox والأدوات للوكلاء المتعددين — التجاوزات لكل وكيل والأسبقية
• OpenShell — إعداد واجهة sandbox الخلفية المُدارة، وأوضاع مساحة العمل، ومرجع الإعدادات
• إعدادات Sandbox
• Sandbox مقابل سياسة الأدوات مقابل Elevated — تصحيح “لماذا تم حظر هذا؟”
• الأمان