Modeller: varsayılanlar, seçim, takma adlar, geçiş
“Varsayılan model” nedir?
“Varsayılan model” nedir?
provider/model olarak referanslanır (örnek: openai/gpt-5.5 veya anthropic/claude-sonnet-4-6). Sağlayıcıyı atarsanız, OpenClaw önce bir takma ad dener, sonra o tam model kimliği için benzersiz bir yapılandırılmış sağlayıcı eşleşmesi arar ve ancak bundan sonra kullanım dışı uyumluluk yolu olarak yapılandırılmış varsayılan sağlayıcıya geri döner. Bu sağlayıcı artık yapılandırılmış varsayılan modeli sunmuyorsa OpenClaw, eski ve kaldırılmış bir sağlayıcı varsayılanını göstermek yerine ilk yapılandırılmış sağlayıcı/modele geri döner. Yine de provider/model değerini açıkça ayarlamalısınız.Hangi modeli önerirsiniz?
Hangi modeli önerirsiniz?
Yapılandırmamı silmeden modelleri nasıl değiştiririm?
Yapılandırmamı silmeden modelleri nasıl değiştiririm?
- Sohbette
/model(hızlı, oturum başına) openclaw models set ...(yalnızca model yapılandırmasını günceller)openclaw configure --section model(etkileşimli)~/.openclaw/openclaw.jsoniçindeagents.defaults.modeldeğerini düzenleyin
config.apply kullanmaktan kaçının.
RPC düzenlemeleri için önce config.schema.lookup ile inceleyin ve config.patch tercih edin. Arama yükü size normalleştirilmiş yolu, sığ şema dokümanlarını/kısıtlarını ve anlık alt öğe özetlerini verir.
kısmi güncellemeler için.
Yapılandırmanın üzerine yazdıysanız, yedekten geri yükleyin veya onarmak için openclaw doctor komutunu yeniden çalıştırın.Dokümanlar: Modeller, Yapılandır, Yapılandırma, Doctor.Kendi barındırdığım modelleri (llama.cpp, vLLM, Ollama) kullanabilir miyim?
Kendi barındırdığım modelleri (llama.cpp, vLLM, Ollama) kullanabilir miyim?
- Ollama’yı
https://ollama.com/downloadadresinden yükleyin ollama pull gemma4gibi yerel bir model çekin- Bulut modellerini de istiyorsanız
ollama signinçalıştırın openclaw onboardçalıştırın veOllamaseçinLocalveyaCloud + Localseçin
Cloud + Localsize bulut modellerini ve yerel Ollama modellerinizi verirkimi-k2.5:cloudgibi bulut modelleri yerel çekme gerektirmez- elle geçiş için
openclaw models listveopenclaw models set ollama/<model>kullanın
OpenClaw, Flawd ve Krill modeller için ne kullanır?
OpenClaw, Flawd ve Krill modeller için ne kullanır?
- Bu dağıtımlar farklılık gösterebilir ve zamanla değişebilir; sabit bir sağlayıcı önerisi yoktur.
- Her gateway’de geçerli çalışma zamanı ayarını
openclaw models statusile kontrol edin. - Güvenlik açısından hassas/araç etkin ajanlar için mevcut en güçlü en yeni nesil modeli kullanın.
Modelleri anında (yeniden başlatmadan) nasıl değiştiririm?
Modelleri anında (yeniden başlatmadan) nasıl değiştiririm?
/model komutunu tek başına mesaj olarak kullanın:agents.defaults.models üzerinden eklenebilir.Kullanılabilir modelleri /model, /model list veya /model status ile listeleyebilirsiniz./model (ve /model list) kompakt, numaralı bir seçici gösterir. Numarayla seçin:/model status hangi ajanın etkin olduğunu, hangi auth-profiles.json dosyasının kullanıldığını ve sırada hangi kimlik doğrulama profilinin deneneceğini gösterir.
Ayrıca varsa yapılandırılmış sağlayıcı uç noktasını (baseUrl) ve API modunu (api) gösterir.@profile ile ayarladığım bir profil sabitlemesini nasıl kaldırırım?/model komutunu @profile son eki olmadan yeniden çalıştırın:/model içinden seçin (veya /model <default provider/model> gönderin).
Hangi kimlik doğrulama profilinin etkin olduğunu doğrulamak için /model status kullanın.İki sağlayıcı aynı model kimliğini sunarsa /model hangisini kullanır?
İki sağlayıcı aynı model kimliğini sunarsa /model hangisini kullanır?
/model provider/model, oturum için tam olarak o sağlayıcı yolunu seçer.Örneğin qianfan/deepseek-v4-flash ve deepseek/deepseek-v4-flash, ikisi de deepseek-v4-flash içerse bile farklı model referanslarıdır. OpenClaw, çıplak model kimliği eşleşiyor diye bir sağlayıcıdan diğerine sessizce geçmemelidir.Kullanıcı tarafından seçilen bir /model referansı, geri dönüş ilkesi için de katıdır. Seçilen sağlayıcı/model kullanılamıyorsa yanıt, agents.defaults.model.fallbacks üzerinden cevaplamak yerine görünür biçimde başarısız olur. Yapılandırılmış geri dönüş zincirleri hâlâ yapılandırılmış varsayılanlar, cron işi birincilleri ve otomatik seçilen geri dönüş durumu için geçerlidir.Oturum dışı bir geçersiz kılmadan başlayan bir çalıştırmanın geri dönüş kullanmasına izin verilirse OpenClaw önce istenen sağlayıcı/modeli, sonra yapılandırılmış geri dönüşleri ve ancak ardından yapılandırılmış birincili dener. Bu, yinelenen çıplak model kimliklerinin doğrudan varsayılan sağlayıcıya geri atlamasını önler.Bkz. Modeller ve Model failover.Günlük görevler için GPT 5.5, kodlama için Codex 5.5 kullanabilir miyim?
Günlük görevler için GPT 5.5, kodlama için Codex 5.5 kullanabilir miyim?
- Yerel Codex kodlama ajanı:
agents.defaults.model.primarydeğeriniopenai/gpt-5.5olarak ayarlayın. ChatGPT/Codex abonelik kimlik doğrulaması istediğinizdeopenclaw models auth login --provider openaiile oturum açın. - Ajan döngüsü dışındaki doğrudan OpenAI API görevleri: görseller, embeddings, konuşma, realtime ve diğer ajan dışı OpenAI API yüzeyleri için
OPENAI_API_KEYyapılandırın. - OpenAI ajan API anahtarı kimlik doğrulaması: sıralı bir
openaiAPI anahtarı profiliyle/model openai/gpt-5.5kullanın. - Alt ajanlar: kodlama görevlerini kendi
openai/gpt-5.5modeline sahip Codex odaklı bir ajana yönlendirin.
GPT 5.5 için hızlı modu nasıl yapılandırırım?
GPT 5.5 için hızlı modu nasıl yapılandırırım?
- Oturum başına: oturum
openai/gpt-5.5kullanırken/fast ongönderin. - Model başına varsayılan:
agents.defaults.models["openai/gpt-5.5"].params.fastModedeğerinitrueolarak ayarlayın. - Otomatik kesme: yeni model çağrılarını otomatik kesmeye kadar hızlı başlatmak, ardından daha sonraki retry, geri dönüş, araç sonucu veya devam çağrılarını hızlı mod olmadan başlatmak için
/fast autoveyaparams.fastMode: "auto"kullanın. Kesme varsayılan olarak 60 saniyedir; değiştirmek için etkin modeldeparams.fastAutoOnSecondsayarlayın.
service_tier = "priority" değerine eşlenir. Oturum /fast geçersiz kılmaları yapılandırma varsayılanlarının önüne geçer. Codex uygulama sunucusu turları katmanı yalnızca tur başlangıcında alabilir, bu nedenle auto, zaten çalışmakta olan bir uygulama sunucusu turunun içinde değil, OpenClaw tarafından başlatılan sonraki model turunda uygulanır.Bkz. Düşünme ve hızlı mod ve OpenAI hızlı mod.Neden "Model ... is not allowed" görüyorum ve ardından yanıt gelmiyor?
Neden "Model ... is not allowed" görüyorum ve ardından yanıt gelmiyor?
agents.defaults.models ayarlanmışsa, /model ve tüm
oturum geçersiz kılmaları için izin listesi olur. Bu listede olmayan bir modeli seçmek şunu döndürür:agents.defaults.models içine ekleyin, dinamik sağlayıcı katalogları için "provider/*": {} gibi bir sağlayıcı jokeri ekleyin, izin listesini kaldırın veya /model list içinden bir model seçin.
Komut ayrıca --runtime codex içeriyorsa önce izin listesini güncelleyin ve ardından aynı
/model provider/model --runtime codex komutunu yeniden deneyin.Neden "Unknown model: minimax/MiniMax-M3" görüyorum?
Neden "Unknown model: minimax/MiniMax-M3" görüyorum?
-
Güncel bir OpenClaw sürümüne yükseltin (veya kaynak
mainüzerinden çalıştırın), ardından gateway’i yeniden başlatın. -
MiniMax’in yapılandırıldığından (sihirbaz veya JSON) ya da eşleşen sağlayıcının enjekte edilebilmesi için env/kimlik doğrulama profillerinde MiniMax kimlik doğrulamasının
mevcut olduğundan emin olun
(
minimaxiçinMINIMAX_API_KEY,minimax-portaliçinMINIMAX_OAUTH_TOKENveya saklanan MiniMax OAuth). -
Kimlik doğrulama yolunuz için tam model kimliğini (büyük/küçük harfe duyarlı) kullanın:
API anahtarı kurulumu için
minimax/MiniMax-M3,minimax/MiniMax-M2.7veyaminimax/MiniMax-M2.7-highspeed; OAuth kurulumu içinminimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7veyaminimax-portal/MiniMax-M2.7-highspeed. -
Şunu çalıştırın:
ve listeden seçin (veya sohbette
/model list).
MiniMax’i varsayılanım, OpenAI’ı karmaşık görevler için kullanabilir miyim?
MiniMax’i varsayılanım, OpenAI’ı karmaşık görevler için kullanabilir miyim?
/model veya ayrı bir ajan kullanın.Seçenek A: oturum başına değiştirin- Ajan A varsayılanı: MiniMax
- Ajan B varsayılanı: OpenAI
- Ajana göre yönlendirin veya geçiş yapmak için
/agentkullanın
opus / sonnet / gpt yerleşik kısayollar mı?
opus / sonnet / gpt yerleşik kısayollar mı?
agents.defaults.models içinde varsa uygulanır):opus→anthropic/claude-opus-4-8sonnet→anthropic/claude-sonnet-4-6gpt→openai/gpt-5.4gpt-mini→openai/gpt-5.4-minigpt-nano→openai/gpt-5.4-nanogemini→google/gemini-3.1-pro-previewgemini-flash→google/gemini-3-flash-previewgemini-flash-lite→google/gemini-3.1-flash-lite
Model kısayollarını (takma adları) nasıl tanımlar/geçersiz kılarım?
Model kısayollarını (takma adları) nasıl tanımlar/geçersiz kılarım?
agents.defaults.models.<modelId>.alias değerinden gelir. Örnek:/model sonnet (veya desteklendiğinde /<alias>) bu model kimliğine çözümlenir.OpenRouter veya Z.AI gibi diğer sağlayıcılardan modelleri nasıl eklerim?
OpenRouter veya Z.AI gibi diğer sağlayıcılardan modelleri nasıl eklerim?
No API key found for provider "zai").Yeni ajan eklendikten sonra sağlayıcı için API anahtarı bulunamadıBu genellikle yeni ajanın boş bir kimlik doğrulama deposu olduğu anlamına gelir. Kimlik doğrulama ajan başınadır ve burada saklanır:openclaw agents add <id>çalıştırın ve sihirbaz sırasında kimlik doğrulamayı yapılandırın.- Ya da yalnızca taşınabilir statik
api_key/tokenprofillerini ana ajanın kimlik doğrulama deposundan yeni ajanın kimlik doğrulama deposuna kopyalayın. - OAuth profilleri için, yeni ajanın kendi hesabına ihtiyacı olduğunda yeni ajandan oturum açın; aksi halde OpenClaw yenileme tokenlarını klonlamadan varsayılan/ana ajana okuyarak erişebilir.
agentDir değerini ajanlar arasında yeniden kullanmayın; kimlik doğrulama/oturum çakışmalarına neden olur.Model devretmesi ve “Tüm modeller başarısız oldu”
Devretme nasıl çalışır?
Devretme nasıl çalışır?
- Aynı sağlayıcı içinde kimlik doğrulama profili rotasyonu.
agents.defaults.model.fallbacksiçindeki sonraki modele model yedeği.
429 yanıtlarından fazlasını içerir. OpenClaw
Too many concurrent requests,
ThrottlingException, concurrency limit reached,
workers_ai ... quota limit exceeded, resource exhausted gibi iletileri ve periyodik
kullanım penceresi sınırlarını (weekly/monthly limit reached) da devretmeye değer
hız sınırları olarak değerlendirir.Faturalandırma gibi görünen bazı yanıtlar 402 değildir ve bazı HTTP 402
yanıtları da bu geçici kovada kalır. Bir sağlayıcı 401 veya 403 üzerinde
açık faturalandırma metni döndürürse OpenClaw bunu yine de
faturalandırma hattında tutabilir, ancak sağlayıcıya özgü metin eşleştiriciler
bunların sahibi olan sağlayıcıyla sınırlı kalır (örneğin OpenRouter Key limit exceeded). Bir 402
iletisi bunun yerine yeniden denenebilir bir kullanım penceresi veya
kuruluş/çalışma alanı harcama sınırı gibi görünüyorsa (daily limit reached, resets tomorrow,
organization spending limit exceeded), OpenClaw bunu uzun süreli bir faturalandırma devre dışı bırakması
değil rate_limit olarak değerlendirir.Bağlam taşması hataları farklıdır: request_too_large,
input exceeds the maximum number of tokens,
input token count exceeds the maximum number of input tokens,
input is too long for the model veya ollama error: context length exceeded gibi imzalar model yedeğine ilerlemek yerine compaction/yeniden deneme yolunda kalır.Genel sunucu hatası metni bilinçli olarak “içinde bilinmeyen/hata geçen
her şey”den daha dardır. OpenClaw sağlayıcı bağlamı eşleştiğinde Anthropic çıplak
An unknown error occurred, OpenRouter çıplak
Provider returned error, Unhandled stop reason: error gibi durdurma nedeni hataları, geçici sunucu metni içeren JSON api_error yükleri
(internal server error, unknown error, 520, upstream error, backend error) ve ModelNotReadyException gibi sağlayıcı meşgul hataları gibi
sağlayıcı kapsamlı geçici şekilleri devretmeye değer zaman aşımı/aşırı yük sinyalleri olarak
değerlendirir.
LLM request failed with an unknown error. gibi genel iç yedek metinler temkinli kalır ve tek başına model yedeğini tetiklemez."anthropic:default profili için kimlik bilgisi bulunamadı" ne anlama gelir?
"anthropic:default profili için kimlik bilgisi bulunamadı" ne anlama gelir?
anthropic:default kimlik doğrulama profili kimliğini kullanmaya çalıştığı, ancak beklenen kimlik doğrulama deposunda bunun için kimlik bilgisi bulamadığı anlamına gelir.Düzeltme kontrol listesi:- Kimlik doğrulama profillerinin nerede bulunduğunu doğrulayın (yeni ve eski yollar)
- Geçerli:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - Eski:
~/.openclaw/agent/*(openclaw doctortarafından geçirilir)
- Geçerli:
- Ortam değişkeninizin Gateway tarafından yüklendiğini doğrulayın
- Kabuğunuzda
ANTHROPIC_API_KEYayarladıysanız ancak Gateway’i systemd/launchd üzerinden çalıştırıyorsanız bunu devralmayabilir.~/.openclaw/.enviçine koyun veyaenv.shellEnvdeğerini etkinleştirin.
- Kabuğunuzda
- Doğru ajanı düzenlediğinizden emin olun
- Çok ajanlı kurulumlar birden fazla
auth-profiles.jsondosyası olabileceği anlamına gelir.
- Çok ajanlı kurulumlar birden fazla
- Model/kimlik doğrulama durumunu makul şekilde kontrol edin
- Yapılandırılmış modelleri ve sağlayıcıların kimlik doğrulamasının yapılıp yapılmadığını görmek için
openclaw models statuskullanın.
- Yapılandırılmış modelleri ve sağlayıcıların kimlik doğrulamasının yapılıp yapılmadığını görmek için
-
Claude CLI kullanın
- Gateway ana makinesinde
openclaw models auth login --provider anthropic --method cli --set-defaultçalıştırın.
- Gateway ana makinesinde
-
Bunun yerine bir API anahtarı kullanmak istiyorsanız
-
ANTHROPIC_API_KEYdeğerini gateway ana makinesinde~/.openclaw/.enviçine koyun. -
Eksik profili zorlayan sabitlenmiş sıraları temizleyin:
-
-
Komutları gateway ana makinesinde çalıştırdığınızı doğrulayın
- Uzak modda kimlik doğrulama profilleri dizüstü bilgisayarınızda değil gateway makinesinde bulunur.
Neden Google Gemini'yi de deneyip başarısız oldu?
Neden Google Gemini'yi de deneyip başarısız oldu?
No API key found for provider "google" görürsünüz.Düzeltme: Google kimlik doğrulaması sağlayın veya yedeğin oraya yönlenmemesi için agents.defaults.model.fallbacks / takma adlar içinden Google modellerini kaldırın/kaçının.LLM isteği reddedildi: düşünme imzası gerekli (Google Antigravity)Neden: oturum geçmişi imzasız düşünme blokları içeriyor (çoğu zaman
iptal edilmiş/kısmi bir akıştan). Google Antigravity düşünme blokları için imza gerektirir.Düzeltme: OpenClaw artık Google Antigravity Claude için imzasız düşünme bloklarını çıkarır. Hâlâ görünüyorsa yeni bir oturum başlatın veya o ajan için /thinking off ayarlayın.Kimlik doğrulama profilleri: nedir ve nasıl yönetilir?
İlgili: /concepts/oauth (OAuth akışları, token saklama, çok hesaplı kalıplar)Kimlik doğrulama profili nedir?
Kimlik doğrulama profili nedir?
openclaw models auth list çalıştırın (isteğe bağlı olarak --provider <id> veya --json). Ayrıntılar için Modeller CLI bölümüne bakın.Tipik profil kimlikleri nelerdir?
Tipik profil kimlikleri nelerdir?
anthropic:default(e-posta kimliği olmadığında yaygındır)- OAuth kimlikleri için
anthropic:<email> - Seçtiğiniz özel kimlikler (ör.
anthropic:work)
Önce hangi kimlik doğrulama profilinin deneneceğini kontrol edebilir miyim?
Önce hangi kimlik doğrulama profilinin deneneceğini kontrol edebilir miyim?
auth.order.<provider>) destekler. Bu gizli bilgileri saklamaz; kimlikleri sağlayıcı/mod ile eşler ve rotasyon sırasını ayarlar.OpenClaw, kısa bir bekleme süresinde (hız sınırları/zaman aşımları/kimlik doğrulama hataları) veya daha uzun bir devre dışı durumda (faturalandırma/yetersiz kredi) olan profili geçici olarak atlayabilir. Bunu incelemek için openclaw models status --json çalıştırın ve auth.unusableProfiles değerini kontrol edin. Ayarlama: auth.cooldowns.billingBackoffHours*.Hız sınırı bekleme süreleri model kapsamlı olabilir. Bir model için bekleme süresinde
olan profil aynı sağlayıcıdaki kardeş model için hâlâ kullanılabilir olabilir,
faturalandırma/devre dışı pencereleri ise tüm profili engellemeye devam eder.CLI üzerinden ajan başına bir sıra geçersiz kılması da ayarlayabilirsiniz (o ajanın auth-state.json dosyasında saklanır):excluded_by_auth_order bildirir.OAuth ile API anahtarı arasındaki fark nedir?
OAuth ile API anahtarı arasındaki fark nedir?
- OAuth / CLI oturumu açma, sağlayıcının desteklediği yerlerde genellikle abonelik erişiminden
yararlanır. Anthropic için OpenClaw’ın Claude CLI arka ucu
Claude Code
claude -pkullanır; Anthropic şu anda bunu Agent SDK/programatik kullanım olarak değerlendirir. Anthropic, 15 Haziran 2026 tarihli ayrı Agent SDK kredi değişikliğini duraklattı; bu nedenle şimdilik bu hâlâ abonelik kullanım sınırlarından düşer. Güncel duraklatma bildirimi için Anthropic’in Agent SDK plan makalesine bakın. - API anahtarları token başına ödeme faturalandırması kullanır.