موفّرو النماذج

مرجع لمزوّدي LLM/النماذج (وليس قنوات الدردشة مثل WhatsApp/Telegram). لقواعد اختيار النماذج، راجع النماذج.

قواعد سريعة

سلوك المزوّد المملوك للـ Plugin

توجد معظم المنطق الخاص بالمزوّدين في Plugins المزوّدين (registerProvider(...)) بينما يُبقي OpenClaw حلقة الاستدلال العامة. تملك Plugins الإعداد الأولي، وكتالوجات النماذج، وربط متغيرات بيئة المصادقة، وتطبيع النقل/الإعدادات، وتنظيف مخطط الأدوات، وتصنيف تجاوز الفشل، وتحديث OAuth، وتقارير الاستخدام، وملفات التفكير/الاستدلال، والمزيد.

توجد القائمة الكاملة لخطافات SDK المزوّد وأمثلة Plugins المضمنة في Plugins المزوّدين. المزوّد الذي يحتاج إلى منفّذ طلبات مخصص بالكامل هو سطح امتداد منفصل وأعمق.

تدوير مفاتيح API

Plugins المزوّدين الرسمية

تنشر Plugins المزوّدين الرسمية صفوف كتالوج النماذج الخاصة بها. لا يتطلب هؤلاء المزوّدون أي إدخالات نماذج models.providers؛ فعّل Plugin المزوّد، واضبط المصادقة، واختر نموذجًا. استخدم models.providers فقط للمزوّدين المخصصين الصريحين أو لإعدادات طلب ضيقة مثل المهلات.

OpenAI

