أوامر CLI

Sandbox CLI

إدارة حاويات بيئة الاختبار المعزولة (Sandbox) القائمة على Docker لتنفيذ الوكيل المعزول.

نظرة عامة

يمكن لـ OpenClaw تشغيل الوكلاء في حاويات Docker معزولة لأغراض الأمان. تساعدك أوامر sandbox في إدارة هذه الحاويات، خاصة بعد التحديثات أو تغييرات التكوين.

الأوامر

openclaw sandbox explain

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

openclaw sandbox explain
openclaw sandbox explain --session agent:main:main
openclaw sandbox explain --agent work
openclaw sandbox explain --json

openclaw sandbox list

اعرض قائمة بجميع حاويات بيئة الاختبار مع حالتها وتكوينها.

openclaw sandbox list
openclaw sandbox list --browser  # إدراج حاويات المتصفح فقط
openclaw sandbox list --json     # إخراج بتنسيق JSON

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

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

openclaw sandbox recreate

أزل حاويات بيئة الاختبار لإجبار إعادة إنشائها باستخدام الصور/التكوينات المحدثة.

openclaw sandbox recreate --all                # إعادة إنشاء جميع الحاويات
openclaw sandbox recreate --session main       # جلسة محددة
openclaw sandbox recreate --agent mybot        # وكيل محدد
openclaw sandbox recreate --browser            # حاويات المتصفح فقط
openclaw sandbox recreate --all --force        # تخطي التأكيد

الخيارات:

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

هام: يتم إعادة إنشاء الحاويات تلقائيًا عند استخدام الوكيل التالي.

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

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

# سحب الصورة الجديدة
docker pull openclaw-sandbox:latest
docker tag openclaw-sandbox:latest openclaw-sandbox:bookworm-slim

# تحديث التكوين لاستخدام الصورة الجديدة
# تحرير التكوين: agents.defaults.sandbox.docker.image (أو agents.list[].sandbox.docker.image)

# إعادة إنشاء الحاويات
openclaw sandbox recreate --all

بعد تغيير تكوين بيئة الاختبار

# تحرير التكوين: agents.defaults.sandbox.* (أو agents.list[].sandbox.*)

# إعادة الإنشاء لتطبيق التكوين الجديد
openclaw sandbox recreate --all

بعد تغيير setupCommand

openclaw sandbox recreate --all
# أو لوكيل واحد فقط:
openclaw sandbox recreate --agent family

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

# تحديث حاويات وكيل واحد فقط
openclaw sandbox recreate --agent alfred

لماذا هذا مطلوب؟

المشكلة: عند تحديث صور Docker أو تكوين بيئة الاختبار:

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

الحل: استخدم openclaw sandbox recreate لإجبار إزالة الحاويات القديمة. سيتم إعادة إنشائها تلقائيًا بالإعدادات الحالية عند الحاجة التالية. نصيحة: يُفضل استخدام openclaw sandbox recreate بدلاً من docker rm اليدوي. فهو يستخدم تسمية الحاوية الخاصة بـ Gateway ويتجنب عدم التطابق عند تغيير مفاتيح النطاق/الجلسة.

التكوين

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

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "all", // off, non-main, all
        "scope": "agent", // session, agent, shared
        "docker": {
          "image": "openclaw-sandbox:bookworm-slim",
          "containerPrefix": "openclaw-sbx-",
          // ... المزيد من خيارات Docker
        },
        "prune": {
          "idleHours": 24, // التنظيف التلقائي بعد 24 ساعة خمول
          "maxAgeDays": 7, // التنظيف التلقائي بعد 7 أيام
        },
      },
    },
  },
}

انظر أيضًا

resetsecrets