Concepts and configuration
Model sağlayıcıları
LLM/model sağlayıcıları (WhatsApp/Telegram gibi sohbet kanalları değil) için başvuru kaynağı. Model seçimi kuralları için Modeller bölümüne bakın.
Hızlı kurallar
Model referansları ve CLI yardımcıları
- Model referansları
provider/modelkullanır (örnek:opencode/claude-opus-4-6). agents.defaults.modelstakma adları ve model başına ayarları saklar;agents.defaults.modelPolicy.allowisteğe bağlı açık geçersiz kılma izin listesidir.- CLI yardımcıları:
openclaw onboard,openclaw models list,openclaw models set <provider/model>. models.providers.*.contextWindow/contextTokens/maxTokenssağlayıcı düzeyindeki varsayılanları belirler;models.providers.*.models[].contextWindow/contextTokens/maxTokensbunları model bazında geçersiz kılar.- Geri dönüş kuralları, bekleme süresi yoklamaları ve oturum geçersiz kılmalarının kalıcılığı: Model yük devri.
Sağlayıcı kimlik doğrulaması eklemek birincil modelinizi değiştirmez
openclaw configure, bir sağlayıcı eklediğinizde veya yeniden kimlik doğrulaması yaptığınızda mevcut agents.defaults.model.primary değerini korur. openclaw models auth login da --set-default iletmediğiniz sürece aynısını yapar. Sağlayıcı Plugin'leri, kimlik doğrulama yapılandırması yamalarında yine de önerilen bir varsayılan model döndürebilir; ancak birincil model zaten mevcutsa OpenClaw bunu "geçerli birincil modeli değiştir" olarak değil, "bu modeli kullanılabilir hâle getir" olarak değerlendirir.
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 sağlayıcı/çalışma zamanı ayrımı
OpenAI model referansları ve aracı çalışma zamanları birbirinden ayrıdır:
openai/<model>, standart OpenAI sağlayıcısını ve modelini seçer. Önek tek başına hiçbir zaman Codex'i seçmez.- Sağlayıcı/model çalışma zamanı ilkesi ayarlanmamışsa veya
autoise OpenAI, yalnızca yazılmış bir istek geçersiz kılması bulunmayan, tam olarak resmî HTTPS Platform Responses veya ChatGPT Responses rotası için Codex'i örtük olarak seçebilir. - Yazılmış Completions bağdaştırıcıları, özel uç noktalar ve yazılmış istek davranışına sahip rotalar OpenClaw üzerinde kalır. Düz metin kullanan resmî HTTP uç noktaları reddedilir.
- Eski Codex model referansları, doctor'ın
openai/<model>olarak yeniden yazdığı eski yapılandırmadır. - Sağlayıcı/model
agentRuntime.id: "openclaw", aksi hâlde uygun olan bir rotayı açıkça OpenClaw üzerinde tutar.agentRuntime.id: "codex"Codex gerektirir ve etkin rota Codex ile uyumlu değilse kapalı biçimde başarısız olur.
OpenAI örtük aracı çalışma zamanı ve Codex koşum takımı bölümlerine bakın. Sağlayıcı/çalışma zamanı ayrımı kafa karıştırıcıysa önce Aracı çalışma zamanları bölümünü okuyun.
Plugin otomatik etkinleştirme de aynı sınırı izler: Örtük olarak Codex ile uyumlu etkin bir rota Codex Plugin'ini etkinleştirebilirken açık sağlayıcı/model agentRuntime.id: "codex" veya eski codex/<model> referansları bunu gerektirir. openai/* öneki tek başına bunu gerektirmez.
Yeni OpenAI kurulumu rotaya özgü bir GPT-5.6 referansı kullanır: API anahtarıyla kurulum
openai/gpt-5.6 seçer (çıplak doğrudan API kimliği Sol olarak çözümlenir), buna karşılık
ChatGPT/Codex OAuth, yerel Codex kataloğu için tam olarak openai/gpt-5.6-sol seçer.
openai/gpt-5.5 dâhil mevcut açık birincil modeller, OpenAI kimlik doğrulaması
eklendiğinde veya yenilendiğinde korunur. GPT-5.5, GPT-5.6 erişimi olmayan hesaplar için
her iki çalışma zamanı üzerinden de açık bir kurtarma seçeneği olarak kullanılabilir.
CLI çalışma zamanları
CLI çalışma zamanları aynı ayrımı kullanır: anthropic/claude-* veya google/gemini-* gibi standart model referanslarını seçin, ardından yerel bir CLI arka ucu istediğinizde sağlayıcı/model çalışma zamanı ilkesini claude-cli veya google-gemini-cli olarak ayarlayın.
Eski claude-cli/* ve google-gemini-cli/* referansları, çalışma zamanı ayrı olarak kaydedilerek standart sağlayıcı referanslarına geri taşınır. Eski codex-cli/* referansları openai/* biçimine taşınır ve Codex uygulama sunucusu rotasını kullanır; OpenClaw artık paketlenmiş bir Codex CLI arka ucunu barındırmaz.
Control UI'da sağlayıcıları yapılandırma
models.providers.<id>.apiKey içinde saklanan sağlayıcı API anahtarlarını eklemek, değiştirmek veya kaldırmak için Control UI'da Settings → Model Providers bölümünü açın. Sayfa, kimlik bilgilerini göstermeden her API anahtarının OpenClaw yapılandırmasından mı yoksa bir ortam değişkeninden mi geldiğini belirtir. Ortam tarafından sağlanan anahtarlar Gateway işleminin ortamı tarafından yönetilmeye devam eder.
Canlı bir sağlayıcı yoklaması çalıştırmak ve gecikmeyi ya da kategorize edilmiş bir kimlik doğrulama, hız sınırı, faturalandırma, zaman aşımı veya yanıt hatasını görmek için Test connection seçeneğini kullanın. Yoklama gerçek bir sağlayıcı isteği gönderir ve az sayıda token tüketebilir. OAuth ve token profillerindeki oturumlar da sağlayıcı kartından kapatılabilir.
Default models kartı, yapılandırılmış model kataloğundaki birincil modeli, sıralı geri dönüş modellerini ve yardımcı modeli yönetir. Modelleri seçin, ardından mevcut agents.defaults.model ve agents.defaults.utilityModel ayarlarına birlikte kaydedin. Yardımcı model için Automatic ayarı belirlenmemiş bırakır; Disabled ise yardımcı yönlendirmeyi kapatmak üzere boş bir dize saklar.
Plugin'e ait sağlayıcı davranışı
Sağlayıcıya özgü mantığın çoğu sağlayıcı Plugin'lerinde (registerProvider(...)) bulunurken OpenClaw genel çıkarım döngüsünü korur. Plugin'ler ilk kurulumu, model kataloglarını, kimlik doğrulama ortam değişkeni eşlemesini, aktarım/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ı yönetir.
Sağlayıcı SDK kancalarının ve paketlenmiş Plugin örneklerinin tam listesi Sağlayıcı Plugin'leri bölümünde bulunur. 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ı rotasyonu
Anahtar kaynakları ve öncelik
Birden çok anahtarı şunlar aracılığıyla yapılandırın:
OPENCLAW_LIVE_<PROVIDER>_KEY(tek canlı geçersiz kılma, en yüksek öncelik)<PROVIDER>_API_KEYS(virgülle veya noktalı virgülle ayrılmış liste)<PROVIDER>_API_KEY(birincil anahtar)<PROVIDER>_API_KEY_*(numaralandırılmış liste, ör.<PROVIDER>_API_KEY_1)
Google sağlayıcıları için GOOGLE_API_KEY da geri dönüş olarak dâhil edilir. Anahtar seçimi sırası önceliği korur ve yinelenen değerleri kaldırır.
Rotasyon ne zaman devreye girer
- İstekler yalnızca hız sınırı yanıtlarında (örneğin
429,rate_limit,quota,resource exhausted,Too many concurrent requests,ThrottlingException,concurrency limit reached,workers_ai ... quota limit exceededveya dönemsel kullanım sınırı iletilerinde) sonraki anahtarla yeniden denenir. - Hız sınırı dışındaki hatalar anında başarısız olur; anahtar rotasyonu denenmez.
- Tüm aday anahtarlar başarısız olduğunda son denemenin nihai hatası döndürülür.
Resmî sağlayıcı Plugin'leri
Resmî sağlayıcı Plugin'leri kendi model kataloğu satırlarını yayımlar. Bu sağlayıcılar 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şımları gibi dar kapsamlı istek ayarları için kullanılmalıdır.
OpenAI
- Sağlayıcı:
openai - Kimlik doğrulama:
OPENAI_API_KEY - İsteğe bağlı rotasyon:
OPENAI_API_KEYS,OPENAI_API_KEY_1,OPENAI_API_KEY_2veOPENCLAW_LIVE_OPENAI_KEY(tek geçersiz kılma) - Yeni kurulum varsayılanı:
openai/gpt-5.6; doğrudan API'de çıplak kimlik Sol olarak çözümlenir. - Örnek modeller:
openai/gpt-5.6,openai/gpt-5.6-terra,openai/gpt-5.6-luna,openai/gpt-5.5 - Belirli bir kurulum veya API anahtarı farklı davranıyorsa hesap/model kullanılabilirliğini
openclaw models list --provider openaiile doğrulayın. - CLI:
openclaw onboard --auth-choice openai-api-key - Varsayılan aktarım
autodeğeridir; OpenClaw aktarım seçimini paylaşılan model çalışma zamanına iletir. - Model bazında
agents.defaults.models["openai/<model>"].params.transportaracılığıyla geçersiz kılın ("sse","websocket"veya"auto") - OpenAI öncelikli işleme
agents.defaults.models["openai/<model>"].params.serviceTieraracılığıyla etkinleştirilebilir /fastveparams.fastMode,api.openai.comüzerindeki doğrudanopenai/*Responses istekleriniservice_tier=priorityolarak eşler- Paylaşılan
/fastanahtarı yerine açık bir katman istediğinizdeparams.serviceTierkullanın - Gizli OpenClaw atıf başlıkları (
originator,version,User-Agent) genel OpenAI uyumlu proxy'lere değil, yalnızcaapi.openai.comadresine 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ı korumaz openai/gpt-5.3-codex-sparkyalnızca ChatGPT/Codex OAuth üzerinden kullanılabilir; doğrudan OpenAI API anahtarı ve Azure API anahtarı rotaları bunu reddeder
{ agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}API kuruluşu GPT-5.6'yı sunmuyorsa
openai/gpt-5.5 değerini açıkça ayarlayın. Normal ilk kurulum ve yeniden kimlik doğrulama,
mevcut açık birincil modeli korur; models auth login --set-default ve
models set bilinçli değiştirme yollarıdır.
Anthropic
- Sağlayıcı:
anthropic - Kimlik doğrulama:
ANTHROPIC_API_KEY - İsteğe bağlı rotasyon:
ANTHROPIC_API_KEYS,ANTHROPIC_API_KEY_1,ANTHROPIC_API_KEY_2veOPENCLAW_LIVE_ANTHROPIC_KEY(tek geçersiz kılma) - Örnek model:
anthropic/claude-opus-5 - CLI:
openclaw onboard --auth-choice apiKey - Doğrudan genel Anthropic istekleri,
api.anthropic.comadresine gönderilen API anahtarı ve OAuth ile kimliği doğrulanmış trafik dâhil olmak üzere paylaşılan/fastanahtarını veparams.fastModedeğerini destekler; OpenClaw bunu Anthropicservice_tier(autoilestandard_only) biçiminde eşler - Tercih edilen Claude CLI yapılandırması, model referansını standart biçimde tutar ve CLI
arka ucunu ayrı olarak seçer: model kapsamlı
agentRuntime.id: "claude-cli"ileanthropic/claude-opus-5. Eskiclaude-cli/claude-opus-4-7referansları uyumluluk için çalışmaya devam eder.
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-5" } } },}OpenAI ChatGPT/Codex OAuth
- Sağlayıcı:
openai - Kimlik doğrulama: OAuth (ChatGPT)
- Yeni yerel Codex app-server test düzeneği referansı:
openai/gpt-5.6-sol - Yerel Codex app-server test düzeneği belgeleri: Codex test düzeneği
- Eski model referansları:
codex/gpt-*,openai-codex/gpt-* - Plugin sınırı:
openai/*, OpenAI Plugin'ini yükler; yerel Codex app-server Plugin'inin seçilip seçilmeyeceğini açık çalışma zamanı politikası veya sağlayıcının sahip olduğu etkin rota belirler. - CLI:
openclaw onboard --auth-choice openaiveyaopenclaw models auth login --provider openai - OpenClaw'ın yerleşik ChatGPT Responses aktarımı varsayılan olarak
autokullanır (önce WebSocket, yedek olarak SSE). agents.defaults.models["openai/<model>"].params.transport,params.serviceTierveparams.fastMode, tanımlanmış yerleşik istek ayarlarıdır. Örtük çalışma zamanı seçimini OpenClaw'da tutarlar; yerel Codex, kendi app-server aktarımının ve hizmet katmanının sahibidir.- Gizli OpenClaw ilişkilendirme başlıkları (
originator,version,User-Agent) genel OpenAI uyumlu proxy'lere değil, yalnızcachatgpt.com/backend-apihedefine giden yerel Codex trafiğine eklenir - Paylaşılan
/fastgeçişi, çalışma zamanı denetimi olarak kullanılabilir kalır; tanımlanmış model parametrelerinden farklıdır. - Yerel Codex kataloğu, hesap erişimine göre tam
openai/gpt-5.6-sol,openai/gpt-5.6-terraveopenai/gpt-5.6-lunareferanslarını sunabilir. Doğrudan API'nin yalıngpt-5.6diğer adını istemci tarafında uygulamaz. openai/gpt-5.5, Codex kataloğunun yerelcontextWindow = 400000değerini ve varsayılan çalışma zamanıcontextTokens = 272000değerini kullanır; çalışma zamanı sınırınımodels.providers.openai.models[].contextTokensile geçersiz kılınopenaikimlik doğrulamasıyla oturum açın ve abonelik destekli yeni bir kurulum içinopenai/gpt-5.6-solkullanın. Bu Codex çalışma alanı GPT-5.6'yı sunmuyorsa açıkçaopenai/gpt-5.5seçin.- Normalde uygun olan bir rotayı yerleşik çalışma zamanında tutmak için
agentRuntime.id: "openclaw"sağlayıcı/modelini kullanın. Çalışma zamanı ayarlanmamışsa veyaautoise yalnızca tanımlanmış istek geçersiz kılması bulunmayan, tam ve resmî bir HTTPS Responses/ChatGPT uyumlu rota Codex'i örtük olarak seçebilir. - Eski Codex GPT referansları canlı bir sağlayıcı rotası değil, eski durumdur. Yeni aracı yapılandırması için standart
openai/*referanslarını kullanın ve yerel Codex semantiklerini model kapsamlıagentRuntime.id: "codex"ile koruyarakcodex/*veopenai-codex/*referanslarını taşımak içinopenclaw doctor --fixkomutunu çalıştırın. Mevcut açık standartopenai/gpt-5.5seçimleri yükseltilmez.
{ plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, }, },}{ models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, },}Abonelik tarzındaki diğer barındırılan seçenekler
MiniMax Coding Plan OAuth veya API anahtarı erişimi.
Qwen Cloud sağlayıcı yüzeyi ile Alibaba DashScope ve Coding Plan uç noktası eşlemesi.
Z.AI Coding Plan veya genel API uç noktaları.
OpenCode
- Kimlik doğrulama:
OPENCODE_API_KEY(veyaOPENCODE_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-zenveyaopenclaw 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önüşüm:
GEMINI_API_KEYS,GEMINI_API_KEY_1,GEMINI_API_KEY_2, yedek olarakGOOGLE_API_KEYveOPENCLAW_LIVE_GEMINI_KEY(tek geçersiz kılma) - Örnek modeller:
google/gemini-3.1-pro-preview,google/gemini-3.5-flash - Uyumluluk:
google/gemini-3.1-flash-previewkullanan eski OpenClaw yapılandırmasıgoogle/gemini-3-flash-previewolarak normalleştirilir - Diğer ad:
google/gemini-3.1-prokabul edilir ve Google'ın canlı Gemini API kimliği olangoogle/gemini-3.1-pro-previewdeğ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 birthinkingLeveldeğerini atlar; Gemini 2.5,thinkingBudget: -1gönderir. - Doğrudan Gemini çalıştırmaları, sağlayıcıya özgü bir
cachedContents/...tanıtıcısını iletmek içinagents.defaults.models["google/<model>"].params.cachedContent(veya eskicached_content) değerini de kabul eder; Gemini önbellek isabetleri OpenClawcacheReadolarak gösterilir
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, paketlenmiş google Plugin'inin bir parçası olarak sunulur.
Gemini CLI'ı yükleyin
brew
brew install gemini-clinpm
npm install -g @google/gemini-cliPlugin'i etkinleştirin
openclaw plugins enable googleOturum açın
openclaw models auth login --provider google-gemini-cli --set-defaultVarsayılan model: google-gemini-cli/gemini-3-flash-preview. openclaw.json içine istemci kimliği veya gizli anahtar yapıştırmayın. CLI oturum açma akışı, belirteçleri Gateway ana makinesindeki kimlik doğrulama profillerinde depolar.
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 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 hâlâ response üzerinden 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ı standart
zai/*sağlayıcı kimliğini kullanır. zai-api-key, eşleşen Z.AI uç noktasını otomatik olarak algılar;zai-coding-global,zai-coding-cn,zai-globalvezai-cnbelirli bir yüzeyi zorunlu kılar
- Model referansları standart
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
Paketlenmiş diğer sağlayıcı Plugin'leri
| Sağlayıcı | Kimlik | Kimlik doğrulama ortam değişkeni | Örnek model |
|---|---|---|---|
| Arcee | arcee |
ARCEEAI_API_KEY veya OPENROUTER_API_KEY |
arcee/trinity-large-thinking |
| BytePlus | byteplus / byteplus-plan |
BYTEPLUS_API_KEY |
byteplus-plan/ark-code-latest |
| Cerebras | cerebras |
CEREBRAS_API_KEY |
cerebras/zai-glm-4.7 |
| Chutes | chutes |
CHUTES_API_KEY veya CHUTES_OAUTH_TOKEN |
chutes/zai-org/GLM-5-TEE |
| ClawRouter | clawrouter |
CLAWROUTER_API_KEY |
clawrouter/anthropic/claude-sonnet-4-6 |
| Cohere | cohere |
COHERE_API_KEY |
cohere/command-a-plus-05-2026 |
| DeepInfra | deepinfra |
DEEPINFRA_API_KEY |
deepinfra/deepseek-ai/DeepSeek-V4-Flash |
| DeepSeek | deepseek |
DEEPSEEK_API_KEY |
deepseek/deepseek-v4-flash |
| Featherless AI | featherless |
FEATHERLESS_API_KEY |
featherless/Qwen/Qwen3-32B |
| GitHub Copilot | github-copilot |
COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN |
- |
| GMI Cloud | gmi |
GMI_API_KEY |
gmi/google/gemini-3.1-flash-lite |
| Groq | groq |
GROQ_API_KEY |
groq/llama-3.3-70b-versatile |
| Hugging Face Inference | huggingface |
HUGGINGFACE_HUB_TOKEN veya HF_TOKEN |
huggingface/deepseek-ai/DeepSeek-R1 |
| MiniMax | minimax / minimax-portal |
MINIMAX_API_KEY / MINIMAX_OAUTH_TOKEN |
minimax/MiniMax-M3 |
| 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-ultra-550b-a55b |
| NovitaAI | novita |
NOVITA_API_KEY |
novita/deepseek/deepseek-v3-0324 |
| Ollama Cloud | ollama-cloud |
OLLAMA_API_KEY |
ollama-cloud/kimi-k2.6 |
| OpenRouter | openrouter |
OpenRouter OAuth veya OPENROUTER_API_KEY |
openrouter/auto |
| Qianfan | qianfan |
QIANFAN_API_KEY |
qianfan/deepseek-v3.2 |
| Tencent TokenHub | tencent-tokenhub |
TOKENHUB_API_KEY |
tencent-tokenhub/hy3-preview |
| Together | together |
TOGETHER_API_KEY |
together/meta-llama/Llama-3.3-70B-Instruct-Turbo |
| 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 |
SuperGrok/X Premium OAuth veya XAI_API_KEY |
xai/grok-4.3 |
| Xiaomi | xiaomi / xiaomi-token-plan |
XIAOMI_API_KEY / XIAOMI_TOKEN_PLAN_API_KEY |
xiaomi/mimo-v2.5 / xiaomi-token-plan/mimo-v2.5-pro |
Bilinmesi yararlı özel durumlar
OpenRouter
Uygulama ilişkilendirme üstbilgilerini ve Anthropic cache_control işaretçilerini 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 önbellek TTL'sine uygundur ancak Anthropic önbellek işaretçilerini almaz. Proxy tarzı OpenAI uyumlu bir yol olduğundan yalnızca yerel OpenAI'ye özgü biçimlendirmeyi (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ı temizliğini korur.
Kilo Gateway
Gemini destekli referanslar aynı proxy-Gemini temizleme yolunu izler; kilocode/kilo-auto/balanced ve proxy akıl yürütmeyi desteklemeyen diğer referanslar, proxy akıl yürütme eklemesini atlar.
MiniMax
API anahtarıyla ilk kurulum, açık M3 ve 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 bir nvidia/<vendor>/<model> ad alanı kullanır (örneğin nvidia/nvidia/nemotron-...); seçiciler değişmez <provider>/<model-id> bileşimini korurken API'ye gönderilen kurallı anahtar tek önekli kalır.
xAI
xAI Responses yolunu kullanır. Önerilen yol SuperGrok/X Premium OAuth'tır; API anahtarları XAI_API_KEY veya Plugin yapılandırması üzerinden çalışmaya devam eder ve Grok web_search, API anahtarı geri dönüşünden önce aynı kimlik doğrulama profilini yeniden kullanır. Grok 4.5, kullanılabildiği yerlerde sohbet, kodlama ve etmen tabanlı çalışmalar için seçilebilir; grok-4.3 bölgesel olarak güvenli paketlenmiş varsayılan olmaya devam eder. Eski /fast ve params.fastMode: true yapılandırmaları xAI'ın Grok 4.3 uyumluluk yönlendirmeleri üzerinden çözümlenmeye devam eder ancak yeni yapılandırmalarda doğrudan güncel bir model seçilmelidir. tool_stream varsayılan olarak açıktır; agents.defaults.models["xai/<model>"].params.tool_stream=false üzerinden devre dışı bırakın.
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 paketlenmiş sağlayıcı Plugin'lerinin ç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.
Paketlenmiş ve katalogca bilinen rotalar, compat yeteneklerini sahip olan sağlayıcı Plugin'inden alır. Bir yapılandırma compat bloğu, sözleşmesini doğruladığınız özel bir sağlayıcı/model veya farklı bir api/baseUrl rotası içindir; özel sağlayıcı yetenek kılavuzuna bakın. Doctor, yalnızca kataloğu yineleyen eski değerleri kaldırır ve farklı değerleri operatör incelemesi için görünür bırakır.
Gateway model yetenek kontrolleri 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 bu modelde input: ["text", "image"] ayarını yapın.
agents.defaults.models["provider/model"], etmenlerin takma adlarını ve model başına meta verilerini denetler. Tek başına ne geçersiz kılmaları sınırlar ne de yeni bir çalışma zamanı modeli kaydeder. Özel sağlayıcı modelleri için en azından eşleşen id ile birlikte models.providers.<provider>.models[] de ekleyin; geçersiz kılma kısıtlaması istediğinizde agents.defaults.modelPolicy.allow öğesini ayrıca kullanın.
Moonshot AI (Kimi)
İlk kurulumdan önce @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-k3 - CLI:
openclaw onboard --auth-choice moonshot-api-keyveyaopenclaw onboard --auth-choice moonshot-api-key-cn
Kimi model kimlikleri:
moonshot/kimi-k2.6moonshot/kimi-k3moonshot/kimi-k2.7-codemoonshot/kimi-k2.7-code-highspeedmoonshot/kimi-k2.5
{ 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" }], }, }, },}Eksiksiz kurulum kılavuzu için Moonshot AI (Kimi + Kimi Coding) sayfasına bakın.
Kimi Coding
Kimi Coding, Moonshot AI'ın Anthropic uyumlu uç noktasını kullanır:
- Sağlayıcı:
kimi - Kimlik doğrulama:
KIMI_API_KEY - Kimi K3:
kimi/k3(256K) veyakimi/k3[1m](1M plan) - Kimi Code:
kimi/kimi-for-coding - Kimi Code HighSpeed:
kimi/kimi-for-coding-highspeed
{ env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" } }, },}Eski kimi/kimi-code ve kimi/k2p5, uyumluluk modeli kimlikleri olarak kabul edilmeye devam eder ve Kimi'nin kararlı API modeli 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 da aynı anda kaydedilir.
İlk kurulum/yapılandırma model seçicilerinde Volcengine kimlik doğrulama seçeneği 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 filtrelenmemiş kataloğa geri döner.
Standart modeller
volcengine/doubao-seed-1-8-251228(Doubao Seed 1.8)volcengine/doubao-seed-code-preview-251028volcengine/kimi-k2-5-260127(Kimi K2.5)volcengine/glm-4-7-251222(GLM 4.7)volcengine/deepseek-v3-2-251201(DeepSeek V3.2)
Kodlama modelleri (volcengine-plan)
volcengine-plan/ark-code-latestvolcengine-plan/doubao-seed-code
BytePlus (Uluslararası)
BytePlus ARK, uluslararası kullanıcıların Volcano Engine ile aynı modellere erişmesini 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 katılım varsayılan olarak kodlama yüzeyini kullanır, ancak genel byteplus/* kataloğu da aynı anda kaydedilir.
İlk katılım/yapılandırma model seçicilerinde BytePlus kimlik doğrulama seçeneği hem byteplus/* hem de byteplus-plan/* satırlarını tercih eder. Bu modeller henüz yüklenmemişse OpenClaw, sağlayıcı kapsamlı boş bir seçici göstermek yerine filtrelenmemiş kataloğa geri döner.
Standart modeller
byteplus/seed-1-8-251228(Seed 1.8)byteplus/kimi-k2-5-260127(Kimi K2.5)byteplus/glm-4-7-251222(GLM 4.7)
Kodlama modelleri (byteplus-plan)
byteplus-plan/ark-code-latestbyteplus-plan/kimi-k2.5byteplus-plan/glm-4.7
Synthetic
Synthetic, synthetic sağlayıcısı üzerinden Anthropic uyumlu modeller sunar:
- Sağlayıcı:
synthetic - Kimlik doğrulama:
SYNTHETIC_API_KEY - Örnek model:
synthetic/hf:MiniMaxAI/MiniMax-M3 - CLI:
openclaw onboard --auth-choice synthetic-api-key
{ agents: { defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" } }, }, models: { mode: "merge", providers: { synthetic: { baseUrl: "https://api.synthetic.new/anthropic", apiKey: "${SYNTHETIC_API_KEY}", api: "anthropic-messages", models: [{ id: "hf:MiniMaxAI/MiniMax-M3", name: "MiniMax M3" }], }, }, },}MiniMax
MiniMax, özel uç noktalar kullandığından 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:
minimaxiçinMINIMAX_API_KEY;minimax-portaliçinMINIMAX_OAUTH_TOKENveyaMINIMAX_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 tarafından yönetilen yetenek ayrımı:
- Metin/sohbet varsayılanları
minimax/MiniMax-M3üzerinde kalır - Görsel oluşturma
minimax/image-01veyaminimax-portal/image-01kullanır - Görsel anlama, her iki MiniMax kimlik doğrulama yolunda da Plugin tarafından yönetilen
MiniMax-VL-01kullanır - Web araması
minimaxsağlayıcı kimliğinde kalır
LM Studio
LM Studio, yerel API'yi kullanan paketlenmiş bir sağlayıcı Plugin'i olarak sunulur:
- 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 ve otomatik yükleme için LM Studio'nun yerel /api/v1/models ve /api/v1/models/load özelliklerini, varsayılan olarak çıkarım içinse /v1/chat/completions özelliğini kullanır. LM Studio'nun JIT yükleme, TTL ve otomatik çıkarma işlevlerinin model yaşam döngüsünü yönetmesini istiyorsanız models.providers.lmstudio.params.preload: false ayarını yapın. Kurulum ve sorun giderme için /providers/lmstudio sayfasına bakın.
Ollama
Ollama, paketlenmiş bir sağlayıcı Plugin'i olarak sunulur 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
# Ollama'yı kurun, ardından bir model çekin:ollama pull llama3.3{ agents: { defaults: { model: { primary: "ollama/llama3.3" } }, },}OLLAMA_API_KEY ile etkinleştirdiğinizde Ollama, yerel olarak http://127.0.0.1:11434 adresinde algılanır ve paketlenmiş sağlayıcı Plugin'i Ollama'yı doğrudan openclaw onboard ile model seçiciye ekler. İlk katılım, 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 paketlenmiş bir sağlayıcı Plugin'i olarak sunulur:
- 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ını zorunlu kılmıyorsa herhangi bir değer kullanılabilir):
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, kendi barındırdığınız hızlı OpenAI uyumlu sunucular için paketlenmiş bir sağlayıcı Plugin'i olarak sunulur:
- 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ını zorunlu kılmıyorsa herhangi bir değer kullanılabilir):
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. Bunlar belirtilmediğinde OpenClaw şu varsayılanları kullanır:
reasoning: falseinput: ["text"]cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }contextWindow: 200000maxTokens: 8192
Önerilen: proxy/model sınırlarınızla eşleşen değerleri açıkça ayarlayın.
Proxy yolu biçimlendirme kuralları
- Yerel olmayan uç noktalardaki
api: "openai-completions"için (ana bilgisayarıapi.openai.comolmayan, boş olmayan herhangi birbaseUrl) OpenClaw, desteklenmeyendeveloperrolleri nedeniyle oluşan sağlayıcı 400 hatalarını önlemek amacıylacompat.supportsDeveloperRole: falsedeğerini zorunlu kılar. - Proxy tarzı OpenAI uyumlu yollar, yalnızca yerel OpenAI'ye özgü istek biçimlendirmesini de atlar:
service_tier, Responsesstore, Completionsstore, istem önbelleği ipuçları, OpenAI düşünme uyumluluğu yük biçimlendirmesi ve gizli OpenClaw atıf üstbilgileri kullanılmaz. - Satıcıya özgü alanlara ihtiyaç duyan OpenAI uyumlu Completions proxy'leri için, ek JSON'u giden istek gövdesiyle birleştirmek üzere
agents.defaults.models["provider/model"].params.extra_body(veyaextraBody) ayarını yapın. - vLLM sohbet şablonu denetimleri için
agents.defaults.models["provider/model"].params.chat_template_kwargsayarını yapın. Paketlenmiş vLLM Plugin'i, oturum düşünme düzeyi kapalıykenvllm/nemotron-3-*içinenable_thinking: falseveforce_nonempty_content: truedeğerlerini otomatik olarak gönderir. - Yavaş yerel modeller veya uzak LAN/tailnet ana bilgisayarları için
models.providers.<id>.timeoutSecondsayarını yapın. Bu, tüm ajan çalışma zamanı zaman aşımını artırmadan bağlantı, üstbilgiler, gövde akışı ve korumalı getirme işleminin toplam iptali dâhil olmak üzere sağlayıcı modeli HTTP isteği işlemeyi uzatır.agents.defaults.timeoutSecondsveya çalıştırmaya özgü bir zaman aşımı daha düşükse bu üst sınırı da yükseltin; sağlayıcı zaman aşımları tüm çalıştırmayı uzatamaz. - Model sağlayıcısı HTTP çağrıları, yalnızca yapılandırılmış sağlayıcı
baseUrlana bilgisayar adı için198.18.0.0/15vefc00::/7içindeki Surge, Clash ve sing-box sahte IP DNS yanıtlarına izin verir. Özel/yerel sağlayıcı uç noktaları ayrıca geri döngü, LAN ve tailnet ana bilgisayarları dâhil olmak üzere korumalı model istekleri için tam olarak yapılandırılmışscheme://host:portkaynağına güvenir. Bu yeni bir yapılandırma seçeneği değildir; yapılandırdığınızbaseUrl, istek politikasını yalnızca bu kaynak için genişletir. Sahte IP ana bilgisayar adı izni ve tam kaynak güveni bağımsız mekanizmalardır. Diğer özel, geri döngü, bağlantı-yerel, meta veri hedefleri ve farklı bağlantı noktaları yine açık birmodels.providers.<id>.request.allowPrivateNetwork: trueetkinleştirmesi gerektirir. Tam kaynak güvenini devre dışı bırakmak içinmodels.providers.<id>.request.allowPrivateNetwork: falseayarını yapın. baseUrlboşsa veya belirtilmemişse OpenClaw, varsayılan OpenAI davranışını korur (bu,api.openai.comdeğerine çözümlenir).- Güvenlik amacıyla, açıkça belirtilen bir
compat.supportsDeveloperRole: truedeğeri yerel olmayanopenai-completionsuç noktalarında yine geçersiz kılınır. - Doğrudan olmayan uç noktalardaki
api: "anthropic-messages"için (standartanthropicdışındaki herhangi bir sağlayıcı veya ana bilgisayarı genel birapi.anthropic.comuç noktası olmayan özel birmodels.providers.anthropic.baseUrl) OpenClaw, özel Anthropic uyumlu proxy'lerin desteklenmeyen beta bayraklarını reddetmemesi içinclaude-code-20250219,interleaved-thinking-2025-05-14ve OAuth işaretçileri gibi örtük Anthropic beta üstbilgilerini bastırır. Proxy'niz belirli beta özelliklerine ihtiyaç duyuyorsamodels.providers.<id>.headers["anthropic-beta"]değerini açıkça ayarlayın.
CLI örnekleri
openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models listAyrıca tam yapılandırma örnekleri için Yapılandırma sayfasına bakın.
İlgili
- Yapılandırma referansı - model yapılandırma anahtarları
- Model yük devri - geri dönüş zincirleri ve yeniden deneme davranışı
- Modeller - model yapılandırması ve takma adlar
- Sağlayıcılar - sağlayıcıya özgü kurulum kılavuzları