CLI للنماذج

تختار مراجع النماذج موفرًا ونموذجًا. وهي لا تختار عادةً بيئة تشغيل الوكيل منخفضة المستوى. على سبيل المثال، يمكن تشغيل openai/gpt-5.5 عبر مسار موفر OpenAI العادي أو عبر بيئة تشغيل خادم تطبيق Codex، حسب agents.defaults.agentRuntime.id. في وضع بيئة تشغيل Codex، لا يعني المرجع openai/gpt-* فوترة بمفتاح API؛ يمكن أن تأتي المصادقة من حساب Codex أو ملف تعريف مصادقة openai-codex. راجع بيئات تشغيل الوكلاء.

# كيف يعمل اختيار النموذج

يختار OpenClaw النماذج بهذا الترتيب:

# مصدر الاختيار وسلوك الاحتياطي

يمكن أن يعني provider/model نفسه أشياء مختلفة حسب مصدره:

• الافتراضيات المضبوطة (agents.defaults.model.primary والنماذج الأساسية الخاصة بالوكلاء) هي نقطة البدء العادية وتستخدم agents.defaults.model.fallbacks.
• اختيارات الاحتياطي التلقائية هي حالة تعافٍ مؤقتة. تُخزن مع modelOverrideSource: "auto" حتى تتمكن الأدوار اللاحقة من مواصلة استخدام سلسلة الاحتياطيات بدون اختبار نموذج أساسي معروف التعطل أولًا.
• اختيارات جلسة المستخدم دقيقة. يخزن /model، ومنتقي النموذج، وsession_status(model=...)، وsessions.patch القيمة modelOverrideSource: "user"؛ وإذا تعذر الوصول إلى ذلك الموفر/النموذج المحدد، يفشل OpenClaw بوضوح بدلًا من الانتقال إلى نموذج مضبوط آخر.
• يُعد Cron --model / حمولة model نموذجًا أساسيًا لكل مهمة. ولا يزال يستخدم الاحتياطيات المضبوطة ما لم توفر المهمة حمولة fallbacks صريحة (استخدم fallbacks: [] لتشغيل cron صارم).
• تحترم منتقيات النموذج الافتراضي وقائمة السماح في CLI القيمة models.mode: "replace" عبر سرد models.providers.*.models الصريحة بدلًا من تحميل الفهرس المضمّن الكامل.
• يطلب منتقي النموذج في واجهة التحكم من Gateway عرض النموذج المضبوط لديه: agents.defaults.models عند وجوده، وإلا models.providers.*.models الصريحة إضافةً إلى الموفرين ذوي المصادقة القابلة للاستخدام. الفهرس المضمّن الكامل محجوز لعروض التصفح الصريحة مثل models.list مع view: "all" أو openclaw models list --all.

# سياسة نموذج سريعة

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

# الإعداد الأولي (موصى به)

إذا كنت لا تريد تعديل الإعدادات يدويًا، فشغّل الإعداد الأولي:

openclaw onboard

يمكنه إعداد النموذج + المصادقة للموفرين الشائعين، بما في ذلك اشتراك OpenAI Code (Codex) (OAuth) وAnthropic (مفتاح API أو Claude CLI).

# مفاتيح الإعدادات (نظرة عامة)

• agents.defaults.model.primary وagents.defaults.model.fallbacks
• agents.defaults.imageModel.primary وagents.defaults.imageModel.fallbacks
• agents.defaults.pdfModel.primary وagents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary وagents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary وagents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models (قائمة السماح + الأسماء المستعارة + معاملات الموفر)
• models.providers (موفرون مخصصون مكتوبون في models.json)

# تعديلات آمنة على قائمة السماح

استخدم عمليات كتابة إضافية عند تحديث agents.defaults.models يدويًا:

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

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

إذا كان agents.defaults.models مضبوطًا، فإنه يصبح قائمة السماح لـ /model ولتجاوزات الجلسة. عندما يختار مستخدم نموذجًا غير موجود في قائمة السماح تلك، يعيد OpenClaw:

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

عندما يتضمن الأمر المرفوض تجاوزًا لبيئة التشغيل مثل /model openai/gpt-5.5 --runtime codex، أصلح قائمة السماح أولًا، ثم أعد محاولة أمر /model ... --runtime ... نفسه. بالنسبة لتنفيذ Codex الأصلي، يظل النموذج المحدد openai/gpt-5.5؛ وتختار بيئة التشغيل codex الحاضنة وتستخدم مصادقة Codex بشكل منفصل.

