OpenShell

OpenShell هو واجهة خلفية مُدارة لصناديق الحماية في OpenClaw. بدلاً من تشغيل حاويات Docker محلياً، يفوّض OpenClaw دورة حياة صندوق الحماية إلى CLI openshell، الذي يوفّر بيئات بعيدة مع تنفيذ أوامر قائم على SSH.

يعيد Plugin OpenShell استخدام نقل SSH الأساسي نفسه وجسر نظام الملفات البعيد مثل واجهة SSH الخلفية العامة. ويضيف دورة حياة خاصة بـ OpenShell (sandbox create/get/delete, sandbox ssh-config) ووضع مساحة عمل اختياري باسم mirror.

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

• تثبيت Plugin OpenShell (openclaw plugins install @openclaw/openshell-sandbox)
• تثبيت CLI openshell ووجوده على PATH (أو تعيين مسار مخصص عبر plugins.entries.openshell.config.command)
• حساب OpenShell لديه وصول إلى صناديق الحماية
• تشغيل OpenClaw Gateway على المضيف

البدء السريع

1. ثبّت Plugin وفعّله، ثم اضبط واجهة صندوق الحماية الخلفية:

openclaw plugins install @openclaw/openshell-sandbox

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

2. أعد تشغيل Gateway. عند دور الوكيل التالي، ينشئ OpenClaw صندوق حماية OpenShell ويوجّه تنفيذ الأدوات عبره.

3. تحقّق:

openclaw sandbox listopenclaw sandbox explain

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

هذا هو القرار الأهم عند استخدام OpenShell.

mirror

استخدم plugins.entries.openshell.config.mode: "mirror" عندما تريد أن تبقى مساحة العمل المحلية هي المرجع المعتمد.

السلوك:

• قبل exec، يزامن OpenClaw مساحة العمل المحلية إلى صندوق حماية OpenShell.
• بعد exec، يزامن OpenClaw مساحة العمل البعيدة عائداً إلى مساحة العمل المحلية.
• تستمر أدوات الملفات في العمل عبر جسر صندوق الحماية، لكن مساحة العمل المحلية تبقى مصدر الحقيقة بين الأدوار.

الأفضل لـ:

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

المفاضلة: تكلفة مزامنة إضافية قبل كل تنفيذ وبعده.

remote

استخدم plugins.entries.openshell.config.mode: "remote" عندما تريد أن تصبح مساحة عمل OpenShell هي المرجع المعتمد.

السلوك:

• عند إنشاء صندوق الحماية لأول مرة، يملأ OpenClaw مساحة العمل البعيدة من مساحة العمل المحلية مرة واحدة.
• بعد ذلك، تعمل exec وread وwrite وedit وapply_patch مباشرةً على مساحة عمل OpenShell البعيدة.
• لا يزامن OpenClaw التغييرات البعيدة عائدةً إلى مساحة العمل المحلية.
• تستمر قراءات الوسائط وقت المطالبة في العمل لأن أدوات الملفات والوسائط تقرأ عبر جسر صندوق الحماية.

الأفضل لـ:

• عندما ينبغي أن يعيش صندوق الحماية أساساً على الجانب البعيد.
• عندما تريد تقليل كلفة المزامنة في كل دور.
• عندما لا تريد أن تستبدل التعديلات المحلية على المضيف حالة صندوق الحماية البعيد بصمت.

اختيار وضع

مرجع الإعدادات

توجد كل إعدادات OpenShell ضمن plugins.entries.openshell.config:

تُضبط إعدادات مستوى صندوق الحماية (mode وscope وworkspaceAccess) ضمن agents.defaults.sandbox كما هو الحال مع أي واجهة خلفية. راجع صناديق الحماية للاطلاع على المصفوفة الكاملة.

أمثلة

إعداد بعيد بالحد الأدنى

{  agents: {    defaults: {      sandbox: {        mode: "all",        backend: "openshell",      },    },  },  plugins: {    entries: {      openshell: {        enabled: true,        config: {          from: "openclaw",          mode: "remote",        },      },    },  },}

