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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

قواعد سريعة

​

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

​

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

​

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

​

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 الخاص به

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

​

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.

​

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

​

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

​

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

​

Moonshot AI (Kimi)

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

• 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
• المصادقة: KIMI_API_KEY
• نموذج مثال: kimi/kimi-for-coding

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

​

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" } },
  },
}

​

BytePlus (دولي)

• المزوّد: 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" } },
  },
}

​

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 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

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

​

LM Studio

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

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

​

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" } },
  },
}

​

vLLM

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

export VLLM_API_KEY="vllm-local"

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

​

SGLang

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

export SGLANG_API_KEY="sglang-local"

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

​

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

{
  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

​

ذو صلة

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