واجهة سطر أوامر النماذج

تختار مراجع النماذج موفّرًا ونموذجًا. وهي لا تختار عادةً بيئة تشغيل الوكيل منخفضة المستوى. مراجع وكلاء OpenAI هي الاستثناء الرئيسي: يعمل openai/gpt-5.5 عبر بيئة تشغيل خادم تطبيق Codex افتراضيًا على موفّر OpenAI الرسمي. يمكن أيضًا اختيار تشغيل مراجع اشتراك Copilot (github-copilot/*) عبر Plugin بيئة تشغيل وكيل GitHub Copilot الخارجي، ويبقى هذا المسار صريحًا (من دون بديل auto). تنتمي تجاوزات بيئة التشغيل الصريحة إلى سياسة الموفّر/النموذج، لا إلى الوكيل أو الجلسة بالكامل. في وضع بيئة تشغيل Codex، لا يعني المرجع openai/gpt-* الفوترة عبر مفتاح API؛ يمكن أن تأتي المصادقة من حساب Codex أو ملف تعريف OAuth باسم openai. راجع بيئات تشغيل الوكلاء وبيئة تشغيل وكيل GitHub Copilot.

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

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

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

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

• الافتراضيات المهيأة (agents.defaults.model.primary والنماذج الأساسية الخاصة بالوكلاء) هي نقطة البدء المعتادة وتستخدم agents.defaults.model.fallbacks.
• اختيارات البديل التلقائي هي حالة استرداد مؤقتة. تُخزّن مع modelOverrideSource: "auto" حتى تتمكن المنعطفات اللاحقة من الاستمرار في استخدام سلسلة البدائل من دون فحص نموذج أساسي معروف أنه سيئ في كل مرة؛ يفحص OpenClaw النموذج الأساسي الأصلي مرة أخرى دوريًا، ويمسح الاختيار التلقائي عند تعافيه، ويعلن انتقالات البديل/التعافي مرة واحدة لكل تغيير حالة.
• اختيارات جلسة المستخدم دقيقة. يخزّن /model، ومنتقي النماذج، وsession_status(model=...)، وsessions.patch القيمة modelOverrideSource: "user"؛ إذا كان ذلك الموفّر/النموذج المحدد غير قابل للوصول، يفشل OpenClaw بشكل مرئي بدلًا من الانتقال إلى نموذج آخر مهيأ.
• لا تؤدي تغييرات agents.defaults.model.primary إلى إعادة كتابة اختيارات الجلسات الحالية. إذا قالت الحالة This session is pinned to X; config primary Y will apply to new/unpinned sessions.، فامسح اختيار الجلسة الحالية باستخدام /model default حتى ترث النموذج الأساسي المهيأ مرة أخرى.
• ‏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

يمكنه إعداد النموذج + المصادقة للموفّرين الشائعين، بما في ذلك اشتراك 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 (قائمة سماح + أسماء مستعارة + معلمات موفّر + إدخالات موفّر ديناميكية provider/*)
• 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>. لا تكفي أسماء الملفات المحلية المجردة أو أسماء العرض عندما تكون قائمة السماح نشطة.

إذا كنت تريد تقييد الموفّرين من دون سرد كل نموذج يدويًا، فأضف إدخالات provider/* إلى agents.defaults.models:

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

مع هذه السياسة، يعرض /model و/models ومنتقيات النماذج الفهرس المكتشف لهؤلاء الموفّرين فقط. يمكن أن تظهر نماذج جديدة من الموفّرين المحددين من دون تعديل قائمة السماح. يمكن خلط إدخالات provider/model الدقيقة مع إدخالات provider/* عندما تحتاج إلى نموذج محدد واحد من موفّر آخر.

مثال على تهيئة قائمة السماح:

{  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 default/model status

سلوك الأمر/الإعداد الكامل: أوامر الشرطة المائلة.

أوامر CLI

openclaw models listopenclaw models statusopenclaw models set <provider/model>openclaw models set-image <provider/model> openclaw models aliases listopenclaw models aliases add <alias> <provider/model>openclaw models aliases remove <alias> openclaw models fallbacks listopenclaw models fallbacks add <provider/model>openclaw models fallbacks remove <provider/model>openclaw models fallbacks clear openclaw models image-fallbacks listopenclaw models image-fallbacks add <provider/model>openclaw models image-fallbacks remove <provider/model>openclaw models image-fallbacks clear

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

models list

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

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

models status

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

مثال (Claude CLI):

claude auth loginopenclaw models status

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

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

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

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). تُخزّن فهارس Plugin المزوّد كأجزاء فهرس مولّدة مملوكة للـ Plugin ضمن حالة Plugin الخاصة بالوكيل وتُحمّل تلقائيًا. يُدمج هذا الملف افتراضيًا ما لم يُعيّن models.mode إلى replace.

ذات صلة

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