CLI commands
العروض الترويجية
openclaw promos
اكتشف عروض النماذج الترويجية المنشورة على ClawHub وطالب بها. تؤدي المطالبة بعرض ترويجي إلى تهيئة المزوّد (المصادقة وPlugin عند الحاجة) وتسجيل نماذج العرض الترويجي — من دون إعادة تشغيل الإعداد الأولي ومن دون تغيير نموذجك الافتراضي ما لم تطلب ذلك.
موضوعات ذات صلة:
- النموذج الافتراضي والنماذج الاحتياطية: النماذج
- إعداد مصادقة المزوّد: بدء الاستخدام
الأوامر
openclaw promos listopenclaw promos claim <slug>openclaw promos claim <slug> --api-key <key> --set-defaultopenclaw promos list
يسرد العروض الترويجية المتاحة حاليًا، مع نماذجها والنموذج الافتراضي المقترح والوقت المتبقي وأمر المطالبة الدقيق. يطبع --json الحمولة الأولية.
openclaw promos claim <slug>
يطالب بعرض ترويجي متاح:
- يجلب العرض الترويجي من ClawHub ويتحقق من أنه ضمن فترة صلاحيته.
- يتحقق من توافق مزوّد العرض الترويجي وخيار المصادقة وحزم Plugin المعلنة مع إصدار OpenClaw المثبّت لديك. تُرفض المعرّفات غير المعروفة أو حالات عدم تطابق الحزم — ولا يمكن لأي عرض ترويجي مطلقًا جعل CLI يشغّل أي شيء لا يعرف مسبقًا كيفية تشغيله.
- يعيد استخدام بيانات اعتماد المزوّد الموجودة لديك إن توفرت. وإلا، فيتابع مسار المصادقة المعتاد للمزوّد (بعد طباعة عنوان URL الخاص بالتسجيل في العرض الترويجي للحصول على مفتاح مجاني أولًا). يُكمل
--api-key <key>المصادقة بمفتاح API من دون مطالبات، بما يتوافق مع خيارات التشغيل غير التفاعلي للأمرopenclaw onboard؛ ولإبقاء المفتاح خارج سطر الأوامر، صدّر متغير البيئة الخاص بالمزوّد بدلًا من ذلك (مثلOPENROUTER_API_KEY) — تُكتشف بيانات الاعتماد الموجودة في البيئة تلقائيًا ولا حاجة إلى أي خيار. - يسجّل نماذج العرض الترويجي مع أسمائها المستعارة. لا تُستبدل الأسماء المستعارة الموجودة مطلقًا.
- يعرض تعيين النموذج المقترح للعرض الترويجي كنموذجك الافتراضي — يتجاوز
--set-defaultالسؤال؛ وإلا فلن يتغير أي شيء في إعداداتك الافتراضية.
عند انتهاء فترة العرض الترويجي، يتوقف المزوّد عن تقديم النماذج المجانية؛ وتظل تهيئتك وبيانات اعتمادك دون تغيير. يمكنك التبديل مجددًا في أي وقت باستخدام openclaw models set <model>.
الاكتشاف غير المباشر في models list
يعرض openclaw models list أيضًا العروض الترويجية من دون أن تطلبها مباشرةً من ClawHub:
- تظهر العروض المتاحة التي لم تُهيئ نماذجها ضمن مجموعة "متاحة عبر عرض ترويجي" أسفل الجدول، ويظهر مع كل منها أمر المطالبة الخاص بها.
- تحمل النماذج التي سجّلتها عبر
promos claimوسمpromo، ويتغير إلىpromo endedبعد انتهاء فترة العرض. - عند اكتشاف عرض جديد للمرة الأولى، يوجّه إشعار يظهر مرة واحدة إلى
openclaw promos list. ولا يُعلن مجددًا عن العروض التي سبق أن أدرجتها أو طالبت بها.
يقرأ هذا نسخة مخزّنة مؤقتًا محليًا من موجز العروض الترويجية المستضاف على ClawHub (تُحدَّث عادةً مرة يوميًا باستخدام طلب شرطي، أو قبل ذلك عند انتهاء صلاحية اللقطة المخزّنة مؤقتًا؛ ويجري تخطي حالات فشل التحديث بصمت). ينتظر تحديث النسخة القديمة 2.5 ثانية بحد أقصى ولا يعطّل عملية الإدراج أبدًا. يظل إخراج --json و--plain نظيفًا وقابلًا للمعالجة آليًا: من دون أقسام أو إشعارات ترويجية. تعيد المطالبة دائمًا التحقق باستخدام واجهة API المباشرة لـ ClawHub، ولذلك يُرفض العرض المسحوب مبكرًا حتى إذا كانت النسخة المخزّنة مؤقتًا لا تزال تعرضه.