CLI لبيئة العزل

إدارة أوقات تشغيل صندوق الرمل لتنفيذ الوكيل المعزول.

نظرة عامة

يمكن لـ OmeniaClaw تشغيل الوكلاء في أوقات تشغيل صندوق رمل معزولة للأمان. تساعدك أوامر sandbox على فحص أوقات التشغيل هذه وإعادة إنشائها بعد التحديثات أو تغييرات التكوين.

يعني ذلك اليوم عادة:

• حاويات صندوق رمل Docker
• أوقات تشغيل صندوق رمل SSH عندما يكون agents.defaults.sandbox.backend = "ssh"
• أوقات تشغيل صندوق رمل OpenShell عندما يكون agents.defaults.sandbox.backend = "openshell"

بالنسبة إلى ssh وOpenShell remote، تكون إعادة الإنشاء أهم مما هي عليه مع Docker:

• مساحة العمل البعيدة تكون المصدر المعتمد بعد التهيئة الأولية
• يحذف OmeniaClaw sandbox recreate مساحة العمل البعيدة المعتمدة هذه للنطاق المحدد
• يؤدي الاستخدام التالي إلى تهيئتها مرة أخرى من مساحة العمل المحلية الحالية

الأوامر

OmeniaClaw sandbox explain

افحص وضع/نطاق/وصول مساحة عمل صندوق الرمل الفعلي، وسياسة أدوات صندوق الرمل، وبوابات الرفع (مع مسارات مفاتيح التكوين للإصلاح).

OmeniaClaw sandbox explainOmeniaClaw sandbox explain --session agent:main:mainOmeniaClaw sandbox explain --agent workOmeniaClaw sandbox explain --json

OmeniaClaw sandbox list

اسرد جميع أوقات تشغيل صندوق الرمل مع حالتها وتكوينها.

OmeniaClaw sandbox listOmeniaClaw sandbox list --browser  # List only browser containersOmeniaClaw sandbox list --json     # JSON output

يتضمن الإخراج:

• اسم وقت التشغيل وحالته
• الخلفية (docker، openshell، إلخ.)
• تسمية التكوين وما إذا كانت تطابق التكوين الحالي
• العمر (الوقت منذ الإنشاء)
• وقت الخمول (الوقت منذ آخر استخدام)
• الجلسة/الوكيل المرتبط

OmeniaClaw sandbox recreate

أزِل أوقات تشغيل صندوق الرمل لفرض إعادة إنشائها بالتكوين المحدث.

OmeniaClaw sandbox recreate --all                # Recreate all containersOmeniaClaw sandbox recreate --session main       # Specific sessionOmeniaClaw sandbox recreate --agent mybot        # Specific agentOmeniaClaw sandbox recreate --browser            # Only browser containersOmeniaClaw sandbox recreate --all --force        # Skip confirmation

الخيارات:

• --all: إعادة إنشاء جميع حاويات صندوق الرمل
• --session <key>: إعادة إنشاء الحاوية لجلسة محددة
• --agent <id>: إعادة إنشاء الحاويات لوكيل محدد
• --browser: إعادة إنشاء حاويات المتصفح فقط
• --force: تخطي مطالبة التأكيد

حالات الاستخدام

بعد تحديث صورة Docker

# Pull new imagedocker pull OmeniaClaw-sandbox:latestdocker tag OmeniaClaw-sandbox:latest OmeniaClaw-sandbox:bookworm-slim # Update config to use new image# Edit config: agents.defaults.sandbox.docker.image (or agents.list[].sandbox.docker.image) # Recreate containersOmeniaClaw sandbox recreate --all

بعد تغيير تكوين صندوق الرمل

# Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*) # Recreate to apply new configOmeniaClaw sandbox recreate --all

بعد تغيير هدف SSH أو مواد مصادقة SSH

# Edit config:# - agents.defaults.sandbox.backend# - agents.defaults.sandbox.ssh.target# - agents.defaults.sandbox.ssh.workspaceRoot# - agents.defaults.sandbox.ssh.identityFile / certificateFile / knownHostsFile# - agents.defaults.sandbox.ssh.identityData / certificateData / knownHostsData OmeniaClaw sandbox recreate --all

بالنسبة إلى خلفية ssh الأساسية، تحذف إعادة الإنشاء جذر مساحة العمل البعيدة لكل نطاق على هدف SSH. يعيد التشغيل التالي تهيئتها من مساحة العمل المحلية.

بعد تغيير مصدر OpenShell أو سياسته أو وضعه

# Edit config:# - agents.defaults.sandbox.backend# - plugins.entries.openshell.config.from# - plugins.entries.openshell.config.mode# - plugins.entries.openshell.config.policy OmeniaClaw sandbox recreate --all

بالنسبة إلى وضع OpenShell remote، تحذف إعادة الإنشاء مساحة العمل البعيدة المعتمدة لذلك النطاق. يعيد التشغيل التالي تهيئتها من مساحة العمل المحلية.

بعد تغيير setupCommand

OmeniaClaw sandbox recreate --all# or just one agent:OmeniaClaw sandbox recreate --agent family

لوكيل محدد فقط

# Update only one agent's containersOmeniaClaw sandbox recreate --agent alfred

سبب الحاجة إلى ذلك

عند تحديث تكوين صندوق الرمل:

• تستمر أوقات التشغيل الموجودة في العمل بالإعدادات القديمة.
• لا تُزال أوقات التشغيل إلا بعد 24 ساعة من عدم النشاط.
• الوكلاء المستخدمون بانتظام يُبقون أوقات التشغيل القديمة نشطة إلى أجل غير مسمى.

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

ترحيل السجل

يخزن OmeniaClaw بيانات تعريف وقت تشغيل صندوق الرمل كجزء JSON واحد لكل إدخال حاوية/متصفح ضمن دليل حالة صندوق الرمل. قد تظل التثبيتات الأقدم تحتوي على ملفات قديمة موحدة:

• ~/.OmeniaClaw/sandbox/containers.json
• ~/.OmeniaClaw/sandbox/browsers.json

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

التكوين

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

{  "agents": {    "defaults": {      "sandbox": {        "mode": "all", // off, non-main, all        "backend": "docker", // docker, ssh, openshell        "scope": "agent", // session, agent, shared        "docker": {          "image": "OmeniaClaw-sandbox:bookworm-slim",          "containerPrefix": "OmeniaClaw-sbx-",          // ... more Docker options        },        "prune": {          "idleHours": 24, // Auto-prune after 24h idle          "maxAgeDays": 7, // Auto-prune after 7 days        },      },    },  },}

ذات صلة

• مرجع CLI
• استخدام صندوق الرمل
• مساحة عمل الوكيل
• Doctor: يفحص إعداد صندوق الرمل.