واجهة CLI للنماذج

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

مصدر الاختيار وسلوك البدائل

• الافتراضيات المضبوطة (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 عند وجوده، بما في ذلك إدخالات provider/* على مستوى الموفر، وإلا models.providers.*.models الصريحة بالإضافة إلى الموفرين ذوي المصادقة القابلة للاستخدام. يُحجز الفهرس المدمج الكامل لعروض التصفح الصريحة مثل models.list مع view: "all" أو openclaw models list --all.

​

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

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

​

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

openclaw onboard

​

مفاتيح التكوين (نظرة عامة)

• 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 (قائمة السماح + الأسماء المستعارة + معاملات الموفر + إدخالات الموفر الديناميكية provider/*)
• models.providers (موفرون مخصصون مكتوبون في models.json)

​

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

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

​

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

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

{
  agents: {
    defaults: {
      models: {
        "openai-codex/*": {},
        "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" },
      },
    },
  },
}

​

تبديل النماذج في المحادثة (/model)

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

​

أوامر 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

​

models list

​

models status

claude auth login
openclaw models status

​

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

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

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

​

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

​

ذو صلة

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