وضع Mirror مع GPU

{  agents: {    defaults: {      sandbox: {        mode: "all",        backend: "openshell",        scope: "agent",        workspaceAccess: "rw",      },    },  },  plugins: {    entries: {      openshell: {        enabled: true,        config: {          from: "openclaw",          mode: "mirror",          gpu: true,          providers: ["openai"],          timeoutSeconds: 180,        },      },    },  },}

OpenShell لكل وكيل مع Gateway مخصص

{  agents: {    defaults: {      sandbox: { mode: "off" },    },    list: [      {        id: "researcher",        sandbox: {          mode: "all",          backend: "openshell",          scope: "agent",          workspaceAccess: "rw",        },      },    ],  },  plugins: {    entries: {      openshell: {        enabled: true,        config: {          from: "openclaw",          mode: "remote",          gateway: "lab",          gatewayEndpoint: "https://lab.example",          policy: "strict",        },      },    },  },}

إدارة دورة الحياة

تُدار صناديق حماية OpenShell عبر CLI صندوق الحماية المعتاد:

# List all sandbox runtimes (Docker + OpenShell)openclaw sandbox list # Inspect effective policyopenclaw sandbox explain # Recreate (deletes remote workspace, re-seeds on next use)openclaw sandbox recreate --all

في وضع remote، تكون إعادة الإنشاء مهمة بشكل خاص: فهي تحذف مساحة العمل البعيدة المعتمدة لذلك النطاق. يملأ الاستخدام التالي مساحة عمل بعيدة جديدة من مساحة العمل المحلية.

في وضع mirror، تعيد إعادة الإنشاء أساساً ضبط بيئة التنفيذ البعيدة لأن مساحة العمل المحلية تبقى هي المرجع المعتمد.

متى تعيد الإنشاء

أعد الإنشاء بعد تغيير أي من هذه:

• agents.defaults.sandbox.backend
• plugins.entries.openshell.config.from
• plugins.entries.openshell.config.mode
• plugins.entries.openshell.config.policy

openclaw sandbox recreate --all

تعزيز الأمان

يثبّت OpenShell واصف ملف جذر مساحة العمل ويعيد التحقق من هوية صندوق الحماية قبل كل قراءة، لذلك لا يمكن لاستبدالات الروابط الرمزية أو إعادة تركيب مساحة العمل أن تعيد توجيه القراءات خارج مساحة العمل البعيدة المقصودة.

القيود الحالية

• متصفح صندوق الحماية غير مدعوم على واجهة OpenShell الخلفية.
• لا ينطبق sandbox.docker.binds على OpenShell.
• تنطبق مفاتيح ضبط وقت التشغيل الخاصة بـ Docker ضمن sandbox.docker.* فقط على واجهة Docker الخلفية.

كيف يعمل

1. يستدعي OpenClaw الأمر openshell sandbox create (مع علامات --from و--gateway و--policy و--providers و--gpu كما تم ضبطها).
2. يستدعي OpenClaw الأمر openshell sandbox ssh-config <name> للحصول على تفاصيل اتصال SSH الخاصة بصندوق الحماية.
3. يكتب core إعدادات SSH إلى ملف مؤقت ويفتح جلسة SSH باستخدام جسر نظام الملفات البعيد نفسه مثل واجهة SSH الخلفية العامة.
4. في وضع mirror: يزامن من المحلي إلى البعيد قبل التنفيذ، ثم يشغّل، ثم يزامن عائداً بعد التنفيذ.
5. في وضع remote: يملأ مرة واحدة عند الإنشاء، ثم يعمل مباشرةً على مساحة العمل البعيدة.

ذات صلة

• صناديق الحماية -- الأوضاع، والنطاقات، ومقارنة الواجهات الخلفية
• صندوق الحماية مقابل سياسة الأداة مقابل Elevated -- تصحيح أخطاء الأدوات المحظورة
• صندوق حماية وأدوات متعددة الوكلاء -- تجاوزات لكل وكيل
• CLI صندوق الحماية -- أوامر openclaw sandbox