أسئلة وأجوبة حول النماذج وملفات تعريف المصادقة. للإعداد والجلسات وGateway والقنوات واستكشاف الأخطاء وإصلاحها، راجع الأسئلة الشائعة الرئيسية.Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
النماذج: الإعدادات الافتراضية، والاختيار، والأسماء المستعارة، والتبديل
ما هو "النموذج الافتراضي"؟
ما هو "النموذج الافتراضي"؟
provider/model (مثال: openai/gpt-5.5 أو anthropic/claude-sonnet-4-6). إذا حذفت المزوّد، فسيحاول OpenClaw أولًا استخدام اسم مستعار، ثم مطابقة فريدة لمزوّد مُعدّ لذلك المعرّف الدقيق للنموذج، وبعدها فقط يعود إلى المزوّد الافتراضي المُعدّ كمسار توافق مهمل. إذا لم يعد ذلك المزوّد يعرض النموذج الافتراضي المُعدّ، فسيرجع OpenClaw إلى أول مزوّد/نموذج مُعدّ بدلًا من إظهار قيمة افتراضية قديمة لمزوّد أُزيل. مع ذلك، ينبغي لك صراحةً ضبط provider/model.ما النموذج الذي توصون به؟
ما النموذج الذي توصون به؟
كيف أبدّل النماذج دون مسح إعدادي؟
كيف أبدّل النماذج دون مسح إعدادي؟
/modelفي الدردشة (سريع، لكل جلسة)openclaw models set ...(يحدّث إعداد النموذج فقط)openclaw configure --section model(تفاعلي)- عدّل
agents.defaults.modelفي~/.openclaw/openclaw.json
config.apply مع كائن جزئي إلا إذا كنت تقصد استبدال الإعداد بالكامل.
لتعديلات RPC، افحص أولًا باستخدام config.schema.lookup وفضّل config.patch. تمنحك حمولة lookup المسار المطبع، ووثائق/قيود المخطط السطحية، وملخصات الأبناء المباشرين.
للتحديثات الجزئية.
إذا استبدلت الإعداد بالفعل، فاستعد من نسخة احتياطية أو أعد تشغيل openclaw doctor للإصلاح.الوثائق: النماذج، الإعداد، الإعدادات، Doctor.هل يمكنني استخدام نماذج مستضافة ذاتيًا (llama.cpp، vLLM، Ollama)؟
هل يمكنني استخدام نماذج مستضافة ذاتيًا (llama.cpp، vLLM، Ollama)؟
- ثبّت Ollama من
https://ollama.com/download - اسحب نموذجًا محليًا مثل
ollama pull gemma4 - إذا كنت تريد نماذج سحابية أيضًا، شغّل
ollama signin - شغّل
openclaw onboardواخترOllama - اختر
LocalأوCloud + Local
- يمنحك
Cloud + Localنماذج سحابية إضافة إلى نماذج Ollama المحلية لديك - النماذج السحابية مثل
kimi-k2.5:cloudلا تحتاج إلى سحب محلي - للتبديل اليدوي، استخدم
openclaw models listوopenclaw models set ollama/<model>
ما النماذج التي يستخدمها OpenClaw وFlawd وKrill؟
ما النماذج التي يستخدمها OpenClaw وFlawd وKrill؟
- قد تختلف هذه عمليات النشر وقد تتغير مع الوقت؛ لا توجد توصية ثابتة لمزوّد.
- تحقّق من إعداد وقت التشغيل الحالي على كل Gateway باستخدام
openclaw models status. - للوكلاء الحساسين أمنيًا/المفعّلين بالأدوات، استخدم أقوى نموذج من أحدث جيل متاح.
كيف أبدّل النماذج أثناء التشغيل (دون إعادة التشغيل)؟
كيف أبدّل النماذج أثناء التشغيل (دون إعادة التشغيل)؟
/model كرسالة مستقلة:agents.defaults.models.يمكنك سرد النماذج المتاحة باستخدام /model أو /model list أو /model status.يعرض /model (و/model list) منتقيًا مرقمًا وموجزًا. اختر بالرقم:/model status الوكيل النشط، وملف auth-profiles.json المستخدم، وملف تعريف المصادقة الذي ستتم تجربته بعد ذلك.
كما يعرض نقطة نهاية المزوّد المُعدّة (baseUrl) ووضع API (api) عند توفرهما.كيف ألغي تثبيت ملف تعريف ضبطته باستخدام @profile؟أعد تشغيل /model من دون اللاحقة @profile:/model (أو أرسل /model <default provider/model>).
استخدم /model status للتأكد من ملف تعريف المصادقة النشط.إذا كان مزوّدان يعرضان معرّف النموذج نفسه، فأيهما يستخدم /model؟
إذا كان مزوّدان يعرضان معرّف النموذج نفسه، فأيهما يستخدم /model؟
/model provider/model مسار ذلك المزوّد الدقيق للجلسة.على سبيل المثال، qianfan/deepseek-v4-flash وdeepseek/deepseek-v4-flash هما مرجعان مختلفان للنموذج رغم أن كليهما يحتوي على deepseek-v4-flash. ينبغي ألا يبدّل OpenClaw بصمت من مزوّد إلى آخر لمجرد أن معرّف النموذج المجرّد يطابق.مرجع /model الذي يختاره المستخدم صارم أيضًا لسياسة الرجوع الاحتياطي. إذا كان المزوّد/النموذج المحدد غير متاح، يفشل الرد بشكل مرئي بدلًا من الإجابة من agents.defaults.model.fallbacks. لا تزال سلاسل الرجوع الاحتياطي المُعدّة تنطبق على الإعدادات الافتراضية المُعدّة، وأساسيات مهام cron، وحالة الرجوع الاحتياطي المحددة تلقائيًا.إذا كان يُسمح لتشغيل بدأ من تجاوز غير خاص بالجلسة باستخدام الرجوع الاحتياطي، فسيحاول OpenClaw المزوّد/النموذج المطلوب أولًا، ثم خيارات الرجوع الاحتياطي المُعدّة، وبعدها فقط الأساسي المُعدّ. يمنع ذلك معرّفات النماذج المجرّدة المكررة من القفز مباشرة إلى المزوّد الافتراضي.راجع النماذج وتجاوز فشل النموذج.هل يمكنني استخدام GPT 5.5 للمهام اليومية وCodex 5.5 للبرمجة؟
هل يمكنني استخدام GPT 5.5 للمهام اليومية وCodex 5.5 للبرمجة؟
- وكيل البرمجة Codex الأصلي: اضبط
agents.defaults.model.primaryعلىopenai/gpt-5.5. سجّل الدخول باستخدامopenclaw models auth login --provider openai-codexعندما تريد مصادقة اشتراك ChatGPT/Codex. - مهام OpenAI API المباشرة خارج حلقة الوكيل: اضبط
OPENAI_API_KEYللصور والتضمينات والكلام والوقت الفعلي وسائر أسطح OpenAI API غير الخاصة بالوكلاء. - مصادقة مفتاح API لوكيل OpenAI: استخدم
/model openai/gpt-5.5مع ملف تعريف مفتاح API مرتب لـopenai-codex. - الوكلاء الفرعيون: وجّه مهام البرمجة إلى وكيل يركز على Codex مع نموذج
openai/gpt-5.5الخاص به.
كيف أعدّ الوضع السريع لـ GPT 5.5؟
كيف أعدّ الوضع السريع لـ GPT 5.5؟
- لكل جلسة: أرسل
/fast onأثناء استخدام الجلسة لـopenai/gpt-5.5. - كإعداد افتراضي لكل نموذج: اضبط
agents.defaults.models["openai/gpt-5.5"].params.fastModeعلىtrue.
service_tier = "priority" في طلبات Responses الأصلية المدعومة. تتغلب تجاوزات /fast للجلسة على الإعدادات الافتراضية.راجع التفكير والوضع السريع والوضع السريع في OpenAI.لماذا أرى "Model ... is not allowed" ثم لا يصل أي رد؟
لماذا أرى "Model ... is not allowed" ثم لا يصل أي رد؟
agents.defaults.models، فإنه يصبح قائمة السماح لـ /model وأي
تجاوزات للجلسة. اختيار نموذج غير موجود في تلك القائمة يعيد:agents.defaults.models، أو أضف حرف بدل للمزوّد مثل "provider/*": {} لفهارس المزوّدين الديناميكية، أو أزل قائمة السماح، أو اختر نموذجًا من /model list.
إذا كان الأمر يتضمن أيضًا --runtime codex، فحدّث قائمة السماح أولًا ثم أعد محاولة
أمر /model provider/model --runtime codex نفسه.لماذا أرى "Unknown model: minimax/MiniMax-M2.7"؟
لماذا أرى "Unknown model: minimax/MiniMax-M2.7"؟
-
رقِّ إلى إصدار OpenClaw حالي (أو شغّل من المصدر
main)، ثم أعد تشغيل Gateway. -
تأكد من إعداد MiniMax (المعالج أو JSON)، أو من وجود مصادقة MiniMax
في البيئة/ملفات تعريف المصادقة حتى يمكن حقن المزوّد المطابق
(
MINIMAX_API_KEYلـminimax، أوMINIMAX_OAUTH_TOKENأو OAuth مخزّن لـ MiniMax لـminimax-portal). -
استخدم معرّف النموذج الدقيق (حساس لحالة الأحرف) لمسار المصادقة لديك:
minimax/MiniMax-M2.7أوminimax/MiniMax-M2.7-highspeedلإعداد مفتاح API، أوminimax-portal/MiniMax-M2.7/minimax-portal/MiniMax-M2.7-highspeedلإعداد OAuth. -
شغّل:
واختر من القائمة (أو
/model listفي الدردشة).
هل يمكنني استخدام MiniMax كافتراضي وOpenAI للمهام المعقدة؟
هل يمكنني استخدام MiniMax كافتراضي وOpenAI للمهام المعقدة؟
/model أو وكيلًا منفصلًا.الخيار أ: التبديل لكل جلسة- الإعداد الافتراضي للوكيل A: MiniMax
- الإعداد الافتراضي للوكيل B: OpenAI
- وجّه حسب الوكيل أو استخدم
/agentللتبديل
هل opus / sonnet / gpt اختصارات مضمّنة؟
هل opus / sonnet / gpt اختصارات مضمّنة؟
agents.defaults.models):opus→anthropic/claude-opus-4-7sonnet→anthropic/claude-sonnet-4-6gpt→openai/gpt-5.4gpt-mini→openai/gpt-5.4-minigpt-nano→openai/gpt-5.4-nanogemini→google/gemini-3.1-pro-previewgemini-flash→google/gemini-3-flash-previewgemini-flash-lite→google/gemini-3.1-flash-lite-preview
كيف أعرّف/أتجاوز اختصارات النماذج (الأسماء المستعارة)؟
كيف أعرّف/أتجاوز اختصارات النماذج (الأسماء المستعارة)؟
agents.defaults.models.<modelId>.alias. مثال:/model sonnet (أو /<alias> عند دعمه) إلى معرّف ذلك النموذج.كيف أضيف نماذج من مزوّدين آخرين مثل OpenRouter أو Z.AI؟
كيف أضيف نماذج من مزوّدين آخرين مثل OpenRouter أو Z.AI؟
No API key found for provider "zai").لم يتم العثور على مفتاح API للمزوّد بعد إضافة وكيل جديديعني هذا عادةً أن الوكيل الجديد لديه مخزن مصادقة فارغ. تكون المصادقة لكل وكيل على حدة
وتُخزّن في:- شغّل
openclaw agents add <id>واضبط المصادقة أثناء المعالج. - أو انسخ فقط ملفات تعريف
api_key/tokenالثابتة والقابلة للنقل من مخزن مصادقة الوكيل الرئيسي إلى مخزن مصادقة الوكيل الجديد. - بالنسبة إلى ملفات تعريف OAuth، سجّل الدخول من الوكيل الجديد عندما يحتاج إلى حسابه الخاص؛ وإلا يستطيع OpenClaw القراءة عبر الوكيل الافتراضي/الرئيسي من دون استنساخ رموز التحديث.
agentDir عبر الوكلاء؛ فهذا يسبب تضاربًا في المصادقة/الجلسات.تجاوز فشل النموذج و”فشلت كل النماذج”
كيف يعمل تجاوز الفشل؟
كيف يعمل تجاوز الفشل؟
- تدوير ملف تعريف المصادقة ضمن المزوّد نفسه.
- الرجوع إلى نموذج بديل وهو النموذج التالي في
agents.defaults.model.fallbacks.
429 العادية. يعامل OpenClaw
أيضًا رسائل مثل Too many concurrent requests،
وThrottlingException، وconcurrency limit reached،
وworkers_ai ... quota limit exceeded، وresource exhausted، وحدود
نوافذ الاستخدام الدورية (weekly/monthly limit reached) كحدود معدل
تستحق تجاوز الفشل.بعض الاستجابات التي تبدو متعلقة بالفوترة ليست 402، كما تبقى بعض استجابات HTTP 402
أيضًا في ذلك الوعاء العابر. إذا أعاد مزوّد نص فوترة صريحًا مع 401 أو 403، فلا يزال OpenClaw قادرًا على إبقائه
في مسار الفوترة، لكن مطابقات النص الخاصة بالمزوّد تبقى محصورة في
المزوّد الذي يملكها (على سبيل المثال OpenRouter Key limit exceeded). إذا بدت رسالة 402
بدلًا من ذلك كنافذة استخدام قابلة لإعادة المحاولة أو
حد إنفاق مؤسسة/مساحة عمل (daily limit reached, resets tomorrow,
organization spending limit exceeded)، فيعاملها OpenClaw على أنها
rate_limit، وليست تعطيل فوترة طويلًا.أخطاء تجاوز السياق مختلفة: تبقى التواقيع مثل
request_too_large، وinput exceeds the maximum number of tokens،
وinput token count exceeds the maximum number of input tokens،
وinput is too long for the model، أو ollama error: context length exceeded على مسار Compaction/إعادة المحاولة بدلًا من الانتقال إلى
الرجوع إلى نموذج بديل.نص أخطاء الخادم العام أضيق عمدًا من “أي شيء يحتوي على
unknown/error”. يعامل OpenClaw الأشكال العابرة المحصورة بالمزوّد
مثل خطأ Anthropic المجرد An unknown error occurred، وخطأ OpenRouter المجرد
Provider returned error، وأخطاء سبب الإيقاف مثل Unhandled stop reason: error، وحمولات JSON من نوع api_error التي تحتوي على نص خادم عابر
(internal server error، وunknown error, 520، وupstream error، وbackend error)، وأخطاء انشغال المزوّد مثل ModelNotReadyException كإشارات
مهلة/تحميل زائد تستحق تجاوز الفشل عندما يطابق سياق المزوّد.
نص الرجوع الداخلي العام مثل LLM request failed with an unknown error. يبقى محافظًا ولا يشغّل الرجوع إلى نموذج بديل بمفرده.ماذا يعني "No credentials found for profile anthropic:default"؟
ماذا يعني "No credentials found for profile anthropic:default"؟
anthropic:default، لكنه لم يتمكن من العثور على بيانات اعتماده في مخزن المصادقة المتوقع.قائمة تحقق للإصلاح:- تأكد من مكان وجود ملفات تعريف المصادقة (المسارات الجديدة مقابل القديمة)
- الحالي:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - القديم:
~/.openclaw/agent/*(يهاجرهopenclaw doctor)
- الحالي:
- تأكد من تحميل متغير البيئة لديك بواسطة Gateway
- إذا ضبطت
ANTHROPIC_API_KEYفي الصدفة لديك لكنك تشغّل Gateway عبر systemd/launchd، فقد لا يرثه. ضعه في~/.openclaw/.envأو فعّلenv.shellEnv.
- إذا ضبطت
- تأكد من أنك تعدّل الوكيل الصحيح
- تعني إعدادات الوكلاء المتعددة إمكانية وجود عدة ملفات
auth-profiles.json.
- تعني إعدادات الوكلاء المتعددة إمكانية وجود عدة ملفات
- تحقق بشكل سريع من حالة النموذج/المصادقة
- استخدم
openclaw models statusلرؤية النماذج المضبوطة وما إذا كان المزوّدون موثّقين.
- استخدم
-
استخدم Claude CLI
- شغّل
openclaw models auth login --provider anthropic --method cli --set-defaultعلى مضيف Gateway.
- شغّل
-
إذا كنت تريد استخدام مفتاح API بدلًا من ذلك
-
ضع
ANTHROPIC_API_KEYفي~/.openclaw/.envعلى مضيف Gateway. -
امسح أي ترتيب مثبّت يفرض ملفًا شخصيًا مفقودًا:
-
ضع
-
تأكد من أنك تشغّل الأوامر على مضيف Gateway
- في الوضع البعيد، تعيش ملفات تعريف المصادقة على جهاز Gateway، وليس على حاسوبك المحمول.
لماذا حاول أيضًا استخدام Google Gemini وفشل؟
لماذا حاول أيضًا استخدام Google Gemini وفشل؟
No API key found for provider "google".الإصلاح: إما توفير مصادقة Google، أو إزالة/تجنب نماذج Google في agents.defaults.model.fallbacks / الأسماء المستعارة حتى لا يوجّه الرجوع إليها.رُفض طلب LLM: توقيع التفكير مطلوب (Google Antigravity)السبب: يحتوي سجل الجلسة على كتل تفكير بلا تواقيع (غالبًا من
تدفق أُجهض/جزئي). يتطلب Google Antigravity تواقيع لكتل التفكير.الإصلاح: يزيل OpenClaw الآن كتل التفكير غير الموقعة لـ Google Antigravity Claude. إذا استمر ظهور ذلك، فابدأ جلسة جديدة أو اضبط /thinking off لذلك الوكيل.ملفات تعريف المصادقة: ما هي وكيف تديرها
ذو صلة: /concepts/oauth (تدفقات OAuth، تخزين الرموز، أنماط الحسابات المتعددة)ما ملف تعريف المصادقة؟
ما ملف تعريف المصادقة؟
openclaw models auth list (اختياريًا --provider <id> أو --json). راجع Models CLI للتفاصيل.ما معرّفات الملفات الشخصية النموذجية؟
ما معرّفات الملفات الشخصية النموذجية؟
anthropic:default(شائع عندما لا توجد هوية بريد إلكتروني)anthropic:<email>لهويات OAuth- معرّفات مخصصة تختارها (مثل
anthropic:work)
هل يمكنني التحكم في ملف تعريف المصادقة الذي يُجرَّب أولًا؟
هل يمكنني التحكم في ملف تعريف المصادقة الذي يُجرَّب أولًا؟
auth.order.<provider>). هذا لا يخزّن أسرارًا؛ بل يربط المعرّفات بالمزوّد/الوضع ويضبط ترتيب التدوير.قد يتخطى OpenClaw ملفًا شخصيًا مؤقتًا إذا كان في فترة تهدئة قصيرة (حدود معدل/مهلات/فشل مصادقة) أو في حالة تعطيل أطول (فوترة/أرصدة غير كافية). لفحص ذلك، شغّل openclaw models status --json وتحقق من auth.unusableProfiles. الضبط: auth.cooldowns.billingBackoffHours*.يمكن أن تكون فترات تهدئة حدود المعدل مرتبطة بالنموذج. يمكن أن يبقى ملف شخصي في فترة تهدئة
لنموذج واحد قابلًا للاستخدام لنموذج شقيق على المزوّد نفسه،
بينما تبقى نوافذ الفوترة/التعطيل حاجبة للملف الشخصي بأكمله.يمكنك أيضًا ضبط تجاوز ترتيب لكل وكيل (مخزّن في auth-state.json لذلك الوكيل) عبر CLI:excluded_by_auth_order لذلك الملف الشخصي بدلًا من تجربته بصمت.OAuth مقابل مفتاح API - ما الفرق؟
OAuth مقابل مفتاح API - ما الفرق؟
- غالبًا ما يستفيد OAuth من وصول الاشتراك (حيثما ينطبق ذلك).
- تستخدم مفاتيح API فوترة الدفع لكل رمز.
ذو صلة
- الأسئلة الشائعة — الأسئلة الشائعة الرئيسية
- الأسئلة الشائعة — البدء السريع وإعداد التشغيل الأول
- اختيار النموذج
- تجاوز فشل النموذج