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

Model refs and CLI helpers

Model referansları provider/model kullanır (örnek: opencode/claude-opus-4-6).
agents.defaults.models ayarlandığında izin listesi olarak davranır.
CLI yardımcıları: openclaw onboard, openclaw models list, openclaw models set <provider/model>.
models.providers.*.contextWindow / contextTokens / maxTokens sağlayıcı düzeyi varsayılanları ayarlar; models.providers.*.models[].contextWindow / contextTokens / maxTokens bunları model başına geçersiz kılar.
Yedekleme kuralları, cooldown yoklamaları ve oturum geçersiz kılma kalıcılığı: Model failover.

Adding provider auth does not change your primary model

Bir sağlayıcı eklediğinizde veya yeniden yetkilendirdiğinizde openclaw configure mevcut bir agents.defaults.model.primary değerini korur. openclaw models auth login, --set-default iletmediğiniz sürece aynısını yapar. Sağlayıcı Plugin’leri auth yapılandırma yamasında yine de önerilen bir varsayılan model döndürebilir, ancak OpenClaw bunu birincil model zaten varsa “geçerli birincil modeli değiştir” olarak değil, “bu modeli kullanılabilir yap” olarak ele alır.Varsayılan modeli bilinçli olarak değiştirmek için openclaw models set <provider/model> veya openclaw models auth login --provider <id> --set-default kullanın.

OpenAI provider/runtime split

OpenAI ailesi rotaları öneke özeldir:

openai/<model> agent dönüşleri için varsayılan olarak yerel Codex uygulama sunucusu harness’ını kullanır. Bu, olağan ChatGPT/Codex abonelik kurulumudur.
openai-codex/<model>, doctor’ın openai/<model> olarak yeniden yazdığı eski yapılandırmadır.
openai/<model> ve sağlayıcı/model agentRuntime.id: "pi" açık API anahtarı veya uyumluluk rotaları için PI kullanır.

