نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج
بعد تثبيت OpenClaw وإتمام onboarding بنجاح، أصبح لديك نموذج جاهز للاستخدام. لكن OpenClaw نفسه لا يأتي مع نماذج — فالنماذج كلها تأتي من «إضافات provider»، وهذا هو جوهر تكوين النماذج في OpenClaw: أي إضافة تربطها، وأي بيانات اعتماد تضبطها، وهل كتبت مرجع النموذج بالصيغة الصحيحة provider/model.
يشرح هذا الدرس (1.6) هذا النظام كاملًا دفعة واحدة: كيف تستعلم عن الوضع الحالي، وكيف تعرض الدليل، وكيف تعيّن الافتراضي، وكيف تبدّل في أي وقت داخل المحادثة، وكيف تربط provider جديدًا تمامًا. وكل صفحة مخصصة لربط نموذج في 1.7–1.15 لاحقًا ما هي إلا تطبيق عملي لهذه القواعد. يستند هذا الدرس إلى الإصدار v2026.10.9.
ماذا ستستطيع فعله بعد إتمام الدرس
- أن تذكر النموذج الذي يستخدمه OpenClaw حاليًا: استعلام واحد بـ
openclaw models statusيكفي لمعرفة ذلك - أن تتصفح دليل النماذج لأي provider باستخدام
openclaw models list، فلا تعود تعتمد على البحث لمعرفة «ما النماذج التي يدعمها OpenClaw» - أن تغيّر النموذج الافتراضي باستخدام
openclaw models set <provider/model>دون تعديل ملف الإعدادات يدويًا - أن تبدّل النماذج في أي وقت داخل المحادثة باستخدام عائلة أوامر
/model: سواء بشكل مؤقت أو دائم - أن تستحضر فورًا الخطوات الثلاث عند ربط provider جديد: تثبيت الإضافة ← إعداد بيانات الاعتماد ← اختيار النموذج
مشكلتك الحالية
- يعمل بعد التثبيت، لكنك لا تستطيع تحديد «أي نموذج يُستخدم الآن فعلًا»؛ وتريد التحويل إلى نموذج أرخص أو أقوى لكنك لا تعرف من أين تبدأ
- تبحث عن «ما النماذج التي يدعمها OpenClaw» فتجد إجابات متناقضة، تختلط بها أوامر قديمة من حقبة Clawdbot / Moltbot
- ترى الآخرين يعدّلون
agents.defaultsفي ملف الإعدادات وتريد المحاولة بنفسك، لكنك تخشى أن يتعطل Gateway ولا يعمل بعد التعديل
متى تستخدم هذه الطريقة
عندما تحتاج إلى:
- فهم نظام النماذج في OpenClaw — ما المستخدم حاليًا، وما المتاح أيضًا، وكيف يتم التبديل
- تحويل النموذج الافتراضي إلى نموذج صيني (DeepSeek، Qwen، GLM...)، أو جعل الجلسات المختلفة تستخدم نماذج مختلفة
- التبديل مؤقتًا إلى نموذج أقوى في منتصف المحادثة، ثم العودة بعد انتهائها
وألا تريد:
- تعديل ملف الإعدادات يدويًا في كل مرة تغيّر فيها النموذج
- أن تضيع في دليل الـ providers الرسمي الذي يضم أكثر من 70 إدخالًا
- أن تخلط بين «ربط نموذج جديد» و«تبديل نموذج موجود» فتجرّب عشوائيًا
🎒 التحضير قبل البدء
- أتممت التثبيت: تشغيل OpenClaw في 5 دقائق: تم إعداد provider واحد على الأقل عبر onboarding (تسجيل دخول Claude / Codex أو مفتاح API لخدمة ما)
- Gateway يعمل: يجب أن يظهر في
openclaw gateway statusأنه يستمع على 18789 (يمكن الاستعلام عن النماذج حتى لو لم يكن يعمل، غير أنmodels listسيقرأ دليل الذاكرة المحلية المؤقتة) - إن أردت ربط provider جديد في الوقت نفسه، فجهّز مفتاح API الخاص به — سنستخدم DeepSeek كمثال بدءًا من الدرس التالي
الفكرة الجوهرية
OpenClaw نفسه لا يأتي مع نماذج. النماذج وagent harness (Claude، Codex، النماذج المحلية) كلها إضافات قابلة للاستبدال. كل ربط نموذج = إضافة provider + بيانات اعتماد واحدة. OpenClaw لا يحتوي تكوين النماذج إلا على ثلاثة مفاهيم:
- provider — إضافة لربط نموذج من مزوّد معين، لها id فريد (مثل
deepseek،qwen،anthropic) - مرجع النموذج
provider/model— الصيغة الموحدة للإشارة إلى نموذج بعينه، مثلdeepseek/deepseek-v4-pro - النموذج الافتراضي والتبديل — يُكتب نموذج افتراضي واحد في الإعدادات؛ وفي المحادثة يمكن التبديل في أي وقت عبر
/model
قواعد الإشارة هي أساس الدرس كله:
| القاعدة | مثال | شرح |
|---|---|---|
ما قبل أول / هو id الـ provider | qwen/qwen3.5-plus | id الـ provider يُكتب بحروف صغيرة دائمًا (بعد التوحيد القياسي) |
إذا كان id النموذج يتضمن / فيجب كتابة البادئة كاملة | openrouter/moonshotai/kimi-k2 | التقسيم يتم عند «أول /»، وترك البادئة يعني عدم العثور على النموذج |
| كتابة id النموذج تتبع المزوّد نفسه | minimax/MiniMax-M3 | id نماذج MiniMax حساس لحالة الأحرف، فانسخه كما هو من دليل الإضافة |
طريقتان للربط، جدول واحد يفرّق بينهما:
| إضافة provider رسمية | نقاط نهاية مخصصة / وسيطة | |
|---|---|---|
| ينطبق على | النماذج التي لديها إضافات رسمية (DeepSeek وQwen وGLM وKimi وMiniMax……) | النماذج التي لا تملك إضافة رسمية، ومحطات الترحيل المتوافقة مع OpenAI، وخدمات الاستدلال المحلية |
هل تحتاج إلى كتابة models.providers في الإعدادات | لا: تثبيت الإضافة + ضبط auth + اختيار النموذج | نعم: قائمة baseUrl وapiKey وmodels |
| للتفاصيل | 1.7–1.13 صفحة كل مزود | المزيد من النماذج المحلية ونقاط النهاية الوسيطة المخصصة |
عائلة provider الكبيرة (دليل Provider الرسمي يضم 70+ إدخالاً):
| العائلة | الأمثلة | طريقة الربط | الصفحة المخصصة في هذا الدليل |
|---|---|---|---|
| الشركات الدولية الكبرى | OpenAI (openai) وAnthropic (anthropic) وGoogle (google) | إضافات مدمجة؛ يمكن لـ onboarding إعادة استخدام تسجيل الدخول القائم لـ Claude Code / Codex عبر CLI | التغطية موجودة في قسم البدء السريع |
| النماذج المحلية الصينية | DeepSeek وTongyi Qianwen وZhipu GLM وKimi وMiniMax وDoubao/Volcano وHunyuan وQianfan وStepFun وXiaomi MiMo وLongCat | إضافة رسمية + مفتاح API | 1.7–1.13 صفحة لكل مزود |
| التوجيه المجمّع | OpenRouter وLiteLLM وClawRouter | مفتاح واحد يفتح نماذج عدة مزودين | 1.14 الترحيل والمزيد من النماذج المحلية الصينية |
| النماذج المحلية | Ollama وvLLM وSGLang وLM Studio وds4 | تعمل على جهازك الخاص، بتكلفة API صفرية | 1.15 النماذج المحلية |
خبر سار للمستخدمين في الصين: النماذج المحلية الصينية الرئيسية كلها «مواطنون من الدرجة الأولى» — جميعها لديه إضافة provider رسمية، وبدءاً من 1.7 هناك صفحة لكل مزود مع شرح خطوة بخطوة.
نفّذ معي
الخطوة 1: عرض إعدادات النموذج الحالية — openclaw models status
لماذا: يساعدك onboarding على ضبط النموذج، لكن كثيرين لا يستطيعون تحديد «أي نموذج أستخدم فعلاً». اعرف الوضع الحالي أولاً حتى يكون لكل خطوة لاحقة ما تُقارن به.
openclaw models statusينبغي أن ترى: قطعتين من المعلومات — النموذج الافتراضي وسلسلة fallback بعد التحليل (بمرجع provider/model كامل)، إضافة إلى نظرة عامة على بيانات الاعتماد لكل provider (Auth overview: متغيرات البيئة، وإعدادات provider، ومصادر بيانات الاعتماد الموجودة في تخزين auth). وعند اقتراب انتهاء صلاحية بيانات اعتماد OAuth (خلال 24 ساعة افتراضياً) يظهر تحذير هنا أيضاً.
ثلاث نقاط إضافية:
الأمر
openclaw modelsالمجرد يعادلopenclaw models status؛ أضف--jsonللحصول على تنسيق قابل للقراءة آلياًبدون
--probeفهو لا يرسل طلب نموذج حقيقياً — وجود بيانات الاعتماد «ظاهرياً» لا يعني أنها صالحة للاستخدام؛ للاختبار الفعلي أضف--probe(سيستدعي النموذج فعلاً، وقد يستهلك token ويتسبب في تقييد المعدل)التبديل المؤقت داخل جلسة واحدة لا يظهر في status الخاص بـ CLI، استخدم
/model statusداخل تلك الجلسةفي
openclaw models statusيمكنك العثور على المرجع الكاملprovider/modelللنموذج الافتراضي الحالي
الخطوة 2: استعراض دليل النماذج — openclaw models list (النماذج التي يدعمها OpenClaw تُرى هنا)
لماذا: شاهد البضاعة قبل تغيير النموذج. لكل provider دليل نماذج خاص به: نافذة السياق، وأنواع الإدخال، وهل هو نموذج استدلال — كل ذلك في الجدول.
openclaw models list # 当前已装 provider 的可见模型
openclaw models list --all # 完整发布目录
openclaw models list --provider deepseek # 只看一家ينبغي أن ترى: مرجع نموذج واحد في كل سطر (بصيغة provider/model). يأتي --provider بعده معرّف provider (مثل deepseek وmoonshot)، وليس الاسم المعروض في الواجهة (مثل Moonshot AI).
أربعة تفاصيل عملية:
نسيت معرّف provider؟ شغّل
openclaw models list --allأولاً وابحث في الدليل الكاملالمعرّف غير المعروف لـ provider يسبب خطأ وخروجاً (exit غير صفري)، مع ذكر المعرّف المرفوض
النماذج الصادرة حديثاً قد لا تكون في الدليل المحلي، أضف
--refreshلتشغيل إعادة الاكتشافحفظ بيانات اعتماد مزود معين يجعل نماذجه تدخل الدليل القابل للاختيار — لذا بعد ربط provider جديد في الخطوة 5، تذكّر العودة والتحديث
يسرد
openclaw models list --provider <你已配好的 provider>دليل نماذجه
الخطوة 3: ضبط النموذج الافتراضي — الخطوة الجوهرية في تكوين نماذج OpenClaw
لماذا: النموذج الافتراضي يحدد ما تستخدمه الجلسات الجديدة والمهام المجدولة. الأمر سطر واحد، دون تعديل يدوي لملف الإعدادات.
openclaw models set deepseek/deepseek-v4-pro(المثال يستخدم DeepSeek؛ بشرط تثبيت إضافة provider الخاصة بها — إن لم تكن مثبتة فراجع الخطوة 5 أولاً، أو انتقل مباشرة إلى ربط DeepSeek.)
ينبغي أن ترى: نجاح الأمر دون أخطاء؛ وعند تشغيل openclaw models status مجدداً، يصبح النموذج الافتراضي هو القيمة الجديدة.
ما يفعله: كتابة عنصر الإعدادات agents.defaults.model.primary. الطريقة المكافئة في ملف الإعدادات تبدو هكذا:
{
agents: { defaults: { model: { primary: "deepseek/deepseek-v4-pro" } } },
}قاعدتان لمنع الأخطاء (من وثائق CLI الرسمية):
- رفض مباشر لأي provider غير معروف: exit غير صفري ولا تتغير الإعدادات — يجب أن يكون provider في المرجع إضافة مثبتة أو provider مُعداً بالفعل
- تحذير إذا لم يكن النموذج في الدليل: لا يمنع الكتابة (النماذج الصادرة حديثاً أو المستضافة ذاتياً قد لا تكون دخلت الدليل بعد)، لكن يستحق العودة للتحقق من التهجئة
💡 طريقان آخران لتغيير الافتراضي
openclaw models auth login --provider <id> --set-default يعتمد عند تسجيل الدخول النموذج الافتراضي الموصى به لذلك provider؛ أما النموذج الافتراضي للصور فيُضبط بـ openclaw models set-image <provider/model> (يكتب agents.defaults.imageModel.primary).
- نجح تنفيذ
openclaw models set <provider/model>(أو فهمت لماذا رفضك)
الخطوة 4: تبديل النموذج داخل المحادثة — عائلة أوامر /model
لماذا: ما تضبطه في الطرفية هو «الافتراضي»؛ وفي المحادثة يمكنك التبديل في أي وقت — التبديل المؤقت إلى نموذج أقوى ثم العودة بعد انتهاء الحديث، دون أي تغيير في الإعدادات العامة.
/model # شاهد ما تستخدمه الجلسة الحالية
/model list # استعرض provider (يعمل /models أيضًا)
/model deepseek/deepseek-v4-pro # يبدّل الجلسة الحالية فقط (السلوك الافتراضي)
/model deepseek/deepseek-v4-pro -a # يحدّث أيضًا الافتراضي لهذا الـ agent (يتطلب owner/admin)
/model deepseek/deepseek-v4-pro -g # يحدّث الافتراضي العام (يتطلب owner/admin)
/model default -s # يمسح اختيار هذه الجلسة ويعود إلى الافتراضي في الإعدادات
/model status # مرشحات بيانات الاعتماد لكل provider ووضع baseUrl / apiيجب أن ترى: أمر التبديل يسري فورًا — عندما يكون الـ agent خاملاً تستخدم التشغيلة التالية النموذج الجديد؛ وإذا كان قيد التشغيل فيُدرج في الطابور حتى نقطة التبديل الآمنة التالية. /models <provider> يسرد جميع نماذج مزوّد معيّن.
ثلاث طباع يجب معرفتها:
- الاختيار داخل الجلسة «صارم»: إذا كان النموذج المختار غير متاح يظهر خطأ مباشرة، ولن يلجأ خفيةً إلى سلسلة fallback (الافتراضي المُعد هو فقط ما يمر عبر fallback)
- الاختيار بالأرقام غير مدعوم (
/model 3غير صالح)؛ Discord / Telegram فيهما واجهة اختيار أصلية - عندما يتضمن معرّف النموذج
/يجب كتابة البادئة كاملة:/model openrouter/moonshotai/kimi-k2
إلى جانب /model هناك عائلة كبيرة من أوامر المحادثة مثل /think و/new، انظر دورة سريعة في أوامر المحادثة.
- في المحادثة، بعد التبديل عبر
/model <provider/model>يأتي الرد التالي من النموذج الجديد
الخطوة 5: ربط provider جديد — تثبيت الإضافة، إعداد بيانات الاعتماد، اختيار النموذج
لماذا: إذا أعجبك نموذج مزوّد معيّن في الدليل، اجعل OpenClaw «يتعرف» عليه أولًا. إضافات provider الرسمية تتبع ثلاث خطوات ثابتة:
① تثبيت الإضافة (بعض الـ providers تحتاجها) → ② إعداد بيانات الاعتماد (openclaw onboard) → ③ اختيار النموذجخذ DeepSeek كمثال (إنها إضافة رسمية خارجية وتحتاج إلى تثبيت):
openclaw plugins install @openclaw/deepseek-provider
openclaw onboard --auth-choice deepseek-api-keyيجب أن ترى: يكتشف onboarding وصولًا موجودًا إلى الذكاء الاصطناعي → ينتظر اختيارك للـ provider → بعد نجاح التحقق من الاتصال يحفظ المسارات المتاحة فقط → يكمل إعداد الأجزاء المتبقية. بعد اختيار --auth-choice، تُفلتر مسبقًا قائمة اختيار النموذج الافتراضي إلى نماذج هذا الـ provider (وتُطابق أيضًا الـ providers الشقيقة من نفس الإضافة، مثل volcengine / volcengine-plan).
ثلاثة أمور يجب أن تكون واضحة لديك:
- هل تحتاج الإضافة إلى تثبيت يختلف من مزوّد لآخر: MiniMax إضافة مدمجة (bundled)، و
openclaw plugins enable minimaxيكفي؛ أما DeepSeek وQwen وGLM وKimi وغيرها من الإضافات الخارجية فتحتاجopenclaw plugins install @openclaw/<名字>-provider. الأمر الدقيق لكل مزوّد مذكور في بداية الصفحة المخصصة له في الأقسام 1.7–1.13 - الإضافات الرسمية لا تحتاج إلى كتابة مدخل في
models.providers— ثبّت الإضافة، اضبط auth، اختر النموذج، وتنتهي في ثلاث خطوات؛ لا تكتبه إلا عند استخدام نقطة نهاية مخصصة أو تجاوز baseUrl (انظر 1.14) - إعادة onboard لا تمسح إعدادات النماذج الموجودة؛ عند تغيير provider النموذج أو مسار auth، توصي الجهة الرسمية بتشغيل
openclaw onboard(ويُتركopenclaw configureللإعدادات من غير نوع الاستدلال)
النماذج التي لا تتوفر لها إضافات رسمية بعد، مثل Yi من 01.AI وBaichuan وiFlytek Spark، تُستخدم عبر نقطة نهاية متوافقة مع OpenAI مخصصة أو عبر مزوّد تجميع، انظر المزيد من النماذج المحلية ونقاط الترحيل المخصصة؛ وإذا كنت لا ترغب في إنفاق مال على API، فإن النماذج المحلية يعلّمك تشغيل النماذج على جهازك باستخدام Ollama وvLLM.
- تستطيع أن تقول من حفظك ترتيب الخطوات الثلاث لربط provider جديد: تثبيت الإضافة → إعداد بيانات الاعتماد → اختيار النموذج
نقطة تفتيش ✅
openclaw models statusتستطيع ذكر مرجعprovider/modelالكامل للنموذج الافتراضي الحاليopenclaw models list --provider <id>تستطيع سرد دليل النماذج لمزوّد واحدopenclaw models set <provider/model>نجح تغيير الافتراضي (أو فهمت لماذا يرفض)- التبديل عبر
/model <provider/model>في المحادثة يسري، و/model default -sتعيدك إلى الافتراضي - تستطيع ذكر ترتيب الخطوات الثلاث لربط provider جديد: تثبيت الإضافة → إعداد بيانات الاعتماد → اختيار النموذج
تنبيهات للمزالق
❌ مرجع النموذج بدون بادئة provider
السبب: OpenClaw يقسم المرجع عند «أول /». عند حذف provider يجرّب أولًا الأسماء المستعارة، ثم الـ provider المُعد الوحيد المطابق، وأخيرًا الـ provider الافتراضي (وهو سلوك مهمل) — يكفي وجود نموذج آخر بنفس الاسم حتى يفشل التحديد.
/model kimi-k2 # ❌ في معظم الحالات لا يُحدَّد
/model kimi/kimi-for-coding # ✅ مع بادئة provider
/model openrouter/moonshotai/kimi-k2 # ✅ عندما يتضمن معرّف النموذج / يجب كتابة البادئة كاملةالطريقة الصحيحة: اكتب المرجع دائمًا كاملًا بصيغة provider/model؛ وإذا لم تكن متأكدًا فشغّل openclaw models list --provider <id> أولًا وانسخ النص كما هو من الدليل (معرّفات النماذج لدى MiniMax وغيرها من المزوّدين حساسة لحالة الأحرف).
❌ أعددت Key لـ provider جديد وتظن أن النموذج الافتراضي سيتبدل تلقائيًا
السبب: حفظ بيانات اعتماد provider جديد لا يغيّر النموذج الافتراضي الحالي — بالنص الحرفي من قواعد Quick الرسمية: «Adding provider auth does not change your primary model»، ولا يتبدل إلا عبر --set-default صريح.
الطريقة الصحيحة: لتغيير الافتراضي استخدم openclaw models set <provider/model>، أو openclaw models auth login --provider <id> --set-default عند تسجيل الدخول. إذا لم تطابق الأعراض، فشغّل openclaw models status أولًا لترى من هو الافتراضي فعلًا.
❌ بعد تثبيت Gateway كـ daemon، يبدو أن API Key المُصدَّرة عبر export «لا تسري»
السبب: عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة التي export في صدفتك التفاعلية — جميع وثائق الـ providers تشدد على هذه النقطة تحديدًا.
الطريقة الصحيحة: اكتب الـ Key في ~/.openclaw/.env، أو زوّدها عبر env.shellEnv في الإعدادات؛ وإذا غيّرت الـ Key فتذكّر إعادة تشغيل خدمة Gateway.
❌ استخدام معرّف نموذج قديم متقاعد
السبب: النماذج تُتقاعد. deepseek-chat / deepseek-reasoner من DeepSeek تُقاعدتا في 2026-07-24، والمعرّفات القديمة لم تعد متاحة.
الطريقة الصحيحة: شغّل openclaw models list --provider deepseek لرؤية الدليل الحالي واستخدم معرّفات جديدة مثل deepseek/deepseek-v4-pro وdeepseek/deepseek-v4-flash؛ تفاصيل الترحيل في الدرس التالي ربط DeepSeek.
تقنيات متقدمة (اختياري)
إعداد سلسلة fallback للنموذج الافتراضي. تُجرَّب النماذج في agents.defaults.model.fallbacks بالترتيب؛ تدوير بيانات الاعتماد يحدث داخل الـ provider نفسه، ثم ينتقل إلى نموذج fallback التالي. الإدارة عبر CLI:
openclaw models fallbacks list
openclaw models fallbacks add deepseek/deepseek-v4-flash
openclaw models fallbacks remove <model-or-alias>
openclaw models fallbacks clearدع OpenClaw يختار لك fallback مجانيًا. يقرأ openclaw models scan دليل :free العام من OpenRouter ويختار المرشحين وفق دعم الصور وزمن استجابة الأدوات والسياق وغيرها. ملاحظتان: فحص البيانات الوصفية لا يحتاج Key، أما الفحص الفوري و--set-default فيحتاجان OPENROUTER_API_KEY؛ الفحص مع probing يكتب في الإعدادات (يستبدل fallbacks مباشرة)، وإذا أردت الاطلاع فقط فأضف --no-probe.
إعطاء اسم مستعار للنموذج. openclaw models aliases add Opus anthropic/claude-opus-5-5 بعد ذلك، يمكن اختياره في الدردشة عبر /model Opus. تُخزَّن الأسماء المستعارة في agents.defaults.models.<key>.alias؛ ويمكن لنموذج واحد أن يكون له اسم مستعار واحد فقط في كل مرة، وإضافة اسم جديد تحل محل القديم.
تحديد النموذج لتشغيل واحد. إذا كنت لا تريد تغيير أي إعدادات وتشغيل شيء لمرة واحدة:
openclaw agent --model deepseek/deepseek-v4-pro --message "..."يمكن أيضًا إدارة النماذج من واجهة Control UI. توفر صفحة Models في Gateway نفس تدفق تسجيل الدخول المتوفر في CLI؛ واستخدام Settings → Models → Set API key يغيّر المفتاح مباشرة، وبمجرد التغيير تُمسح فترة التهدئة وعدّاد الإخفاق لذلك الاعتماد، فيصبح الطلب التالي متاحًا للتجربة فورًا.
تحديث دليل النماذج المستضافة. openclaw models refresh يسحب دليل البيانات الوصفية الرسمي المستضاف (النماذج الجديدة تدخل الدليل من هنا)؛ ويتطلب أن يكون Gateway المحلي متوقفًا أولًا (openclaw gateway stop)، ثم يُعاد تشغيله بعد التحديث.
خلاصة هذا الدرس
✅ OpenClaw صارت المفاهيم الثلاثة لإعداد النماذج واضحة: المزوّد provider (إضافة + اعتمادات)، والمرجع provider/model، والنموذج الافتراضي والتبديل بينها.
✅ اكتملت سلسلة الأوامر: تحقّق ← اعرض ← عيّن ← بدّل: models status لرؤية الحالة الحالية، وmodels list لعرض الدليل، وmodels set لتعيين الافتراضي، و/model للتبديل في الدردشة.
✅ استقرت الخطوات الثلاث لربط مزوّد جديد: تثبيت الإضافة (إذا لزم) ← openclaw onboard --auth-choice <id> لإعداد الاعتمادات ← اختيار النموذج؛ الإضافات الرسمية لا تكتب models.providers.
✅ تذكّر السلوكان المميزان: اختيار /model داخل الجلسة مطابقة صارمة بلا fallback؛ وفي وضع البرنامج الخفي يجب أن يوضع المفتاح في ~/.openclaw/.env.
| حقل الإعداد / الأمر | الشكل / القيمة الموصى بها | الشرح |
|---|---|---|
agents.defaults.model.primary | "provider/model" | النموذج الافتراضي؛ openclaw models set يُكتب هنا |
agents.defaults.model.fallbacks | قائمة مراجع النماذج | سلسلة الاحتياط، تُجرَّب بالترتيب |
agents.defaults.models.<key>.alias | سلسلة الاسم المستعار | اختصار للوصول إلى /model <别名> |
models.providers.<id> | يُكتب فقط لنقطة نهاية مخصصة | غير مطلوب للإضافات الرسمية |
~/.openclaw/.env | PROVIDER_API_KEY=... | موضع المفتاح في وضع البرنامج الخفي |
openclaw onboard --auth-choice <id> | القيم في الصفحة المخصصة لكل مزوّد | إعداد / تغيير اعتمادات المزوّد |
القائمة الكاملة للمرجع السريع للأوامر موجودة في مرجع سريع لأوامر وإعدادات CLI.
استعراض الدرس التالي
اتضح النظام، ومن الدرس التالي نبدأ التطبيق العملي مع كل مزوّد على حدة — الأول هو DeepSeek الأكثر استخدامًا. الدرس التالي ربط DeepSeek: تطبيق عملي لإعداد نماذج سلسلة V4.
ستتعلم:
- دليل نماذج سلسلة DeepSeek V4:
deepseek-v4-pro/deepseek-v4-flashوكيفية الاختيار بينها - الخطوات الكاملة لإعداد
DEEPSEEK_API_KEY: تثبيت الإضافة، وonboarding، وثلاث طرق لكتابة ملف الإعداد - الترحيل بعد تقاعد المعرفات القديمة
deepseek-chat/deepseek-reasoner - قدرات DeepSeek الخاصة: مستويات thinking، واستعادة أدوات DSML، وweb_search