• المزوّد: openai
• المصادقة: OPENAI_API_KEY
• التدوير الاختياري: OPENAI_API_KEYS، OPENAI_API_KEY_1، OPENAI_API_KEY_2، بالإضافة إلى OPENCLAW_LIVE_OPENAI_KEY (تجاوز واحد)
• أمثلة نماذج: openai/gpt-5.5، openai/gpt-5.4-mini
• تحقق من توفر الحساب/النموذج باستخدام openclaw models list --provider openai إذا كان تثبيت معين أو مفتاح API يتصرف بصورة مختلفة.
• CLI: openclaw onboard --auth-choice openai-api-key
• النقل الافتراضي هو auto؛ يمرّر OpenClaw اختيار النقل إلى وقت تشغيل النموذج المشترك.
• تجاوز لكل نموذج عبر agents.defaults.models["openai/<model>"].params.transport ("sse" أو "websocket" أو "auto")
• يمكن تفعيل معالجة أولوية OpenAI عبر agents.defaults.models["openai/<model>"].params.serviceTier
• تربط /fast وparams.fastMode طلبات Responses المباشرة لـ openai/* إلى service_tier=priority على api.openai.com
• استخدم params.serviceTier عندما تريد طبقة صريحة بدلًا من مفتاح التبديل المشترك /fast
• تنطبق ترويسات نسبة OpenClaw المخفية (originator، version، User-Agent) فقط على حركة OpenAI الأصلية إلى api.openai.com، وليس على وكلاء OpenAI-compatible العامين
• تحتفظ مسارات OpenAI الأصلية أيضًا بـ Responses store، وتلميحات ذاكرة التخزين المؤقت للمطالبات، وتشكيل حمولات توافق الاستدلال في OpenAI؛ ولا تفعل مسارات الوكيل ذلك
• يتوفر openai/gpt-5.3-codex-spark عبر مصادقة اشتراك ChatGPT/Codex OAuth عندما يتيحه حسابك المسجّل؛ لا يزال OpenClaw يحجب مسارات مفتاح API المباشر لـ OpenAI ومفتاح API لـ Azure لهذا النموذج لأن تلك النقلات ترفضه

{  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

Anthropic

• المزوّد: anthropic
• المصادقة: ANTHROPIC_API_KEY
• التدوير الاختياري: ANTHROPIC_API_KEYS، ANTHROPIC_API_KEY_1، ANTHROPIC_API_KEY_2، بالإضافة إلى OPENCLAW_LIVE_ANTHROPIC_KEY (تجاوز واحد)
• مثال نموذج: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• تدعم طلبات Anthropic العامة المباشرة مفتاح التبديل المشترك /fast وparams.fastMode، بما في ذلك حركة المرور المرسلة إلى api.anthropic.com بمفتاح API أو مصادقة OAuth؛ يربط OpenClaw ذلك إلى service_tier في Anthropic (auto مقابل standard_only)
• يحافظ إعداد Claude CLI المفضّل على مرجع النموذج معياريًا ويختار خلفية CLI بصورة منفصلة: anthropic/claude-opus-4-8 مع agentRuntime.id: "claude-cli" على نطاق النموذج. لا تزال مراجع claude-cli/claude-opus-4-7 القديمة تعمل للتوافق.

{  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}

OpenAI ChatGPT/Codex OAuth

• المزوّد: openai
• المصادقة: OAuth (ChatGPT)
• مرجع نموذج OpenAI Codex القديم: openai/gpt-5.5
• مرجع حزمة تشغيل خادم تطبيق Codex الأصلية: openai/gpt-5.5
• مستندات حزمة تشغيل خادم تطبيق Codex الأصلية: حزمة Codex
• مراجع النماذج القديمة: codex/gpt-*
• حد Plugin: يحمّل openai/* Plugin الخاص بـ OpenAI؛ ويُختار Plugin خادم تطبيق Codex الأصلي بواسطة وقت تشغيل حزمة Codex.
• CLI: openclaw onboard --auth-choice openai أو openclaw models auth login --provider openai
• النقل الافتراضي هو auto (WebSocket أولًا، مع رجوع احتياطي إلى SSE)
• تجاوز لكل نموذج OpenAI Codex عبر agents.defaults.models["openai/<model>"].params.transport ("sse" أو "websocket" أو "auto")
• يُمرَّر params.serviceTier أيضًا في طلبات Responses الأصلية لـ Codex (chatgpt.com/backend-api)
• لا تُرفق ترويسات نسبة OpenClaw المخفية (originator، version، User-Agent) إلا على حركة Codex الأصلية إلى chatgpt.com/backend-api، وليس على وكلاء OpenAI-compatible العامين
• يشارك إعداد /fast وparams.fastMode نفسه مثل openai/* المباشر؛ يربط OpenClaw ذلك إلى service_tier=priority
• يستخدم openai/gpt-5.5 قيمة contextWindow = 400000 الأصلية من كتالوج Codex ووقت تشغيل افتراضي contextTokens = 272000؛ تجاوز حد وقت التشغيل باستخدام models.providers.openai.models[].contextTokens
• ملاحظة سياسة: OpenAI Codex OAuth مدعوم صراحةً للأدوات/سير العمل الخارجية مثل OpenClaw.
• لمسار الاشتراك الشائع مع وقت تشغيل Codex الأصلي، سجّل الدخول باستخدام مصادقة openai واضبط openai/gpt-5.5؛ تختار دورات وكلاء OpenAI Codex افتراضيًا.
• استخدم agentRuntime.id: "openclaw" على مستوى المزوّد/النموذج فقط عندما تريد مسار OpenClaw المدمج؛ وإلا فأبقِ openai/gpt-5.5 على حزمة Codex الافتراضية.
• مراجع GPT الخاصة بـ Codex القديمة هي حالة قديمة، وليست مسار مزوّد حي. استخدم openai/gpt-5.5 على وقت تشغيل Codex الأصلي لإعداد وكيل جديد، وشغّل openclaw doctor --fix لترحيل مراجع نماذج Codex القديمة إلى مراجع openai/* المعيارية.

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

خيارات مستضافة أخرى بنمط الاشتراك

OpenCode

• المصادقة: OPENCODE_API_KEY (أو OPENCODE_ZEN_API_KEY)
• مزوّد وقت تشغيل Zen: opencode
• مزوّد وقت تشغيل Go: opencode-go
• أمثلة نماذج: opencode/claude-opus-4-6، opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen أو openclaw onboard --auth-choice opencode-go

{  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },}

Google Gemini (مفتاح API)

• المزوّد: google
• المصادقة: GEMINI_API_KEY
• التدوير الاختياري: GEMINI_API_KEYS، وGEMINI_API_KEY_1، وGEMINI_API_KEY_2، والرجوع الاحتياطي إلى GOOGLE_API_KEY، وOPENCLAW_LIVE_GEMINI_KEY (تجاوز واحد)
• أمثلة النماذج: google/gemini-3.1-pro-preview، وgoogle/gemini-3-flash-preview
• التوافق: تُطبّع إعدادات OpenClaw القديمة التي تستخدم google/gemini-3.1-flash-preview إلى google/gemini-3-flash-preview
• الاسم المستعار: يُقبل google/gemini-3.1-pro ويُطبّع إلى معرّف Gemini API الحي من Google، وهو google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• التفكير: يستخدم /think adaptive التفكير الديناميكي من Google. يحذف Gemini 3/3.1 قيمة thinkingLevel الثابتة؛ ويرسل Gemini 2.5 القيمة thinkingBudget: -1.
• تقبل عمليات تشغيل Gemini المباشرة أيضًا agents.defaults.models["google/<model>"].params.cachedContent (أو الصيغة القديمة cached_content) لتمرير مقبض أصلي للمزوّد بصيغة cachedContents/...؛ وتظهر إصابات ذاكرة التخزين المؤقت في Gemini كـ cacheRead في OpenClaw

Google Vertex وGemini CLI

• المزوّدون: google-vertex، وgoogle-gemini-cli
• المصادقة: يستخدم Vertex بيانات اعتماد gcloud ADC؛ ويستخدم Gemini CLI تدفق OAuth الخاص به

يُشحن OAuth الخاص بـ Gemini CLI كجزء من Plugin google المضمّن.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

يستخدم Gemini CLI الخيار stream-json افتراضيًا. يقرأ OpenClaw رسائل دفق المساعد ويطبّع stats.cached إلى cacheRead؛ ولا تزال تجاوزات --output-format json القديمة تقرأ نص الرد من response.

Z.AI (GLM)

• المزوّد: zai
• المصادقة: ZAI_API_KEY
• مثال النموذج: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • تستخدم مراجع النماذج معرّف المزوّد القياسي zai/*.
  • يكتشف zai-api-key تلقائيًا نقطة نهاية Z.AI المطابقة؛ بينما تفرض zai-coding-global، وzai-coding-cn، وzai-global، وzai-cn سطحًا محددًا

Vercel AI Gateway

• المزوّد: vercel-ai-gateway
• المصادقة: AI_GATEWAY_API_KEY
• أمثلة النماذج: vercel-ai-gateway/anthropic/claude-opus-4.6، وvercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Plugins المزوّدين المضمّنة الأخرى

خصائص ينبغي معرفتها

المزوّدون عبر models.providers (عنوان URL مخصص/أساسي)

استخدم models.providers (أو models.json) لإضافة مزوّدين مخصصين أو وكلاء متوافقين مع OpenAI/Anthropic.

تُنشر العديد من Plugins المزوّدة أدناه كتالوجًا افتراضيًا بالفعل. استخدم إدخالات models.providers.<id> الصريحة فقط عندما تريد تجاوز عنوان URL الأساسي الافتراضي أو الرؤوس أو قائمة النماذج.

تقرأ فحوصات قدرات نماذج Gateway أيضًا بيانات models.providers.<id>.models[] الوصفية الصريحة. إذا كان نموذج مخصص أو وكيل يقبل الصور، فعيّن input: ["text", "image"] على ذلك النموذج حتى تمرر مسارات مرفقات WebChat والصادرة من Node الصور كمدخلات نموذج أصلية بدلًا من مراجع وسائط نصية فقط.

يتحكم agents.defaults.models["provider/model"] فقط في ظهور النماذج والأسماء المستعارة والبيانات الوصفية لكل نموذج للوكلاء. ولا يسجّل نموذج تشغيل جديدًا بحد ذاته. بالنسبة إلى نماذج المزوّدين المخصصة، أضف أيضًا models.providers.<provider>.models[] مع id المطابق على الأقل.

Moonshot AI (Kimi)

ثبّت @openclaw/moonshot-provider قبل الإعداد الأولي. أضف إدخال models.providers.moonshot صريحًا فقط عندما تحتاج إلى تجاوز عنوان URL الأساسي أو بيانات النموذج الوصفية:

• المزوّد: moonshot
• المصادقة: MOONSHOT_API_KEY
• نموذج مثال: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key أو openclaw onboard --auth-choice moonshot-api-key-cn

معرّفات نماذج Kimi K2:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  agents: {    defaults: { model: { primary: "moonshot/kimi-k2.6" } },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],      },    },  },}

ترميز Kimi

يستخدم Kimi Coding نقطة نهاية Moonshot AI المتوافقة مع Anthropic:

• المزوّد: kimi
• المصادقة: KIMI_API_KEY
• نموذج مثال: kimi/kimi-for-coding

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: { model: { primary: "kimi/kimi-for-coding" } },  },}

تظل kimi/kimi-code وkimi/k2p5 القديمة مقبولة كمعرّفات نماذج للتوافق، وتُطبّع إلى معرّف نموذج API المستقر لدى Kimi.

Volcano Engine (Doubao)

يوفر Volcano Engine (火山引擎) الوصول إلى Doubao ونماذج أخرى في الصين.

• المزوّد: volcengine (للترميز: volcengine-plan)
• المصادقة: VOLCANO_ENGINE_API_KEY
• نموذج مثال: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

تكون الإعدادات الافتراضية للتهيئة الأولية على سطح الترميز، لكن كتالوج volcengine/* العام يُسجَّل في الوقت نفسه.

في منتقيات النماذج أثناء التهيئة الأولية/الضبط، يفضّل خيار مصادقة Volcengine صفوف volcengine/* وvolcengine-plan/* معًا. إذا لم تكن تلك النماذج محمّلة بعد، يعود OpenClaw إلى الكتالوج غير المصفّى بدلًا من إظهار منتقٍ فارغ مقيّد بالمزوّد.

BytePlus (دولي)

يوفّر BytePlus ARK وصولًا إلى النماذج نفسها التي يوفّرها Volcano Engine للمستخدمين الدوليين.

• المزوّد: byteplus (للترميز: byteplus-plan)
• المصادقة: BYTEPLUS_API_KEY
• نموذج مثال: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{  agents: {    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },  },}

تكون الإعدادات الافتراضية للتهيئة الأولية على سطح الترميز، لكن كتالوج byteplus/* العام يُسجَّل في الوقت نفسه.

في منتقيات النماذج أثناء التهيئة الأولية/الضبط، يفضّل خيار مصادقة BytePlus صفوف byteplus/* وbyteplus-plan/* معًا. إذا لم تكن تلك النماذج محمّلة بعد، يعود OpenClaw إلى الكتالوج غير المصفّى بدلًا من إظهار منتقٍ فارغ مقيّد بالمزوّد.

Synthetic

يوفّر Synthetic نماذج متوافقة مع Anthropic خلف المزوّد synthetic:

• المزوّد: synthetic
• المصادقة: SYNTHETIC_API_KEY
• نموذج مثال: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],      },    },  },}

MiniMax

يُضبط MiniMax عبر models.providers لأنه يستخدم نقاط نهاية مخصّصة:

• MiniMax OAuth (عالمي): --auth-choice minimax-global-oauth
• MiniMax OAuth (الصين): --auth-choice minimax-cn-oauth
• مفتاح MiniMax API (عالمي): --auth-choice minimax-global-api
• مفتاح MiniMax API (الصين): --auth-choice minimax-cn-api
• المصادقة: MINIMAX_API_KEY لـ minimax؛ وMINIMAX_OAUTH_TOKEN أو MINIMAX_API_KEY لـ minimax-portal

راجع /providers/minimax لتفاصيل الإعداد وخيارات النماذج ومقتطفات الضبط.

تقسيم القدرات المملوك من Plugin:

• تبقى الإعدادات الافتراضية للنص/الدردشة على minimax/MiniMax-M3
• توليد الصور هو minimax/image-01 أو minimax-portal/image-01
• فهم الصور هو MiniMax-VL-01 المملوك من Plugin على مساري مصادقة MiniMax
• يبقى بحث الويب على معرّف المزوّد minimax

LM Studio

يأتي LM Studio بوصفه Plugin مزوّدًا مضمّنًا يستخدم واجهة API الأصلية:

• المزوّد: lmstudio
• المصادقة: LM_API_TOKEN
• عنوان URL الأساسي الافتراضي للاستدلال: http://localhost:1234/v1

ثم اضبط نموذجًا (استبدله بأحد المعرّفات التي يعيدها http://localhost:1234/api/v1/models):

{  agents: {    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },  },}

يستخدم OpenClaw نقاط LM Studio الأصلية /api/v1/models و/api/v1/models/load للاكتشاف والتحميل التلقائي، مع /v1/chat/completions للاستدلال افتراضيًا. إذا أردت أن يتولى تحميل LM Studio عند الطلب، وTTL، والإخراج التلقائي إدارة دورة حياة النموذج، فاضبط models.providers.lmstudio.params.preload: false. راجع /providers/lmstudio للإعداد واستكشاف الأخطاء وإصلاحها.

Ollama

يأتي Ollama بوصفه Plugin مزوّدًا مضمّنًا ويستخدم واجهة API الأصلية الخاصة بـ Ollama:

• المزوّد: ollama
• المصادقة: غير مطلوبة (خادم محلي)
• نموذج مثال: ollama/llama3.3
• التثبيت: https://ollama.com/download

# Install Ollama, then pull a model:ollama pull llama3.3

{  agents: {    defaults: { model: { primary: "ollama/llama3.3" } },  },}

يُكتشف Ollama محليًا عند http://127.0.0.1:11434 عندما تختار ذلك باستخدام OLLAMA_API_KEY، ويضيف Plugin المزوّد المضمّن Ollama مباشرةً إلى openclaw onboard ومنتقي النماذج. راجع /providers/ollama للتهيئة الأولية، ووضع السحابة/المحلي، والضبط المخصّص.

vLLM

يأتي vLLM بوصفه Plugin مزوّدًا مضمّنًا للخوادم المحلية/ذاتية الاستضافة المتوافقة مع OpenAI:

• المزوّد: vllm
• المصادقة: اختيارية (تعتمد على خادمك)
• عنوان URL الأساسي الافتراضي: http://127.0.0.1:8000/v1

للاشتراك في الاكتشاف التلقائي محليًا (تعمل أي قيمة إذا كان خادمك لا يفرض المصادقة):

export VLLM_API_KEY="vllm-local"

ثم اضبط نموذجًا (استبدله بأحد المعرّفات التي يعيدها /v1/models):

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

راجع /providers/vllm للتفاصيل.

SGLang

يأتي SGLang بوصفه Plugin مزوّدًا مضمّنًا للخوادم السريعة ذاتية الاستضافة المتوافقة مع OpenAI:

• المزوّد: sglang
• المصادقة: اختيارية (تعتمد على خادمك)
• عنوان URL الأساسي الافتراضي: http://127.0.0.1:30000/v1

للاشتراك في الاكتشاف التلقائي محليًا (تعمل أي قيمة إذا كان خادمك لا يفرض المصادقة):

export SGLANG_API_KEY="sglang-local"

ثم اضبط نموذجًا (استبدله بأحد المعرّفات التي يعيدها /v1/models):

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

راجع /providers/sglang للتفاصيل.

الوكلاء المحليون (LM Studio وvLLM وLiteLLM وغير ذلك)

مثال (متوافق مع OpenAI):

{  agents: {    defaults: {      model: { primary: "lmstudio/my-local-model" },      models: { "lmstudio/my-local-model": { alias: "Local" } },    },  },  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        timeoutSeconds: 300,        models: [          {            id: "my-local-model",            name: "Local Model",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },}

أمثلة CLI

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

راجع أيضًا: الضبط للحصول على أمثلة ضبط كاملة.

ذو صلة

• مرجع الضبط - مفاتيح ضبط النماذج
• تجاوز فشل النموذج - سلاسل الرجوع وسلوك إعادة المحاولة
• النماذج - ضبط النماذج والأسماء المستعارة
• المزوّدون - أدلة الإعداد الخاصة بكل مزوّد