تتيح تجاوزات تثبيت Plugin للمشرفين توجيه عمليات تثبيت Plugin أثناء الإعداد إلى
حزمة npm محددة أو ملف tar محلي ناتج عن npm pack بدلًا من المصدر الموجود في الكتالوج
أو المضمّن أو مصدر npm الافتراضي. وهي مخصّصة فقط لاختبارات E2E والتحقق من الحزم؛
أما المستخدمون العاديون فيثبّتون الإضافات باستخدام
openclaw plugins install.
تُنفّذ التجاوزات شيفرة Plugin من المصدر الذي توفره. لا تستخدمها إلا في
دليل حالة معزول أو جهاز اختبار مؤقت.
البيئة
تظل التجاوزات معطلة ما لم يُعيَّن كلا المتغيرين:
خريطة التجاوزات هي JSON مفاتيحها معرّفات الإضافات. تدعم القيم ما يلي:
السلوك
عندما يثبّت تدفق أثناء الإعداد Plugin يظهر معرّفه في الخريطة، يستخدم OpenClaw
مصدر التجاوز بدلًا من المصدر الموجود في الكتالوج أو المضمّن أو مصدر npm
الافتراضي. ينطبق ذلك على الإعداد الأولي وأي تدفق آخر يستخدم مثبّت
Plugin المشترك أثناء الإعداد.
- تظل التجاوزات تفرض معرّف Plugin المتوقع: يجب أن يثبّت ملف tar المعيّن إلى
codex
Plugin يكون معرّف البيان الخاص به هو codex.
- لا ترث التجاوزات حالة المصدر الرسمي الموثوق. حتى عندما يمثّل
إدخال الكتالوج عادةً حزمة مملوكة لـ OpenClaw، يُعامل التجاوز على أنه
إدخال اختبار يقدمه المشغّل.
- لا يمكن لملفات
.env في مساحة العمل تفعيل تجاوزات التثبيت؛ فكلا متغيري البيئة
مدرجان في قائمة dotenv المحظورة لمساحة العمل. عيّنهما في الصدفة الموثوقة أو مهمة CI أو
أمر الاختبار البعيد الذي يشغّل OpenClaw.
اختبار E2E للحزمة
استخدم دليل حالة معزولًا كي لا تمس عمليات تثبيت الحزم وسجلات التثبيت
حالة OpenClaw العادية لديك:
تحقق من الحزمة المثبتة داخل دليل الحالة:
لاختبار E2E المباشر لمزوّد الخدمة، حمّل مفتاح API الحقيقي من صدفة موثوقة أو
سرّ CI قبل تشغيل أمر الاختبار. لا تطبع المفاتيح؛ أبلغ فقط عن
المصدر وما إذا كان المفتاح موجودًا. 