Crabbox: امنح الوكيل صندوقًا يُستأجر عند الطلب لتشغيل الاختبارات والبناء وفحوصات الواجهة

يناسب Crabbox على أفضل وجه الحالة التي يعمل فيها وكيل البرمجة (coding agent) على تعديل الكود محليًا، بينما تُسلَّم الاختبارات أو عمليات البناء أو فحوصات الواجهة إلى جهاز بعيد يُستأجر عند الطلب؛ وأهم شرط قبل البدء هو: أن يكون بإمكانك تثبيت واجهة سطر الأوامر (CLI) على جهازك، وأن يكون Docker أو Podman مثبتًا ويعمل مسبقًا للمسار السريع بالحاويات المحلية.

لمن يصلح

• يصلح لمن يريد أن يشغّل الوكيل أو هو بنفسه الاختبارات والبناء وفحوصات الواجهة على صندوق سحابي أو جهاز افتراضي/حاوية محلي أو جهاز لديه أصلًا، مع مواصلة تعديل الكود محليًا.
• Crabbox هو واجهة سطر أوامر (CLI) توفر ثلاثة أشكال من الصناديق: صندوق سحابي، أو جهاز افتراضي/حاوية محلية، أو جهاز تملكه بالفعل.
• يتطلب المسار السريع بالحاويات المحلية وجود Docker أو Podman مثبتًا ويعمل على الجهاز؛ أما مسار عمل SSH فيتطلب توفر git وssh وssh-keygen وrsync وcurl محليًا. وعند عدم توفر هذه الشروط، لا تذكر الأدلة الرسمية أي طريقة أخرى متاحة.
• لم تشرح الأدلة ما إذا كان الصندوق السحابي يتطلب حسابًا، ولا طريقة التسعير، ولا المنصات السحابية المدعومة؛ لذا يجب التحقق من ذلك بنفسك في الوثائق الرسمية قبل الاستخدام.

أول محاولة في 3 دقائق

المسار الرسمي الرئيسي الموصى به هو التشغيل السريع بالحاويات المحلية، ولا يحتاج إلى حساب سحابي إطلاقًا:

1. الشروط: تثبيت Docker أو Podman على جهازك وتشغيله، وتثبيت واجهة سطر الأوامر (CLI) على حدة (الوصف الرسمي هو "Install the CLI separately"، وتفاصيل أوامر التثبيت يُرجى الرجوع إلى ملف README الرسمي).

2. تثبيت مهارة الوكيل (agent skill): نفّذ الأمر الرسمي في وكيل مدعوم:

   npx skills add openclaw/crabbox --skill crabbox
   

   أصدرت الجهة الرسمية أيضًا مهارة crabbox-quickstart كبديل.

3. انتقل إلى مستودع Git تثق به (تتطلب الجهة الرسمية العمل داخل مستودع موثوق).

4. اطلب من الوكيل (أو نفّذ في الطرفية) أمر الفحص الذاتي الرسمي:

   crabbox doctor --provider local-container
   

   إشارة النجاح: نجاح doctor في فحص بيئة الحاويات المحلية.

5. ثم شغّل أول مهمة منخفضة المخاطر وقراءة فقط للتحقق من المسار كاملًا:

   crabbox run --provider local-container -- uname -a
   

   إشارة النجاح: سيستأجر Crabbox صندوق حاوية للاستخدام مرة واحدة، ويعيد تيار مخرجات الأمر إلى طرفيتك، ثم يحرر الصندوق. هذا المثال ينفّذ uname -a فقط ولا يعدّل ملفاتك.

6. مسار العمل الأساسي بعد ذلك هو crabbox run -- <cmd>: يستأجر صندوقًا، ويزامِن شجرة عملك (بما فيها التغييرات غير المُرسلة)، ويشغّل الأمر ويعيد تيار المخرجات إلى الطرفية، ويعيد رمز الخروج، ثم يحرر الصندوق أحادي الاستخدام. تنبيه: ما يُزامَن هو شجرة العمل كاملة بما فيها التغييرات غير المُرسلة؛ لذا قبل تشغيل أمر اختبار حقيقي لأول مرة، تأكد من فهمك لما سيُنقل إلى الصندوق لتنفيذه.

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

الحالة الأولى: تشغيل مجموعة الاختبارات في صندوق نظيف قبل الإرسال. السيناريو: أنت (أو الوكيل) أنهيت تعديل الكود ولا تريد تلويث بيئتك المحلية. اطلب من الوكيل تنفيذ crabbox run -- pnpm test (استبدل pnpm test بأمر الاختبار الخاص بمشروعك). النتيجة المتوقعة: يُستأجر صندوق أحادي الاستخدام، وتُزامَن شجرة عملك مع التغييرات غير المُرسلة، وتعود مخرجات الاختبار إلى الطرفية في الوقت الفعلي، وتحصل في النهاية على رمز الخروج الحقيقي، ثم يُحرَّر الصندوق.

الحالة الثانية: التحقق من بيئة صندوق الحاوية. السيناريو: أول إعداد أو شك في وجود مشكلة بالبيئة. اطلب من الوكيل تشغيل crabbox doctor --provider local-container أولًا للتشخيص، ثم crabbox run --provider local-container -- uname -a للتأكد من قدرة الصندوق على تنفيذ الأوامر. النتيجة المتوقعة: يُبلغ doctor عن جاهزية بيئة الحاويات المحلية من عدمها؛ ويعيد run معلومات نظام الصندوق، ما يثبت أن مسار الاستئجار–المزامنة–التنفيذ–الاسترجاع كاملًا يعمل. هاتان العمليتان تقتصران على الفحص وقراءة معلومات النظام، وهما إجراء أول استخدام نموذجي منخفض المخاطر.

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

• الآثار الجانبية ونقاط التأكيد: كل crabbox run يستأجر صندوقًا ويزامِن شجرة عملك (بما فيها التغييرات غير المُرسلة) إلى ذلك الصندوق، ثم ينفّذ فيه الأمر الذي تحدده — فالأمر يعمل فعليًا داخل الصندوق؛ تأكد من محتوى الأمر قبل البدء. كما يُشغّل مسار الحاويات المحلية حاوية على جهازك؛ أما حدود الخدمات الخارجية المتعلقة بالصندوق السحابي فلم تشرحها الأدلة.
• شروط بيئة التشغيل: يتطلب المسار السريع بالحاويات المحلية Docker أو Podman؛ ويتطلب مسار عمل SSH توفر git وssh وssh-keygen وrsync وcurl محليًا.
• شروط العميل: تُثبَّت المهارة عبر npx skills add وتنطبق على الوكلاء الذين يدعمون مهارات الوكلاء (agent skills)؛ ولم تُسمِّ الأدلة الرسمية العملاء المدعومين واحدًا واحدًا.
• معلومات أساسية لم تُؤكَّد بعد: متطلبات فتح الصندوق السحابي والحساب، وما إذا كان crabbox doctor أو run يصل إلى الشبكة أو يقرأ/يكتب أي ملفات محلية وأيها، وما الأوامر الفرعية الأخرى غير الموضحة في الوثائق؛ لم تشرح الأدلة الرسمية أيًا من ذلك، فارجع إلى ملف README الرسمي قبل الاستخدام.