بالنسبة إلى النماذج المحلية/GGUF، خزّن المرجع الكامل المسبوق بالموفر في قائمة السماح، على سبيل المثال ollama/gemma4:26b أو lmstudio/Gemma4-26b-a4-it-gguf أو الموفر/النموذج الدقيق المعروض بواسطة openclaw models list --provider <provider>. أسماء الملفات المحلية المجردة أو أسماء العرض لا تكفي عندما تكون قائمة السماح نشطة.

مثال إعداد قائمة السماح:

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

# تبديل النماذج في الدردشة (/model)

يمكنك تبديل النماذج للجلسة الحالية بدون إعادة التشغيل:

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

سلوك الأمر/الإعدادات الكامل: أوامر Slash.

# أوامر CLI

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

openclaw models (بدون أمر فرعي) هو اختصار لـ models status.

# models list

يعرض النماذج المهيأة/المتاحة للمصادقة افتراضياً. علامات مفيدة:

--allboolean

الكتالوج الكامل. يتضمن صفوف كتالوج ثابتة مضمّنة ومملوكة للمزوّد قبل تهيئة المصادقة، بحيث يمكن لعروض الاكتشاف فقط عرض النماذج غير المتاحة حتى تضيف بيانات اعتماد المزوّد المطابقة.

--localboolean

المزوّدون المحليون فقط.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcHJvdmlkZXIgPGlk " type="string"> التصفية حسب معرّف المزوّد، على سبيل المثال moonshot. لا تُقبل تسميات العرض من أدوات الاختيار التفاعلية.

--plainboolean

نموذج واحد في كل سطر.

--jsonboolean

مخرجات قابلة للقراءة آلياً.

# models status

يعرض النموذج الأساسي المحلول، والنماذج الاحتياطية، ونموذج الصور، ونظرة عامة على مصادقة المزوّدين المهيأين. كما يعرض حالة انتهاء صلاحية OAuth للملفات الشخصية الموجودة في مخزن المصادقة (يحذّر خلال 24 ساعة افتراضياً). يطبع --plain النموذج الأساسي المحلول فقط.

مثال (Claude CLI):

claude auth login
openclaw models status

# الفحص (نماذج OpenRouter المجانية)

يفحص openclaw models scan كتالوج النماذج المجانية في OpenRouter ويمكنه اختيارياً فحص النماذج لدعم الأدوات والصور.

--no-probeboolean

تخطَّ الفحوصات الحية (البيانات الوصفية فقط).

"--min-params

"--max-age-days

"--provider

"--max-candidates

--set-defaultboolean

اضبط agents.defaults.model.primary على الاختيار الأول.

--set-imageboolean

اضبط agents.defaults.imageModel.primary على اختيار الصورة الأول.

تُرتّب نتائج الفحص حسب:

1. دعم الصور
2. زمن استجابة الأدوات
3. حجم السياق
4. عدد المعلمات

الإدخال:

• قائمة OpenRouter /models (مرشح :free)
• تتطلب الفحوصات الحية مفتاح OpenRouter API من ملفات المصادقة الشخصية أو OPENROUTER_API_KEY (راجع متغيرات البيئة)
• مرشحات اختيارية: --max-age-days، --min-params، --provider، --max-candidates
• عناصر التحكم في الطلب/الفحص: --timeout، --concurrency

عند تشغيل الفحوصات الحية في TTY، يمكنك تحديد النماذج الاحتياطية تفاعلياً. في الوضع غير التفاعلي، مرّر --yes لقبول الإعدادات الافتراضية. نتائج البيانات الوصفية فقط معلوماتية؛ يتطلب --set-default و--set-image فحوصات حية حتى لا يهيئ OpenClaw نموذج OpenRouter غير قابل للاستخدام بلا مفتاح.

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

تُكتب المزوّدات المخصصة في models.providers إلى models.json ضمن دليل الوكيل (افتراضياً ~/.openclaw/agents/<agentId>/agent/models.json). يُدمج هذا الملف افتراضياً ما لم يُضبط models.mode على replace.

# ذات صلة

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