Model sağlayıcıları

LLM/model sağlayıcıları için referans (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ü korur. Plugin’ler onboarding, model katalogları, auth env-var eşlemesi, taşıma/yapılandırma normalleştirmesi, araç şeması temizliği, failover sınıflandırması, OAuth yenileme, kullanım raporlama, düşünme/akıl yürütme profilleri ve daha fazlasından sorumludur.

Provider-SDK hook’larının ve paketle gelen Plugin örneklerinin tam listesi Provider plugins 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 uzantı yüzeyidir.

API anahtarı rotasyonu

Yerleşik sağlayıcılar (pi-ai kataloğu)

OpenClaw, pi-ai kataloğuyla birlikte gelir. Bu sağlayıcılar hiçbir models.providers yapılandırması gerektirmez; yalnızca auth ayarlayın ve bir model seçin.

OpenAI

• Sağlayıcı: openai
• Auth: OPENAI_API_KEY
• İsteğe bağlı rotasyon: 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 pi-ai’ye iletir.
• Model başına agents.defaults.models["openai/<model>"].params.transport üzerinden geçersiz kılın ("sse", "websocket" veya "auto")
• OpenAI öncelikli işleme agents.defaults.models["openai/<model>"].params.serviceTier üzerinden 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 açma kapaması 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’lerde değil, yalnızca api.openai.com adresine giden yerel OpenAI trafiğinde uygulanır
• Yerel OpenAI rotaları ayrıca Responses store, prompt-cache ipuçları ve OpenAI reasoning-compat yük şekillendirmesini korur; proxy rotaları bunu yapmaz
• openai/gpt-5.3-codex-spark, canlı OpenAI API istekleri bunu reddettiği ve geçerli Codex kataloğu bunu sunmadığı için OpenClaw içinde bilinçli olarak bastırılır

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

Anthropic

• Sağlayıcı: anthropic
• Auth: ANTHROPIC_API_KEY
• İsteğe bağlı rotasyon: 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 anahtarı ve OAuth ile kimliği doğrulanmış trafik dahil olmak üzere paylaşılan /fast açma kapaması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 referansını kanonik tutar ve CLI backend’ini ayrı seçer: model kapsamlı agentRuntime.id: "claude-cli" ile anthropic/claude-opus-4-7. Eski claude-cli/claude-opus-4-7 referansları uyumluluk için çalışmaya devam eder.

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

OpenAI Codex OAuth

• Sağlayıcı: openai-codex
• Auth: OAuth (ChatGPT)
• Eski PI model referansı: openai-codex/gpt-5.5
• Yerel Codex uygulama sunucusu harness referansı: openai/gpt-5.5
• Yerel Codex uygulama sunucusu harness belgeleri: Codex harness
• Eski model referansları: codex/gpt-*
• Plugin sınırı: openai-codex/* OpenAI Plugin’ini yükler; yerel Codex uygulama sunucusu Plugin’i yalnızca Codex harness çalışma zamanı veya eski codex/* referansları tarafından seçilir.
• CLI: openclaw onboard --auth-choice openai-codex veya openclaw models auth login --provider openai-codex
• Varsayılan taşıma auto değeridir (önce WebSocket, SSE yedeği)
• PI modeli başına agents.defaults.models["openai-codex/<model>"].params.transport üzerinden geçersiz kılın ("sse", "websocket" veya "auto")
• params.serviceTier yerel Codex Responses isteklerinde de iletilir (chatgpt.com/backend-api)
• Gizli OpenClaw atıf başlıkları (originator, version, User-Agent) genel OpenAI uyumlu proxy’lerde değil, yalnızca chatgpt.com/backend-api adresine giden yerel Codex trafiğine eklenir
• Doğrudan openai/* ile aynı /fast açma kapamasını ve params.fastMode yapılandırmasını paylaşır; OpenClaw bunu service_tier=priority değerine eşler
• openai-codex/gpt-5.5, Codex kataloğu yerel contextWindow = 400000 değerini ve varsayılan çalışma zamanı contextTokens = 272000 değerini kullanır; çalışma zamanı sınırını models.providers.openai-codex.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 artı yerel Codex çalışma zamanı rotası için openai-codex auth ile oturum açın ancak openai/gpt-5.5 yapılandırın; OpenAI agent dönüşleri varsayılan olarak Codex’i seçer.
• PI üzerinden uyumluluk rotası istediğinizde yalnızca sağlayıcı/model agentRuntime.id: "pi" kullanın; aksi halde openai/gpt-5.5 değerini varsayılan Codex harness üzerinde tutun.
• Eski openai-codex/gpt-5.1*, openai-codex/gpt-5.2* ve openai-codex/gpt-5.3* referansları, ChatGPT/Codex OAuth hesapları bunları reddettiği için bastırılır; bunun yerine openai-codex/gpt-5.5 veya yerel Codex çalışma zamanı rotasını kullanın.

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

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

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

OpenCode

• Auth: OPENCODE_API_KEY (veya OPENCODE_ZEN_API_KEY)
• Zen çalışma zamanı sağlayıcısı: opencode
• Go çalışma zamanı 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ı rotasyon: 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 değerini atlar; Gemini 2.5 thinkingBudget: -1 gönderir.
• Doğrudan Gemini çalıştırmaları ayrıca sağlayıcıya özgü bir cachedContents/... tanıtıcısını iletmek için agents.defaults.models["google/<model>"].params.cachedContent (veya eski cached_content) değerini 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 gelen google Plugin'inin parçası olarak gönderilir.

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 JSON yanıtları response içinden ayrıştırılır; kullanım stats değerine geri döner ve stats.cached OpenClaw cacheRead olarak normalleştirilir.

Z.AI (GLM)

• Sağlayıcı: zai
• Kimlik doğrulama: ZAI_API_KEY
• Örnek model: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • Takma adlar: z.ai/* ve z-ai/*, zai/* olarak normalleştirilir
  • 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

Kilo Gateway

• Sağlayıcı: kilocode
• Kimlik doğrulama: KILOCODE_API_KEY
• Örnek model: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• Temel URL: https://api.kilo.ai/api/gateway/
• Statik yedek katalog kilocode/kilo/auto ile gönderilir; canlı https://api.kilo.ai/api/gateway/models keşfi çalışma zamanı kataloğunu daha da genişletebilir.
• kilocode/kilo/auto arkasındaki kesin üst kaynak yönlendirmesi OpenClaw içinde sabit kodlanmış değildir; Kilo Gateway'e aittir.

Kurulum ayrıntıları için bkz. /providers/kilocode.

Paketle gelen diğer sağlayıcı Plugin'leri

Bilinmesi gereken özel durumlar

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 gelen sağlayıcı plugin'lerinin birçoğu zaten varsayılan bir katalog yayımlar. Yalnızca varsayılan temel URL'yi, başlıkları veya model listesini geçersiz kılmak istediğinizde açık models.providers.<id> girdileri kullanın.

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

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

Moonshot AI (Kimi)

Moonshot, paketle gelen bir sağlayıcı plugin'i olarak gelir. Varsayılan olarak yerleşik sağlayıcıyı kullanın ve yalnızca temel URL'yi veya model meta verilerini geçersiz kılmanız gerektiğinde açık bir models.providers.moonshot girdisi 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.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 coding

Kimi Coding, Moonshot AI'nin 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'de 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" } },  },}

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

İlk kurulum/yapılandırma 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üklenmemişse 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" } },  },}

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

İlk kurulum/yapılandırma 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üklenmemişse 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 uç noktalar kullandığı için models.providers üzerinden yapılandırılır:

• MiniMax OAuth (Küresel): --auth-choice minimax-global-oauth
• MiniMax OAuth (Çin): --auth-choice minimax-cn-oauth
• MiniMax API anahtarı (Küresel): --auth-choice minimax-global-api
• MiniMax API anahtarı (Çin): --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-M2.7 ü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 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 paketlenmiş 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üklemesi, TTL ve otomatik çıkarma işlemlerinin model yaşam döngüsünü sahiplenmesini istiyorsanız models.providers.lmstudio.params.preload: false ayarlayın. Kurulum ve sorun giderme için /providers/lmstudio sayfasına bakın.

Ollama

Ollama, paketlenmiş 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, OLLAMA_API_KEY ile etkinleştirdiğinizde yerel olarak http://127.0.0.1:11434 adresinde algılanır ve paketlenmiş sağlayıcı Plugin, Ollama'yı doğrudan openclaw onboard ve model seçiciye ekler. İlk kurulum, bulut/yerel mod ve özel yapılandırma için /providers/ollama sayfasına bakın.

vLLM

vLLM, yerel/kendi barındırılan OpenAI uyumlu sunucular için paketlenmiş 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şfi etkinleştirmek için (sunucunuz kimlik doğrulaması zorunlu kılmıyorsa 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ı kendi barındırılan OpenAI uyumlu sunucular için paketlenmiş 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şfi etkinleştirmek için (sunucunuz kimlik doğrulaması zorunlu kılmıyorsa 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 bakın: Yapılandırma.

İlgili

• Yapılandırma referansı - model yapılandırma anahtarları
• Model yük devri - yedek zincirleri ve yeniden deneme davranışı
• Modeller - model yapılandırması ve takma adlar
• Sağlayıcılar - sağlayıcı bazında kurulum kılavuzları