OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

CLI لصندوق العزل

Status: active

إدارة بيئات تشغيل العزل لتنفيذ الوكيل بشكل معزول: حاويات Docker، أو وجهات SSH، أو خلفيات OpenShell.

الأوامر

openclaw sandbox list

اعرض بيئات تشغيل العزل مع الحالة، والخلفية، ومدى تطابق الإعداد، والعمر، ومدة الخمول، والجلسة/الوكيل المرتبط.

bash
openclaw sandbox listopenclaw sandbox list --browser  # حاويات المتصفح فقطopenclaw sandbox list --json

openclaw sandbox recreate

أزل بيئات تشغيل العزل لفرض إعادة إنشائها بالإعداد الحالي. تُعاد إنشاء بيئات التشغيل تلقائيًا في المرة التالية التي يُستخدم فيها الوكيل.

bash
openclaw sandbox recreate --allopenclaw sandbox recreate --agent mybot        # يتضمن الجلسات الفرعية agent:mybot:*openclaw sandbox recreate --session "agent:main:main"openclaw sandbox recreate --browser --all      # حاويات المتصفح فقطopenclaw sandbox recreate --all --force        # تجاوز التأكيد

الخيارات:

  • --all: إعادة إنشاء جميع حاويات العزل
  • --session <key>: إعادة إنشاء بيئة التشغيل ذات مفتاح النطاق المطابق تمامًا (كما يظهر في sandbox list)؛ من دون توسيع الاسم المختصر
  • --agent <id>: إعادة إنشاء بيئات التشغيل لوكيل واحد (يطابق agent:<id> وagent:<id>:*)
  • --browser: التأثير في حاويات المتصفح فقط
  • --force: تجاوز مطالبة التأكيد

مرّر خيارًا واحدًا فقط من --all أو --session أو --agent.

بالنسبة إلى ssh وremote في OpenShell، تكون إعادة الإنشاء أكثر أهمية مما هي عليه مع Docker: تصبح مساحة العمل البعيدة هي النسخة المرجعية بعد التهيئة الأولية، ويحذف recreate مساحة العمل البعيدة المرجعية تلك للنطاق المحدد، ثم تعيد عملية التشغيل التالية تهيئتها انطلاقًا من مساحة العمل المحلية الحالية.

openclaw sandbox explain

افحص وضع العزل ونطاقه والوصول إلى مساحة العمل الفعّالة، وسياسة أدوات العزل، وبوابات الأدوات ذات الصلاحيات المرتفعة (مع مسارات مفاتيح الإعداد اللازمة للإصلاح).

يُبقي التقرير workspaceRoot بوصفه جذر العزل المُعدّ، ويعرض بشكل منفصل مساحة عمل المضيف الفعّالة، ودليل العمل لبيئة تشغيل الخلفية، وجدول عمليات الربط في Docker. عند استخدام workspaceAccess: "rw"، تكون مساحة عمل المضيف الفعّالة هي مساحة عمل الوكيل بدلًا من دليل يقع تحت workspaceRoot.

bash
openclaw sandbox explainopenclaw sandbox explain --session agent:main:mainopenclaw sandbox explain --agent workopenclaw sandbox explain --json

بخلاف recreate --session، يقبل هذا الأمر أسماء الجلسات المختصرة (مثل main) ويوسّعها وفقًا للوكيل الذي جرى تحديده.

لماذا يلزم إجراء إعادة الإنشاء

لا يؤثر تحديث إعداد العزل في الحاويات قيد التشغيل: تحتفظ بيئات التشغيل الحالية بإعداداتها القديمة، ولا تُحذف بيئات التشغيل الخاملة إلا بعد prune.idleHours (القيمة الافتراضية 24 ساعة). يمكن للوكلاء المستخدمين بانتظام إبقاء بيئات التشغيل القديمة قائمة إلى أجل غير مسمى. يزيل openclaw sandbox recreate بيئة التشغيل القديمة كي يُعاد بناؤها من الإعداد الحالي عند الاستخدام التالي.

الأسباب الشائعة

التغيير الأمر
تحديث صورة Docker ‏(agents.defaults.sandbox.docker.image) openclaw sandbox recreate --all
إعداد العزل (agents.defaults.sandbox.*) openclaw sandbox recreate --all
وجهة/مصادقة SSH ‏(agents.defaults.sandbox.ssh.{target,workspaceRoot,identityFile,certificateFile,knownHostsFile,identityData,certificateData,knownHostsData}) openclaw sandbox recreate --all
مصدر/سياسة/وضع OpenShell ‏(plugins.entries.openshell.config.{from,mode,policy}) openclaw sandbox recreate --all
setupCommand openclaw sandbox recreate --all (أو --agent <id> لوكيل واحد)

ترحيل السجل

توجد البيانات الوصفية لبيئات تشغيل العزل في قاعدة بيانات حالة SQLite المشتركة. قد تحتوي عمليات التثبيت القديمة على ملفات سجل قديمة لم تعد عمليات القراءة العادية تعيد كتابتها:

  • ~/.openclaw/sandbox/containers.json
  • ~/.openclaw/sandbox/browsers.json
  • جزء JSON واحد لكل حاوية/متصفح ضمن ~/.openclaw/sandbox/containers/ أو ~/.openclaw/sandbox/browsers/

شغّل openclaw doctor --fix لترحيل الإدخالات القديمة الصالحة إلى SQLite. تُعزل الملفات القديمة غير الصالحة كي لا يتمكن سجل قديم تالف من إخفاء إدخالات بيئات التشغيل الحالية.

الإعداد

توجد إعدادات العزل في ~/.openclaw/openclaw.json ضمن agents.defaults.sandbox (توضع التجاوزات الخاصة بكل وكيل في agents.list[].sandbox):

jsonc
{  "agents": {    "defaults": {      "sandbox": {        "mode": "all", // معطل، غير رئيسي، الكل        "backend": "docker", // docker، ssh، openshell (يوفره Plugin)        "scope": "agent", // جلسة، وكيل، مشترك        "docker": {          "image": "openclaw-sandbox:bookworm-slim",          "containerPrefix": "openclaw-sbx-",          // ... مزيد من خيارات Docker        },        "prune": {          "idleHours": 24, // حذف تلقائي بعد 24 ساعة من الخمول          "maxAgeDays": 7, // حذف تلقائي بعد 7 أيام        },      },    },  },}

ذو صلة

Was this useful?
On this page

On this page