مزودو النماذج

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

# قواعد سريعة

# سلوك الموفّر المملوك لـ Plugin

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

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

# تدوير مفاتيح 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 (WebSocket أولاً، مع الرجوع إلى SSE)
• تجاوز لكل نموذج عبر agents.defaults.models["openai/<model>"].params.transport ("sse" أو "websocket" أو "auto")
• يكون الإحماء لـ OpenAI Responses WebSocket مفعّلاً افتراضياً عبر params.openaiWsWarmup (true/false)
• يمكن تفعيل المعالجة ذات الأولوية في 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 الأصلية أيضاً على store في Responses، وتلميحات ذاكرة التخزين المؤقت للمطالبات، وتشكيل الحمولة المتوافق مع استدلال OpenAI؛ ولا تفعل مسارات الوكيل ذلك
• يُخفى openai/gpt-5.3-codex-spark عمداً في OpenClaw لأن طلبات OpenAI API المباشرة ترفضه ولا يعرضه كتالوج 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 مع agents.defaults.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 مع agents.defaults.agentRuntime.id: "codex"
• مستندات حزمة تشغيل خادم تطبيق Codex الأصلية: حزمة Codex
• مراجع النماذج القديمة: codex/gpt-*
• حد Plugin: يحمّل openai-codex/* OpenAI plugin؛ ولا تُختار Plugin خادم تطبيق Codex الأصلية إلا عبر Runtime حزمة 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 أيضاً في طلبات Codex Responses الأصلية (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 وRuntime الافتراضي contextTokens = 272000؛ وتجاوز حد Runtime عبر models.providers.openai-codex.models[].contextTokens
• ملاحظة سياسة: يُدعم OpenAI Codex OAuth صراحة للأدوات/سير العمل الخارجية مثل OpenClaw.
• للمسار الشائع الذي يجمع الاشتراك مع Runtime Codex الأصلي، سجّل الدخول بمصادقة openai-codex لكن اضبط openai/gpt-5.5 مع agents.defaults.agentRuntime.id: "codex".
• استخدم openai-codex/gpt-5.5 فقط عندما تريد مسار Codex OAuth/الاشتراك عبر PI؛ واستخدم openai/gpt-5.5 من دون تجاوز Runtime الخاص بـ Codex عندما يتيح إعداد مفتاح API لديك والكتالوج المحلي مسار API العام.
• تُخفى مراجع openai-codex/gpt-5.1* وopenai-codex/gpt-5.2* وopenai-codex/gpt-5.3* الأقدم لأن حسابات ChatGPT/Codex OAuth ترفضها؛ استخدم openai-codex/gpt-5.5 أو مسار Runtime الخاص بـ Codex الأصلي بدلاً من ذلك.

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

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

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

# OpenCode

• المصادقة: OPENCODE_API_KEY (أو OPENCODE_ZEN_API_KEY)
• موفّر Zen runtime: opencode
• موفّر Go runtime: 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 بيانات اعتماد ADC من gcloud؛ ويستخدم 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 ومسارات المرفقات القادمة من Node الصور كمدخلات نموذج أصلية بدلا من مراجع وسائط نصية فقط.

# 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 نقطة نهاية Moonshot AI المتوافقة مع Anthropic:

• الموفر: kimi
• المصادقة: KIMI_API_KEY
• نموذج مثال: kimi/kimi-code

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

يبقى kimi/k2p5 القديم مقبولاً كمعرّف نموذج للتوافق.

# 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 للاستدلال افتراضياً. إذا أردت أن يتولى تحميل JIT في 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-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

راجع أيضاً: الإعدادات لأمثلة الإعدادات الكاملة.

# ذات صلة

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