Model sağlayıcıları

LLM/model sağlayıcıları için başvuru (WhatsApp/Telegram gibi sohbet kanalları değil). Model seçimi kuralları için bkz. Modeller.

Hızlı kurallar

Plugin’e ait sağlayıcı davranışı

Sağlayıcıya özgü mantığın çoğu sağlayıcı Plugin’lerinde (registerProvider(...)) yaşarken OpenClaw genel çıkarım döngüsünü tutar. Plugin’ler başlangıç kurulumunu, model kataloglarını, kimlik doğrulama ortam değişkeni eşlemesini, taşıma/yapılandırma normalleştirmesini, araç şeması temizliğini, yük devri sınıflandırmasını, OAuth yenilemeyi, kullanım raporlamasını, düşünme/akıl yürütme profillerini ve daha fazlasını sahiplenir.

Sağlayıcı SDK kancalarının ve paketlenmiş Plugin örneklerinin tam listesi Sağlayıcı Plugin’leri bölümündedir. Tamamen özel bir istek yürütücüsüne ihtiyaç duyan bir sağlayıcı ayrı ve daha derin bir genişletme yüzeyidir.

API anahtarı döndürme

Resmi sağlayıcı Plugin’leri

Resmi sağlayıcı Plugin’leri kendi model katalog satırlarını yayımlar. Bu sağlayıcılar hiçbir models.providers model girdisi gerektirmez; sağlayıcı Plugin’ini etkinleştirin, kimlik doğrulamayı ayarlayın ve bir model seçin. models.providers yalnızca açık özel sağlayıcılar veya zaman aşımı gibi dar istek ayarları için kullanın.

OpenAI

