CLI للنماذج

​

ترتيب الاختيار

• agents.defaults.models هي قائمة السماح/دليل النماذج التي يمكن لـ OpenClaw استخدامها، إضافةً إلى الأسماء البديلة. استخدم إدخالات provider/* للسماح بكل نموذج مكتشف من موفر من دون إدراج كل نموذج على حدة.
• agents.defaults.utilityModel هو نموذج اختياري أقل تكلفة للمهام الداخلية القصيرة مثل عناوين جلسات لوحة المعلومات المُنشأة، وعناوين سلاسل المحادثات/الموضوعات في القنوات المدعومة، وسرد التقدم. يتجاوزه agents.list[].utilityModel الخاص بكل وكيل. عندما لا يكون معيّنًا، يستخدم OpenClaw النموذج الصغير الافتراضي المعلَن للموفر الأساسي عند وجوده (OpenAI ← gpt-5.6-luna، وAnthropic ← claude-haiku-4-5)؛ وإلا فيستخدم النموذج الأساسي للوكيل. عيّنه إلى سلسلة فارغة لتعطيل توجيه الأدوات المساعدة. مهام الأدوات المساعدة هي استدعاءات نماذج منفصلة وقد ترسل محتوى محدودًا للمهمة إلى موفر النموذج المحدد.
• agents.defaults.imageModel يُستخدم فقط عندما يتعذر على النموذج الأساسي قبول الصور.
• agents.defaults.pdfModel تستخدمه أداة pdf. إذا لم يكن معيّنًا، تعود الأداة إلى imageModel، ثم إلى نموذج الجلسة/النموذج الافتراضي الذي جرى حله.
• agents.defaults.imageGenerationModel وmusicGenerationModel وvideoGenerationModel تدعم أدوات إنشاء الوسائط المشتركة. إذا لم تكن معيّنة، تستنتج كل أداة قيمة افتراضية لموفر مدعوم بالمصادقة: الموفر الافتراضي الحالي أولًا، ثم بقية الموفرين المسجلين لتلك الإمكانية بترتيب معرّف الموفر. عيّن agents.defaults.mediaGenerationAutoProviderFallback: false لتعطيل هذا الاستنتاج عبر الموفرين مع إبقاء البدائل الاحتياطية الصريحة.
• يتجاوز agents.list[].model الخاص بكل وكيل (إضافةً إلى الارتباطات) القيمة agents.defaults.model — راجع توجيه الوكلاء المتعددين.

​

مصدر الاختيار وصرامة البدائل الاحتياطية

• لا تؤدي تغييرات agents.defaults.model.primary إلى إعادة كتابة تثبيتات الجلسات الحالية. إذا أبلغت الحالة عن This session is pinned to X; config primary Y will apply to new/unpinned sessions.، فشغّل /model default لمسح التثبيت.
• تحترم أدوات اختيار النموذج الافتراضي وقائمة السماح في CLI القيمة models.mode: "replace" عبر إدراج models.providers.*.models فقط بدلًا من الدليل المضمّن الكامل.
• تطلب أداة اختيار النموذج في واجهة التحكم من Gateway عرض النماذج المضبوط لديه: agents.defaults.models عند تعيينه (بما في ذلك إدخالات أحرف البدل provider/*)؛ وإلا فتستخدم models.providers.*.models إضافةً إلى الموفرين ذوي المصادقة القابلة للاستخدام. يقتصر الدليل المضمّن الكامل على عروض التصفح الصريحة (models.list مع view: "all"، أو openclaw models list --all).
• تستخدم واجهات مخزون الموفرين models.list مع view: "provider-config" لإظهار صفوف models.providers.*.models المؤلَّفة من المصدر من دون تطبيق قوائم السماح الخاصة بأدوات الاختيار.

​

سياسة سريعة للنماذج

• عيّن نموذجك الأساسي إلى أقوى نموذج من أحدث جيل متاح لك.
• استخدم البدائل الاحتياطية للمهام الحساسة للتكلفة/زمن الاستجابة وللمحادثات الأقل أهمية.
• بالنسبة إلى الوكلاء المزودين بأدوات أو المدخلات غير الموثوقة، تجنّب فئات النماذج الأقدم/الأضعف.

​

الإعداد الأولي

openclaw onboard

​

«النموذج غير مسموح به» (وسبب توقف الردود)

النموذج "provider/model" غير مسموح به. استخدم /models لإدراج الموفرين، أو /models <provider> لإدراج النماذج.
أضفه باستخدام: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-6" },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
}

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

/model في المحادثة

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

• /model و/model list يعرضان منتقيًا رقميًا موجزًا (عائلة النموذج + المزوّدون المتاحون)؛ ويختار /model <#> منه. في Discord، يفتح هذا قوائم منسدلة للمزوّد/النموذج تتضمن خطوة Submit؛ وفي Telegram، تقتصر اختيارات المنتقي على الجلسة ولا تعيد أبدًا كتابة الإعداد الافتراضي الدائم للوكيل في openclaw.json. أما /models add فقد أُهمل ويُرجع رسالة بدلًا من تسجيل النماذج من المحادثة.
• /model يحفظ اختيار الجلسة الجديد فورًا. إذا كان الوكيل خاملًا، يستخدمه التشغيل التالي مباشرةً؛ وإذا كان هناك تشغيل نشط بالفعل، فيُدرج التبديل في قائمة الانتظار إلى نقطة إعادة المحاولة النظيفة التالية (أو نقطة لاحقة، إذا كان نشاط الأداة أو إخراج الرد قد بدأ بالفعل).
• /model default يمسح اختيار الجلسة لتعود إلى وراثة الإعداد الأساسي المُهيأ.
• مرجع /model الذي يختاره المستخدم صارم لتلك الجلسة: إذا تعذّر الوصول إليه، يفشل الرد بصورة ظاهرة بدلًا من الرجوع بصمت عبر agents.defaults.model.fallbacks. تظل الإعدادات الافتراضية المُهيأة والنماذج الأساسية لمهام Cron تستخدم سلاسل الرجوع.
• /model status هو العرض التفصيلي: مرشحو المصادقة لكل مزوّد، وعند التهيئة، نقطة نهاية المزوّد baseUrl بالإضافة إلى وضع api.
• تُحلّل مراجع النماذج بالتقسيم عند أول /؛ اكتب provider/model. إذا كان معرّف النموذج نفسه يحتوي على / (بأسلوب OpenRouter)، فأدرج بادئة المزوّد، مثل /model openrouter/moonshotai/kimi-k2. إذا حذفت المزوّد، يحاول OpenClaw: (1) مطابقة الاسم المستعار، (2) مطابقة مزوّد مُهيأ فريد لمعرّف النموذج غير المسبوق نفسه تمامًا، (3) المزوّد الافتراضي المُهيأ (رجوع مُهمل) — وإذا لم يعد ذلك المزوّد يوفّر النموذج الافتراضي المُهيأ، فيستخدم أول مزوّد/نموذج مُهيأ بدلًا منه، لتجنّب إظهار إعداد افتراضي قديم لمزوّد أُزيل.
• تُطبّع مراجع النماذج إلى أحرف صغيرة؛ وتظل معرّفات المزوّدين مطابقة تمامًا فيما عدا ذلك، لذا استخدم المعرّف الذي يعلنه Plugin.

​

CLI

openclaw models status
openclaw models list
openclaw models set <provider/model>
openclaw models set-image <provider/model>
openclaw models scan
openclaw models aliases list|add|remove
openclaw models fallbacks list|add|remove|clear
openclaw models image-fallbacks list|add|remove|clear
openclaw models auth list|add|login|paste-api-key|paste-token|setup-token|order

​

سجل النماذج (models.json)

​

ذو صلة

• بيئات تشغيل الوكلاء — بيئات تشغيل حلقات الوكلاء في OpenClaw وCodex وغيرها
• مرجع التهيئة — مفاتيح تهيئة النماذج
• توليد الصور — تهيئة نموذج الصور
• التبديل الاحتياطي للنماذج — سلاسل الرجوع
• مزوّدو النماذج — توجيه المزوّدين والمصادقة
• مرجع CLI للنماذج — المرجع الكامل للأوامر والعلامات
• توليد الموسيقى — تهيئة نموذج الموسيقى
• توليد الفيديو — تهيئة نموذج الفيديو