Bkz. OpenAI ve Codex harness. Sağlayıcı/çalışma zamanı ayrımı kafa karıştırıyorsa önce Agent çalışma zamanları bölümünü okuyun.Plugin otomatik etkinleştirme aynı sınırı izler: openai/* agent referansları varsayılan rota için Codex Plugin’ini etkinleştirir ve açık sağlayıcı/model agentRuntime.id: "codex" veya eski codex/<model> referansları da bunu gerektirir.GPT-5.5, varsayılan olarak openai/gpt-5.5 üzerinde yerel Codex uygulama sunucusu harness’ı üzerinden ve yalnızca sağlayıcı/model çalışma zamanı ilkesi açıkça pi seçtiğinde PI üzerinden kullanılabilir.

CLI runtimes

CLI çalışma zamanları aynı ayrımı kullanır: anthropic/claude-*, google/gemini-* veya openai/gpt-* gibi kanonik model referansları seçin, ardından yerel CLI backend istediğinizde sağlayıcı/model çalışma zamanı ilkesini claude-cli, google-gemini-cli veya codex-cli olarak ayarlayın.Eski claude-cli/*, google-gemini-cli/* ve codex-cli/* referansları, çalışma zamanı ayrı kaydedilerek kanonik sağlayıcı referanslarına geri taşınır.

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.

Sağlayıcıya ait runner davranışı replay ilkesi, araç şeması normalleştirmesi, akış sarmalama ve taşıma/istek yardımcıları gibi açık sağlayıcı hook’larında yaşar. Eski ProviderPlugin.capabilities statik çantası yalnızca uyumluluk içindir ve paylaşılan runner mantığı tarafından artık okunmaz.

API anahtarı rotasyonu

Key sources and priority

Birden fazla anahtarı şunlarla yapılandırın:

OPENCLAW_LIVE_<PROVIDER>_KEY (tek canlı geçersiz kılma, en yüksek öncelik)
<PROVIDER>_API_KEYS (virgül veya noktalı virgül listesi)
<PROVIDER>_API_KEY (birincil anahtar)
<PROVIDER>_API_KEY_* (numaralı liste, örn. <PROVIDER>_API_KEY_1)

Google sağlayıcıları için GOOGLE_API_KEY de yedek olarak dahil edilir. Anahtar seçimi sırası önceliği korur ve değerleri tekilleştirir.

When rotation kicks in

İstekler yalnızca rate-limit yanıtlarında sonraki anahtarla yeniden denenir (örneğin 429, rate_limit, quota, resource exhausted, Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded veya periyodik kullanım sınırı mesajları).
Rate-limit olmayan hatalar hemen başarısız olur; anahtar rotasyonu denenmez.
Tüm aday anahtarlar başarısız olduğunda, son hata son denemeden döndürülür.

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.

Anthropic çalışanları bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu nedenle OpenClaw, Anthropic yeni bir ilke yayımlamadığı sürece Claude CLI yeniden kullanımını ve claude -p kullanımını bu entegrasyon için onaylı kabul eder. Anthropic setup-token desteklenen bir OpenClaw token yolu olarak kullanılmaya devam eder, ancak OpenClaw artık mevcut olduğunda Claude CLI yeniden kullanımını ve claude -p kullanımını tercih 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

GLM models

Z.AI Coding Plan veya genel API uç noktaları.

MiniMax

MiniMax Coding Plan OAuth veya API anahtarı erişimi.

Qwen Cloud

Qwen Cloud sağlayıcı yüzeyi, ayrıca Alibaba DashScope ve Coding Plan uç noktası eşlemesi.

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

OpenClaw içindeki Gemini CLI OAuth resmi olmayan bir entegrasyondur. Bazı kullanıcılar, üçüncü taraf istemcileri kullandıktan sonra Google hesabı kısıtlamaları bildirmiştir. Devam etmeyi seçerseniz Google şartlarını inceleyin ve kritik olmayan bir hesap kullanın.

Gemini CLI OAuth, paketle gelen google Plugin’inin parçası olarak gönderilir.

Gemini CLI'yi yükleyin

brew
npm

brew install gemini-cli

npm install -g @google/gemini-cli

Plugin'i etkinleştirin

openclaw plugins enable google

Oturum açın

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

Varsayılan model: google-gemini-cli/gemini-3-flash-preview. openclaw.json içine bir istemci kimliği veya gizli anahtar yapıştırmazsınız. CLI oturum açma akışı, tokenları Gateway ana makinesindeki kimlik doğrulama profillerinde saklar.

Projeyi ayarlayın (gerekirse)

Oturum açtıktan sonra istekler başarısız olursa Gateway ana makinesinde GOOGLE_CLOUD_PROJECT veya GOOGLE_CLOUD_PROJECT_ID değerini ayarlayın.

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

Sağlayıcı	Kimlik	Kimlik doğrulama env	Örnek model
BytePlus	`byteplus` / `byteplus-plan`	`BYTEPLUS_API_KEY`	`byteplus-plan/ark-code-latest`
Cerebras	`cerebras`	`CEREBRAS_API_KEY`	`cerebras/zai-glm-4.7`
Cloudflare AI Gateway	`cloudflare-ai-gateway`	`CLOUDFLARE_AI_GATEWAY_API_KEY`	-
DeepInfra	`deepinfra`	`DEEPINFRA_API_KEY`	`deepinfra/deepseek-ai/DeepSeek-V3.2`
DeepSeek	`deepseek`	`DEEPSEEK_API_KEY`	`deepseek/deepseek-v4-flash`
GitHub Copilot	`github-copilot`	`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	-
Groq	`groq`	`GROQ_API_KEY`	-
Hugging Face Inference	`huggingface`	`HUGGINGFACE_HUB_TOKEN` veya `HF_TOKEN`	`huggingface/deepseek-ai/DeepSeek-R1`
Kilo Gateway	`kilocode`	`KILOCODE_API_KEY`	`kilocode/kilo/auto`
Kimi Coding	`kimi`	`KIMI_API_KEY` veya `KIMICODE_API_KEY`	`kimi/kimi-for-coding`
MiniMax	`minimax` / `minimax-portal`	`MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN`	`minimax/MiniMax-M2.7`
Mistral	`mistral`	`MISTRAL_API_KEY`	`mistral/mistral-large-latest`
Moonshot	`moonshot`	`MOONSHOT_API_KEY`	`moonshot/kimi-k2.6`
NVIDIA	`nvidia`	`NVIDIA_API_KEY`	`nvidia/nvidia/nemotron-3-super-120b-a12b`
OpenRouter	`openrouter`	`OPENROUTER_API_KEY`	`openrouter/auto`
Qianfan	`qianfan`	`QIANFAN_API_KEY`	`qianfan/deepseek-v3.2`
Qwen Cloud	`qwen`	`QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY`	`qwen/qwen3.5-plus`
StepFun	`stepfun` / `stepfun-plan`	`STEPFUN_API_KEY`	`stepfun/step-3.5-flash`
Together	`together`	`TOGETHER_API_KEY`	`together/moonshotai/Kimi-K2.5`
Venice	`venice`	`VENICE_API_KEY`	-
Vercel AI Gateway	`vercel-ai-gateway`	`AI_GATEWAY_API_KEY`	`vercel-ai-gateway/anthropic/claude-opus-4.6`
Volcano Engine (Doubao)	`volcengine` / `volcengine-plan`	`VOLCANO_ENGINE_API_KEY`	`volcengine-plan/ark-code-latest`
xAI	`xai`	`XAI_API_KEY`	`xai/grok-4.3`
Xiaomi	`xiaomi`	`XIAOMI_API_KEY`	`xiaomi/mimo-v2-flash`

Bilinmesi gereken özel durumlar

OpenRouter

Uygulama ilişkilendirme başlıklarını ve Anthropic cache_control işaretleyicilerini yalnızca doğrulanmış openrouter.ai rotalarında uygular. DeepSeek, Moonshot ve ZAI referansları, OpenRouter tarafından yönetilen istem önbelleğe alma için cache-TTL’ye uygundur ancak Anthropic önbellek işaretleyicileri almaz. Proxy tarzı OpenAI uyumlu bir yol olarak, yalnızca yerel OpenAI’ye özgü şekillendirmeyi (serviceTier, Responses store, istem önbelleği ipuçları, OpenAI akıl yürütme uyumluluğu) atlar. Gemini destekli referanslar yalnızca proxy-Gemini düşünce imzası temizlemesini korur.

Kilo Gateway

Gemini destekli referanslar aynı proxy-Gemini temizleme yolunu izler; kilocode/kilo/auto ve proxy akıl yürütme desteği olmayan diğer referanslar proxy akıl yürütme enjeksiyonunu atlar.

MiniMax

API anahtarı onboarding’i açık metin-only M2.7 sohbet modeli tanımlarını yazar; görüntü anlama, plugin’in sahip olduğu MiniMax-VL-01 medya sağlayıcısında kalır.

NVIDIA

Model kimlikleri nvidia/<vendor>/<model> ad alanını kullanır (örneğin nvidia/moonshotai/kimi-k2.5 ile birlikte nvidia/nvidia/nemotron-...); seçiciler birebir <provider>/<model-id> bileşimini korurken API’ye gönderilen kanonik anahtar tek önekli kalır.

xAI

xAI Responses yolunu kullanır. grok-4.3, paketle gelen varsayılan sohbet modelidir. /fast veya params.fastMode: true, grok-3, grok-3-mini, grok-4 ve grok-4-0709 değerlerini *-fast varyantlarına yeniden yazar. tool_stream varsayılan olarak açıktır; agents.defaults.models["xai/<model>"].params.tool_stream=false ile devre dışı bırakın.

Cerebras

Paketle gelen cerebras sağlayıcı plugin’i olarak gelir. GLM zai-glm-4.7 kullanır; OpenAI uyumlu temel URL https://api.cerebras.ai/v1 şeklindedir.

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

Standart modeller
Kodlama modelleri (volcengine-plan)

volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
volcengine/doubao-seed-code-preview-251028
volcengine/kimi-k2-5-260127 (Kimi K2.5)
volcengine/glm-4-7-251222 (GLM 4.7)
volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

volcengine-plan/ark-code-latest
volcengine-plan/doubao-seed-code
volcengine-plan/kimi-k2.5
volcengine-plan/kimi-k2-thinking
volcengine-plan/glm-4.7

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.

Standart modeller
Kodlama modelleri (byteplus-plan)

byteplus/seed-1-8-251228 (Seed 1.8)
byteplus/kimi-k2-5-260127 (Kimi K2.5)
byteplus/glm-4-7-251222 (GLM 4.7)

byteplus-plan/ark-code-latest
byteplus-plan/doubao-seed-code
byteplus-plan/kimi-k2.5
byteplus-plan/kimi-k2-thinking
byteplus-plan/glm-4.7

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.

MiniMax’in Anthropic uyumlu akış yolunda, OpenClaw açıkça ayarlamadığınız sürece düşünmeyi varsayılan olarak devre dışı bırakır ve /fast on, MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.

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

Varsayılan isteğe bağlı alanlar

Özel sağlayıcılar için reasoning, input, cost, contextWindow ve maxTokens isteğe bağlıdır. Atlandığında OpenClaw varsayılan olarak şunları kullanır:

reasoning: false
input: ["text"]
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
contextWindow: 200000
maxTokens: 8192

Öneri: proxy/model sınırlarınızla eşleşen açık değerler ayarlayın.

Proxy rota şekillendirme kuralları

Yerel olmayan uç noktalarda api: "openai-completions" için (baseUrl boş olmayan ve ana makinesi api.openai.com olmayan herhangi bir değer), OpenClaw desteklenmeyen developer rolleri nedeniyle sağlayıcı 400 hatalarını önlemek için compat.supportsDeveloperRole: false değerini zorunlu kılar.
Proxy tarzı OpenAI uyumlu rotalar, yalnızca yerel OpenAI’ye özgü istek şekillendirmeyi de atlar: service_tier yok, Responses store yok, Completions store yok, istem önbelleği ipuçları yok, OpenAI düşünme uyumluluğu yük şekillendirmesi yok ve gizli OpenClaw atıf başlıkları yok.
Satıcıya özgü alanlara ihtiyaç duyan OpenAI uyumlu Completions proxy’leri için, giden istek gövdesine ek JSON birleştirmek üzere agents.defaults.models["provider/model"].params.extra_body (veya extraBody) ayarlayın.
vLLM sohbet şablonu denetimleri için agents.defaults.models["provider/model"].params.chat_template_kwargs ayarlayın. Paketlenmiş vLLM Plugin, oturum düşünme düzeyi kapalı olduğunda vllm/nemotron-3-* için otomatik olarak enable_thinking: false ve force_nonempty_content: true gönderir.
Yavaş yerel modeller veya uzak LAN/tailnet ana makineleri için models.providers.<id>.timeoutSeconds ayarlayın. Bu, tüm aracı çalışma zamanı zaman aşımını artırmadan bağlanma, başlıklar, gövde akışı ve toplam korumalı getirme iptali dahil olmak üzere sağlayıcı model HTTP isteği işlemeyi genişletir.
Model sağlayıcı HTTP çağrıları, yapılandırılmış sağlayıcı baseUrl ana makine adı için yalnızca 198.18.0.0/15 ve fc00::/7 içindeki Surge, Clash ve sing-box sahte IP DNS yanıtlarına izin verir. Diğer özel, loopback, link-local ve metadata hedefleri yine de açık bir models.providers.<id>.request.allowPrivateNetwork: true etkinleştirmesi gerektirir.
baseUrl boş/atlanmışsa OpenClaw, varsayılan OpenAI davranışını korur (bu da api.openai.com değerine çözümlenir).
Güvenlik için, açık bir compat.supportsDeveloperRole: true değeri yerel olmayan openai-completions uç noktalarında yine de geçersiz kılınır.
Yerel olmayan uç noktalarda api: "anthropic-messages" için (kanonik anthropic dışındaki herhangi bir sağlayıcı veya ana makinesi herkese açık bir api.anthropic.com uç noktası olmayan özel bir models.providers.anthropic.baseUrl), OpenClaw, özel Anthropic uyumlu proxy’lerin desteklenmeyen beta bayraklarını reddetmemesi için claude-code-20250219, interleaved-thinking-2025-05-14 ve OAuth işaretleri gibi örtük Anthropic beta başlıklarını bastırır. Proxy’nizin belirli beta özelliklerine ihtiyacı varsa models.providers.<id>.headers["anthropic-beta"] değerini açıkça ayarlayın.

CLI örnekleri

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw 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ı

Overview

Concepts and configuration

Providers

Model sağlayıcıları

Hızlı kurallar

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

API anahtarı rotasyonu

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

OpenAI

Anthropic

OpenAI Codex OAuth

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

GLM models

MiniMax

Qwen Cloud

OpenCode

Google Gemini (API anahtarı)

Google Vertex ve Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Kilo Gateway

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

Bilinmesi gereken özel durumlar

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

Moonshot AI (Kimi)

Kimi coding

Volcano Engine (Doubao)

BytePlus (Uluslararası)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI örnekleri

İlgili

Overview

Concepts and configuration

Providers

Documentation Index

​Hızlı kurallar

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

​API anahtarı rotasyonu

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

​OpenAI

​Anthropic

​OpenAI Codex OAuth

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

GLM models

MiniMax

Qwen Cloud

​OpenCode

​Google Gemini (API anahtarı)

​Google Vertex ve Gemini CLI

​Z.AI (GLM)

​Vercel AI Gateway

​Kilo Gateway

​Paketle gelen diğer sağlayıcı Plugin’leri

​Bilinmesi gereken özel durumlar

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

​Moonshot AI (Kimi)

​Kimi coding

​Volcano Engine (Doubao)

​BytePlus (Uluslararası)

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

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

​CLI örnekleri

​İlgili

Hızlı kurallar

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

API anahtarı rotasyonu

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

OpenAI

Anthropic

OpenAI Codex OAuth

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

OpenCode

Google Gemini (API anahtarı)

Google Vertex ve Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Kilo Gateway

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

Bilinmesi gereken özel durumlar

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

Moonshot AI (Kimi)

Kimi coding

Volcano Engine (Doubao)

BytePlus (Uluslararası)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI örnekleri

İlgili