• Sağlayıcı: openai
• Kimlik doğrulama: OPENAI_API_KEY
• İsteğe bağlı döndürme: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, ayrıca OPENCLAW_LIVE_OPENAI_KEY (tek geçersiz kılma)
• Örnek modeller: openai/gpt-5.5, openai/gpt-5.4-mini
• Belirli bir kurulum veya API anahtarı farklı davranıyorsa hesap/model kullanılabilirliğini openclaw models list --provider openai ile doğrulayın.
• CLI: openclaw onboard --auth-choice openai-api-key
• Varsayılan taşıma auto değeridir; OpenClaw taşıma seçimini paylaşılan model runtime’ına geçirir.
• Model bazında agents.defaults.models["openai/<model>"].params.transport ile geçersiz kılın ("sse", "websocket" veya "auto")
• OpenAI öncelikli işleme agents.defaults.models["openai/<model>"].params.serviceTier ile etkinleştirilebilir
• /fast ve params.fastMode, doğrudan openai/* Responses isteklerini api.openai.com üzerinde service_tier=priority değerine eşler
• Paylaşılan /fast anahtarı yerine açık bir katman istediğinizde params.serviceTier kullanın
• Gizli OpenClaw atıf başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lere değil, yalnızca api.openai.com adresine giden yerel OpenAI trafiğine uygulanır
• Yerel OpenAI rotaları ayrıca Responses store, istem önbelleği ipuçları ve OpenAI akıl yürütme uyumluluğu yük biçimlendirmesini korur; proxy rotaları bunu yapmaz
• openai/gpt-5.3-codex-spark, oturum açmış hesabınız bunu sunduğunda ChatGPT/Codex OAuth abonelik kimlik doğrulaması üzerinden kullanılabilir; OpenClaw bu model için doğrudan OpenAI API anahtarı ve Azure API anahtarı rotalarını hâlâ bastırır çünkü bu taşımalar modeli reddeder

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

Anthropic

• Sağlayıcı: anthropic
• Kimlik doğrulama: ANTHROPIC_API_KEY
• İsteğe bağlı döndürme: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, ayrıca OPENCLAW_LIVE_ANTHROPIC_KEY (tek geçersiz kılma)
• Örnek model: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Doğrudan genel Anthropic istekleri, api.anthropic.com adresine gönderilen API anahtarlı ve OAuth kimlik doğrulamalı trafik dahil olmak üzere paylaşılan /fast anahtarını ve params.fastMode değerini destekler; OpenClaw bunu Anthropic service_tier değerine (auto ve standard_only) eşler
• Tercih edilen Claude CLI yapılandırması model başvurusunu kanonik tutar ve CLI arka ucunu ayrıca seçer: model kapsamlı agentRuntime.id: "claude-cli" ile anthropic/claude-opus-4-8. Eski claude-cli/claude-opus-4-7 başvuruları uyumluluk için hâlâ çalışır.

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

OpenAI ChatGPT/Codex OAuth

• Sağlayıcı: openai
• Kimlik doğrulama: OAuth (ChatGPT)
• Eski OpenAI Codex model başvurusu: openai/gpt-5.5
• Yerel Codex uygulama sunucusu koşumu başvurusu: openai/gpt-5.5
• Yerel Codex uygulama sunucusu koşumu belgeleri: Codex koşumu
• Eski model başvuruları: codex/gpt-*
• Plugin sınırı: openai/*, OpenAI Plugin’ini yükler; yerel Codex uygulama sunucusu Plugin’i Codex koşumu runtime’ı tarafından seçilir.
• CLI: openclaw onboard --auth-choice openai veya openclaw models auth login --provider openai
• Varsayılan taşıma auto değeridir (önce WebSocket, SSE yedeği)
• OpenAI Codex modeli bazında agents.defaults.models["openai/<model>"].params.transport ile geçersiz kılın ("sse", "websocket" veya "auto")
• params.serviceTier ayrıca yerel Codex Responses isteklerinde (chatgpt.com/backend-api) iletilir
• Gizli OpenClaw atıf başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lere değil, yalnızca chatgpt.com/backend-api adresine giden yerel Codex trafiğine eklenir
• Doğrudan openai/* ile aynı /fast anahtarını ve params.fastMode yapılandırmasını paylaşır; OpenClaw bunu service_tier=priority değerine eşler
• openai/gpt-5.5, Codex kataloğunun yerel contextWindow = 400000 değerini ve varsayılan runtime contextTokens = 272000 değerini kullanır; runtime sınırını models.providers.openai.models[].contextTokens ile geçersiz kılın
• İlke notu: OpenAI Codex OAuth, OpenClaw gibi harici araçlar/iş akışları için açıkça desteklenir.
• Yaygın abonelik ve yerel Codex runtime rotası için openai kimlik doğrulamasıyla oturum açın ve openai/gpt-5.5 yapılandırın; OpenAI ajan dönüşleri varsayılan olarak Codex’i seçer.
• Yerleşik OpenClaw rotasını yalnızca istediğinizde sağlayıcı/model agentRuntime.id: "openclaw" kullanın; aksi halde openai/gpt-5.5 değerini varsayılan Codex koşumunda tutun.
• Eski Codex GPT başvuruları canlı bir sağlayıcı rotası değil, eski durumdur. Yeni ajan yapılandırması için yerel Codex runtime’ında openai/gpt-5.5 kullanın ve eski Codex model başvurularını kanonik openai/* başvurularına taşımak için openclaw doctor --fix çalıştırın.

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

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

Diğer abonelik tarzı barındırılan seçenekler

OpenCode

• Kimlik doğrulama: OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY)
• Zen runtime sağlayıcısı: opencode
• Go runtime sağlayıcısı: opencode-go
• Örnek modeller: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen veya openclaw onboard --auth-choice opencode-go

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

Google Gemini (API anahtarı)

• Sağlayıcı: google
• Kimlik doğrulama: GEMINI_API_KEY
• İsteğe bağlı döndürme: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY yedeği ve OPENCLAW_LIVE_GEMINI_KEY (tekil geçersiz kılma)
• Örnek modeller: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Uyumluluk: google/gemini-3.1-flash-preview kullanan eski OpenClaw yapılandırması google/gemini-3-flash-preview olarak normalleştirilir
• Takma ad: google/gemini-3.1-pro kabul edilir ve Google'ın canlı Gemini API kimliğine, google/gemini-3.1-pro-preview değerine normalleştirilir
• CLI: openclaw onboard --auth-choice gemini-api-key
• Düşünme: /think adaptive, Google dinamik düşünmeyi kullanır. Gemini 3/3.1 sabit bir thinkingLevel atlar; Gemini 2.5 thinkingBudget: -1 gönderir.
• Doğrudan Gemini çalıştırmaları, sağlayıcıya özgü bir cachedContents/... tutamacını iletmek için agents.defaults.models["google/<model>"].params.cachedContent (veya eski cached_content) değerini de kabul eder; Gemini önbellek isabetleri OpenClaw cacheRead olarak görünür

Google Vertex ve Gemini CLI

• Sağlayıcılar: google-vertex, google-gemini-cli
• Kimlik doğrulama: Vertex, gcloud ADC kullanır; Gemini CLI kendi OAuth akışını kullanır

Gemini CLI OAuth, paketle birlikte gelen google plugin parçası olarak sunulur.

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 varsayılan olarak stream-json kullanır. OpenClaw, asistan akış iletilerini okur ve stats.cached değerini cacheRead olarak normalleştirir; eski --output-format json geçersiz kılmaları yanıt metnini yine response değerinden okur.

Z.AI (GLM)

• Sağlayıcı: zai
• Kimlik doğrulama: ZAI_API_KEY
• Örnek model: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Model referansları kanonik zai/* sağlayıcı kimliğini kullanır.
  • zai-api-key eşleşen Z.AI uç noktasını otomatik algılar; zai-coding-global, zai-coding-cn, zai-global ve zai-cn belirli bir yüzeyi zorunlu kılar

Vercel AI Gateway

• Sağlayıcı: vercel-ai-gateway
• Kimlik doğrulama: AI_GATEWAY_API_KEY
• Örnek modeller: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Diğer paketli sağlayıcı plugin'leri

Bilinmeye değer tuhaflıklar

models.providers üzerinden sağlayıcılar (özel/temel URL)

Özel sağlayıcılar veya OpenAI/Anthropic uyumlu proxy'ler eklemek için models.providers (veya models.json) kullanın.

Aşağıdaki paketle birlikte gelen sağlayıcı Plugin'lerin çoğu zaten varsayılan bir katalog yayımlar. Açık models.providers.<id> girdilerini yalnızca varsayılan temel URL'yi, üstbilgileri veya model listesini geçersiz kılmak istediğinizde kullanın.

Gateway model yetenek denetimleri açık models.providers.<id>.models[] meta verilerini de okur. Özel veya proxy bir model görüntüleri kabul ediyorsa, WebChat ve Node kaynaklı ek yollarının görüntüleri yalnızca metin medya referansları yerine yerel model girdileri olarak iletmesi için o modelde input: ["text", "image"] ayarlayın.

agents.defaults.models["provider/model"] yalnızca ajanlar için model görünürlüğünü, takma adları ve model başına meta verileri denetler. Tek başına yeni bir çalışma zamanı modelini kaydetmez. Özel sağlayıcı modelleri için, en azından eşleşen id ile birlikte models.providers.<provider>.models[] de ekleyin.

Moonshot AI (Kimi)

Onboarding öncesinde @openclaw/moonshot-provider yükleyin. Açık bir models.providers.moonshot girdisini yalnızca temel URL'yi veya model meta verilerini geçersiz kılmanız gerektiğinde ekleyin:

• Sağlayıcı: moonshot
• Kimlik doğrulama: MOONSHOT_API_KEY
• Örnek model: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key veya openclaw onboard --auth-choice moonshot-api-key-cn

Kimi K2 model kimlikleri:

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

Kimi Coding, Moonshot AI'ın Anthropic uyumlu uç noktasını kullanır:

• Sağlayıcı: kimi
• Kimlik doğrulama: KIMI_API_KEY
• Örnek model: kimi/kimi-for-coding

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

Eski kimi/kimi-code ve kimi/k2p5, uyumluluk model kimlikleri olarak kabul edilmeye devam eder ve Kimi'nin kararlı API model kimliğine normalleştirilir.

Volcano Engine (Doubao)

Volcano Engine (火山引擎), Çin'deki Doubao ve diğer modellere erişim sağlar.

• Sağlayıcı: volcengine (kodlama: volcengine-plan)
• Kimlik doğrulama: VOLCANO_ENGINE_API_KEY
• Örnek model: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

Onboarding varsayılan olarak kodlama yüzeyini kullanır, ancak genel volcengine/* kataloğu aynı anda kaydedilir.

Onboarding/configure model seçicilerinde, Volcengine kimlik doğrulama seçimi hem volcengine/* hem de volcengine-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmediyse OpenClaw, boş bir sağlayıcı kapsamlı seçici göstermek yerine filtresiz kataloğa geri döner.

BytePlus (Uluslararası)

BytePlus ARK, uluslararası kullanıcılar için Volcano Engine ile aynı modellere erişim sağlar.

• Sağlayıcı: byteplus (kodlama: byteplus-plan)
• Kimlik doğrulama: BYTEPLUS_API_KEY
• Örnek model: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

Onboarding varsayılan olarak kodlama yüzeyini kullanır, ancak genel byteplus/* kataloğu aynı anda kaydedilir.

Onboarding/configure model seçicilerinde, BytePlus kimlik doğrulama seçimi hem byteplus/* hem de byteplus-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmediyse OpenClaw, boş bir sağlayıcı kapsamlı seçici göstermek yerine filtresiz kataloğa geri döner.

Synthetic

Synthetic, synthetic sağlayıcısının arkasında Anthropic uyumlu modeller sağlar:

• Sağlayıcı: synthetic
• Kimlik doğrulama: SYNTHETIC_API_KEY
• Örnek model: 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 özel endpoint’ler kullandığı için models.providers üzerinden yapılandırılır:

• MiniMax OAuth (Küresel): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax API anahtarı (Küresel): --auth-choice minimax-global-api
• MiniMax API anahtarı (CN): --auth-choice minimax-cn-api
• Kimlik doğrulama: minimax için MINIMAX_API_KEY; minimax-portal için MINIMAX_OAUTH_TOKEN veya MINIMAX_API_KEY

Kurulum ayrıntıları, model seçenekleri ve yapılandırma parçacıkları için /providers/minimax sayfasına bakın.

Plugin sahipli yetenek ayrımı:

• Metin/sohbet varsayılanları minimax/MiniMax-M3 üzerinde kalır
• Görsel oluşturma minimax/image-01 veya minimax-portal/image-01 değeridir
• Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin sahipli MiniMax-VL-01 değeridir
• Web araması sağlayıcı kimliği minimax üzerinde kalır

LM Studio

LM Studio, yerel API’yi kullanan paketli bir sağlayıcı Plugin olarak gelir:

• Sağlayıcı: lmstudio
• Kimlik doğrulama: LM_API_TOKEN
• Varsayılan çıkarım temel URL’si: http://localhost:1234/v1

Ardından bir model ayarlayın (http://localhost:1234/api/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

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

OpenClaw, keşif + otomatik yükleme için LM Studio’nun yerel /api/v1/models ve /api/v1/models/load yollarını, varsayılan olarak çıkarım için /v1/chat/completions yolunu kullanır. LM Studio JIT yükleme, TTL ve otomatik çıkarma işlemlerinin model yaşam döngüsüne sahip olmasını istiyorsanız models.providers.lmstudio.params.preload: false ayarlayın. Kurulum ve sorun giderme için /providers/lmstudio sayfasına bakın.

Ollama

Ollama, paketli bir sağlayıcı Plugin olarak gelir ve Ollama’nın yerel API’sini kullanır:

• Sağlayıcı: ollama
• Kimlik doğrulama: Gerekli değil (yerel sunucu)
• Örnek model: ollama/llama3.3
• Kurulum: https://ollama.com/download

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

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

OLLAMA_API_KEY ile katılmayı seçtiğinizde Ollama yerel olarak http://127.0.0.1:11434 adresinde algılanır ve paketli sağlayıcı Plugin, Ollama’yı doğrudan openclaw onboard içine ve model seçiciye ekler. Onboarding, bulut/yerel mod ve özel yapılandırma için /providers/ollama sayfasına bakın.

vLLM

vLLM, yerel/kendi barındırdığınız OpenAI uyumlu sunucular için paketli bir sağlayıcı Plugin olarak gelir:

• Sağlayıcı: vllm
• Kimlik doğrulama: İsteğe bağlı (sunucunuza bağlıdır)
• Varsayılan temel URL: http://127.0.0.1:8000/v1

Yerel otomatik keşfe katılmak için (sunucunuz kimlik doğrulamayı zorunlu tutmuyorsa herhangi bir değer çalışır):

export VLLM_API_KEY="vllm-local"

Ardından bir model ayarlayın (/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

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

Ayrıntılar için /providers/vllm sayfasına bakın.

SGLang

SGLang, hızlı ve kendi barındırdığınız OpenAI uyumlu sunucular için paketli bir sağlayıcı Plugin olarak gelir:

• Sağlayıcı: sglang
• Kimlik doğrulama: İsteğe bağlı (sunucunuza bağlıdır)
• Varsayılan temel URL: http://127.0.0.1:30000/v1

Yerel otomatik keşfe katılmak için (sunucunuz kimlik doğrulamayı zorunlu tutmuyorsa herhangi bir değer çalışır):

export SGLANG_API_KEY="sglang-local"

Ardından bir model ayarlayın (/v1/models tarafından döndürülen kimliklerden biriyle değiştirin):

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

Ayrıntılar için /providers/sglang sayfasına bakın.

Yerel proxy’ler (LM Studio, vLLM, LiteLLM vb.)

Örnek (OpenAI uyumlu):

{  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 örnekleri

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

Tam yapılandırma örnekleri için ayrıca bkz.: Yapılandırma.

İlgili

• Yapılandırma başvurusu - model yapılandırma anahtarları
• Model failover - fallback zincirleri ve yeniden deneme davranışı
• Modeller - model yapılandırması ve takma adlar
• Sağlayıcılar - sağlayıcı başına kurulum kılavuzları