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

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

قواعد سريعة

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

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

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

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

المزوّدون المضمّنون (فهرس pi-ai)

يشحن OpenClaw مع فهرس pi-ai. لا يتطلب هؤلاء المزوّدون أي إعداد 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 اختيار النقل إلى pi-ai.
• تجاوز لكل نموذج عبر 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
• تحتفظ مسارات OpenAI الأصلية أيضًا بقيم Responses store، وتلميحات ذاكرة التخزين المؤقت للمطالبات، وتشكيل حمولة التوافق مع الاستدلال في OpenAI؛ أما مسارات الوكيل فلا تفعل ذلك
• يُخفى openai/gpt-5.3-codex-spark عمدًا في OpenClaw لأن طلبات API الحية من OpenAI ترفضه ولا يعرضه فهرس Codex الحالي

{  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 وOAuth المرسلة إلى api.anthropic.com؛ ويربط OpenClaw ذلك بـ service_tier في Anthropic (auto مقابل standard_only)
• يحافظ إعداد Claude CLI المفضل على مرجع النموذج معياريًا ويحدد خلفية CLI بشكل منفصل: anthropic/claude-opus-4-7 مع agentRuntime.id: "claude-cli" على نطاق النموذج. لا تزال مراجع claude-cli/claude-opus-4-7 القديمة تعمل للتوافق.

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

OpenAI Codex OAuth

• المزوّد: openai-codex
• المصادقة: OAuth (ChatGPT)
• مرجع نموذج PI القديم: openai-codex/gpt-5.5
• مرجع حزمة تشغيل خادم تطبيق Codex الأصلية: openai/gpt-5.5
• مستندات حزمة تشغيل خادم تطبيق Codex الأصلية: حزمة تشغيل Codex
• مراجع النماذج القديمة: codex/gpt-*
• حد Plugin: يحمّل openai-codex/* Plugin الخاصة بـ OpenAI؛ ولا تُختار Plugin خادم تطبيق Codex الأصلية إلا بواسطة تشغيل حزمة Codex أو مراجع codex/* القديمة.
• CLI: openclaw onboard --auth-choice openai-codex أو openclaw models auth login --provider openai-codex
• النقل الافتراضي هو auto (WebSocket أولًا، ثم SSE كرجوع احتياطي)
• تجاوز لكل نموذج PI عبر agents.defaults.models["openai-codex/<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
• يشارك مفتاح التبديل /fast وإعداد params.fastMode نفسيهما مثل openai/* المباشر؛ ويربط OpenClaw ذلك بـ service_tier=priority
• يستخدم openai-codex/gpt-5.5 قيمة contextWindow = 400000 الأصلية من فهرس Codex وتشغيلًا افتراضيًا contextTokens = 272000؛ تجاوز حد التشغيل باستخدام models.providers.openai-codex.models[].contextTokens
• ملاحظة سياسة: OpenAI Codex OAuth مدعوم صراحة للأدوات/سير العمل الخارجية مثل OpenClaw.
• للمسار الشائع الذي يجمع الاشتراك مع تشغيل Codex الأصلي، سجّل الدخول بمصادقة openai-codex لكن اضبط openai/gpt-5.5؛ تختار دورات وكيل OpenAI Codex افتراضيًا.
• استخدم agentRuntime.id: "pi" على مستوى المزوّد/النموذج فقط عندما تريد مسار توافق عبر PI؛ وإلا فأبقِ openai/gpt-5.5 على حزمة Codex الافتراضية.
• تُخفى مراجع openai-codex/gpt-5.1* وopenai-codex/gpt-5.2* وopenai-codex/gpt-5.3* الأقدم لأن حسابات ChatGPT/Codex OAuth ترفضها؛ استخدم openai-codex/gpt-5.5 أو مسار تشغيل Codex الأصلي بدلًا من ذلك.

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

{  models: {    providers: {      "openai-codex": {        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 ضمن OpenClaw باسم cacheRead

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

يتم تحليل ردود JSON من Gemini CLI من response؛ ويعود استخدام الرموز إلى stats، مع تطبيع stats.cached إلى cacheRead في OpenClaw.

Z.AI (GLM)

• المزوّد: zai
• المصادقة: ZAI_API_KEY
• نموذج مثال: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • الأسماء المستعارة: يتم تطبيع z.ai/* وz-ai/* إلى 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

Kilo Gateway

• المزوّد: kilocode
• المصادقة: KILOCODE_API_KEY
• نموذج مثال: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• عنوان URL الأساسي: https://api.kilo.ai/api/gateway/
• يشحن كتالوج الاحتياطي الثابت kilocode/kilo/auto؛ ويمكن لاكتشاف https://api.kilo.ai/api/gateway/models المباشر توسيع كتالوج وقت التشغيل أكثر.
• التوجيه الدقيق في المنبع خلف kilocode/kilo/auto مملوك لـKilo Gateway، وليس مضمّنًا بشكل ثابت في OpenClaw.

راجع /providers/kilocode للحصول على تفاصيل الإعداد.

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

خصوصيات يجدر معرفتها

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

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

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

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

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

Moonshot AI (Kimi)

يُشحَن Moonshot بصفته plugin مزوّدًا مضمّنًا. استخدم المزوّد المدمج افتراضيًا، وأضف إدخال 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.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 نقطة النهاية المتوافقة مع Anthropic الخاصة بـ Moonshot AI:

• المزوّد: 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-M2.7
• توليد الصور هو minimax/image-01 أو minimax-portal/image-01
• فهم الصور مملوك من Plugin باسم MiniMax-VL-01 على مساري مصادقة 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 JIT و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

راجع أيضاً: التكوين للاطلاع على أمثلة التكوين الكاملة.

ذو صلة

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