Modeller CLI'si

Bir model başvurusu (provider/model), düşük seviyeli agent çalışma zamanını değil, bir sağlayıcı ve model seçer. Çalışma zamanı ilkesi ayarlanmamışken veya auto iken, OpenAI'ın sağlayıcıya ait rota ilkesi 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 seçebilir; yalnızca openai/* ön eki Codex'i hiçbir zaman seçmez. Completions bağdaştırıcıları, özel uç noktalar ve yazılmış istek davranışı OpenClaw üzerinde kalır. Düz metin kullanan resmî HTTP uç noktaları reddedilir. Bkz. OpenAI örtük agent çalışma zamanı.

Abonelik Copilot başvuruları (github-copilot/*) haricî GitHub Copilot agent çalışma zamanı Plugin'ine dâhil edilebilir, ancak bu yol her zaman açıkça belirtilir (auto tarafından hiçbir zaman seçilmez). Çalışma zamanı geçersiz kılmaları, agent'ın veya oturumun tamamında değil, sağlayıcı/model ilkesinde yer alır. Çalışma zamanı seçimi faturalandırmayı belirlemez: OpenAI API anahtarı ile ChatGPT/Codex abonelik kimlik bilgileri birbirinden ayrı kalır. Bkz. Agent çalışma zamanları ve GitHub Copilot agent çalışma zamanı.

Seçim sırası

İlgili model yapılandırma yüzeyleri:

• agents.defaults.models, takma adları ve model başına ayarları depolar. Bir girdi eklemek model geçersiz kılmalarını kısıtlamaz.
• agents.defaults.modelPolicy.allow, isteğe bağlı geçersiz kılma izin listesidir. Tam başvuruları veya provider/* ve provider/namespace/* gibi sonda yer alan ön ek joker karakterlerini kullanın; herhangi bir modele izin vermek için bunu atlayın veya [] olarak ayarlayın. Agent başına agents.entries.*.modelPolicy.allow, söz konusu agent için varsayılan ilkenin yerini alır.
• agents.defaults.utilityModel; oluşturulan pano oturumu başlıkları, desteklenen kanal ileti dizisi/konu başlıkları ve ilerleme anlatımı gibi kısa dâhilî görevler için isteğe bağlı, daha düşük maliyetli bir modeldir. Agent başına agents.entries.*.utilityModel bunu geçersiz kılar. Ayarlanmadığında OpenClaw, varsa birincil sağlayıcının bildirdiği küçük model varsayılanını (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5), aksi takdirde agent'ın birincil modelini kullanır; yardımcı yönlendirmeyi devre dışı bırakmak için bunu boş bir dizeye ayarlayın. Farklı bir yardımcı model başarısız olduğunda oluşturulan başlıklar birincil modelle bir kez daha denenir. Pano başlıklarında otomatik yardımcı türetme ve normal geri dönüş, etkin oturum sağlayıcısını ve kimlik doğrulama profilini izler; açıkça belirtilen yardımcı model ise yapılandırılmış sağlayıcısını/kimlik doğrulamasını korur. Boş bir yardımcı model, pano başlığı oluşturmayı değil, yalnızca alternatif küçük model rotasını atlar. Yardımcı görevler ayrı model çağrılarıdır ve seçilen model sağlayıcısına sınırlandırılmış görev içeriği gönderebilir.
• agents.defaults.imageModel, yalnızca birincil model görüntüleri kabul edemediğinde kullanılır.
• agents.defaults.pdfModel, pdf aracı tarafından kullanılır. Ayarlanmamışsa araç önce imageModel, ardından çözümlenen oturum/varsayılan modele geri döner.
• agents.defaults.mediaModels.{image,music,video}, paylaşılan medya oluşturma araçlarını destekler. Ayarlanmamışsa her araç, kimlik doğrulama destekli bir sağlayıcı varsayılanını çıkarır: önce geçerli varsayılan sağlayıcı, ardından bu yetenek için kayıtlı kalan sağlayıcılar sağlayıcı kimliği sırasıyla kullanılır. Sağlayıcılar arası geri dönüş, sabit varsayılan davranıştır.
• Agent başına agents.entries.*.model (ve bağlamalar), agents.defaults.model değerini geçersiz kılar — bkz. Çok agent'lı yönlendirme.

Anahtarların tam başvurusu, varsayılanlar ve JSON5 örnekleri: Yapılandırma başvurusu.

Seçim kaynağı ve geri dönüş katılığı

Aynı provider/model, nereden geldiğine bağlı olarak farklı davranır:

Diğer seçim kuralları:

• agents.defaults.model.primary değerini değiştirmek mevcut oturum sabitlemelerini yeniden yazmaz. Durum This session is pinned to X; config primary Y will apply to new/unpinned sessions. bildiriyorsa sabitlemeyi temizlemek için /model default çalıştırın.
• CLI varsayılan model ve izin listesi seçicileri, yerleşik kataloğun tamamı yerine yalnızca models.providers.*.models öğesini listeleyerek models.mode: "replace" değerine uyar.
• Control UI model seçici, yapılandırılmış model görünümünü Gateway'den ister. Açıkça belirtilmiş bir modelPolicy.allow, sonda yer alan ön ek joker karakteri girdileri de dâhil olmak üzere bunu filtreler; aksi takdirde yapılandırılmış modelleri ve kullanılabilir kimlik doğrulaması olan sağlayıcıları gösterir. Yerleşik kataloğun tamamı, açık gezinme görünümlerine ayrılmıştır (models.list ile view: "all" veya openclaw models list --all).
• Sağlayıcı envanteri kullanıcı arayüzleri, seçici izin listelerini uygulamadan kaynakta tanımlanmış models.providers.*.models satırlarını göstermek için models.list ile view: "provider-config" kullanır.

Tüm işleyiş: Model yük devretme.

Hızlı model ilkesi

• Birincil modelinizi erişebildiğiniz en güçlü, en yeni nesil modele ayarlayın.
• Maliyet/gecikme açısından hassas görevler ve daha düşük önem düzeyindeki sohbetler için geri dönüşleri kullanın.
• Araç etkin agent'lar veya güvenilmeyen girdiler için eski/zayıf model katmanlarından kaçının.

İlk katılım

openclaw onboard

OpenAI Codex aboneliği OAuth'ı ve Anthropic (API anahtarı veya Claude CLI'ı yeniden kullanma) dâhil olmak üzere yaygın sağlayıcılar için yapılandırmayı elle düzenlemeye gerek kalmadan model ve kimlik doğrulamasını ayarlar.

Yapılandırılmış bir birincil model yokken yeni OpenAI API anahtarı kurulumu openai/gpt-5.6 öğesini seçer; yalın doğrudan API kimliği Sol katmanına çözümlenir. Yeni ChatGPT/Codex OAuth kurulumu tam openai/gpt-5.6-sol katalog başvurusunu seçer. Yeniden kimlik doğrulama, openai/gpt-5.5 dâhil olmak üzere mevcut açıkça belirtilmiş birincil modeli korur. GPT-5.6 hesap tarafından kullanılamıyorsa openai/gpt-5.5 öğesini açıkça seçin; OpenClaw bunu sessizce alt sürüme düşürmez.

"Modele izin verilmiyor" (ve yanıtların neden durduğu)

agents.defaults.modelPolicy.allow boş değilse /model, oturum geçersiz kılmaları ve --model için izin listesi hâline gelir. Bu izin listesinin dışındaki bir modelin seçilmesi, normal bir yanıt oluşturulmadan önce sonuç döndürür. Agent başına agents.entries.*.modelPolicy.allow, söz konusu agent için varsayılan ilkenin yerini alır.

"provider/model" model geçersiz kılmasına agents.defaults.modelPolicy.allow tarafından izin verilmiyor.agents.defaults.modelPolicy.allow öğesine "provider/model", "provider/*" veya daha dar bir "provider/namespace/*" ön eki ekleyin ya da herhangi bir modele izin vermek için listeyi kaldırın/boşaltın.

Modeli veya bir sağlayıcı joker karakterini adı belirtilen modelPolicy.allow anahtarına ekleyerek, bu listeyi kaldırarak/boşaltarak ya da /model list içinden bir model seçerek sorunu düzeltin. Reddedilen komut /model openai/gpt-5.5 --runtime codex gibi bir çalışma zamanı geçersiz kılması içeriyorsa önce izin listesini düzeltin, ardından aynı komutu yeniden deneyin.

Yerel/GGUF modellerinde izin listesi, örneğin ollama/gemma4:26b veya lmstudio/Gemma4-26b-a4-it-gguf gibi sağlayıcı ön ekli tam başvuruyu gerektirir — tam dize için openclaw models list --provider <provider> öğesini kontrol edin. İzin listesi etkin olduğunda yalın dosya adları veya görünen adlar yeterli değildir.

Her modeli listelemeden sağlayıcıları sınırlamak için sonda yer alan ön ek joker karakteri girdilerini kullanın. Sağlayıcı genelindeki provider/*, o sağlayıcının altındaki her modelle eşleşir; clawrouter/anthropic/* gibi daha dar bir ön ek yalnızca o ad alanıyla eşleşir:

{  agents: {    defaults: {      modelPolicy: {        allow: ["openai/*", "vllm/*"],      },    },  },}

/model, /models ve model seçiciler daha sonra yalnızca bu sağlayıcılar için keşfedilen kataloğu gösterir ve izin listesi düzenlenmeden yeni modeller görünebilir. Başka bir sağlayıcıdan belirli bir modeli dâhil etmek için tam provider/model girdilerini provider/* girdileriyle karıştırın.

Takma adlar ve model başına ayarlar içeren örnek izin listesi:

{  agents: {    defaults: {      model: { primary: "anthropic/claude-sonnet-4-6" },      modelPolicy: {        allow: ["anthropic/claude-sonnet-4-6", "anthropic/claude-opus-4-6"],      },      models: {        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },        "anthropic/claude-opus-4-6": { alias: "Opus" },      },    },  },}

openclaw config set agents.defaults.modelPolicy.allow '["openai/gpt-5.4","anthropic/*"]' --strict-json

Sohbette /model

/model/model list/model 3/model openai/gpt-5.4/model default/model status

• /model ve /model list, kompakt bir numaralı seçici (model ailesi + kullanılabilir sağlayıcılar) gösterir; /model <#> buradan seçim yapar. Discord'da bu, bir Submit adımıyla sağlayıcı/model açılır listelerini açar; Telegram'da seçici seçimleri oturum kapsamındadır ve aracının openclaw.json içindeki kalıcı varsayılanını asla yeniden yazmaz. /models add kullanımdan kaldırılmıştır ve sohbetten model kaydetmek yerine bir mesaj döndürür.
• /model, yeni oturum seçimini hemen kalıcı hale getirir. Araç boştaysa sonraki çalıştırma bunu hemen kullanır; bir çalıştırma zaten etkinse geçiş, bir sonraki temiz yeniden deneme noktası için (veya araç etkinliği ya da yanıt çıktısı zaten başladıysa daha sonraki bir nokta için) kuyruğa alınır.
• /model default, yapılandırılmış birincili yeniden devralması için oturum seçimini temizler.
• Kullanıcı tarafından seçilen bir /model referansı, söz konusu oturum için katıdır: erişilemez hale gelirse yanıt, agents.defaults.model.fallbacks üzerinden sessizce geri dönüş yapmak yerine görünür biçimde başarısız olur. Yapılandırılmış varsayılanlar ve cron işi birincilleri geri dönüş zincirlerini kullanmaya devam eder.
• /model status ayrıntılı görünümdür: sağlayıcı başına kimlik doğrulama adayları ve (yapılandırıldığında) sağlayıcı uç noktası baseUrl ile api modu.
• Model referansları ilk / üzerinden bölünerek ayrıştırılır; provider/model yazın. Model kimliğinin kendisi / içeriyorsa (OpenRouter tarzı), sağlayıcı ön ekini ekleyin; örneğin /model openrouter/moonshotai/kimi-k2. Sağlayıcıyı belirtmezseniz OpenClaw şunları dener: (1) takma ad eşleşmesi, (2) tam olarak bu ön eksiz model kimliği için benzersiz yapılandırılmış sağlayıcı eşleşmesi, (3) yapılandırılmış varsayılan sağlayıcı (kullanımdan kaldırılmış geri dönüş) — bu sağlayıcı yapılandırılmış varsayılan modeli artık sunmuyorsa, kaldırılmış sağlayıcıya ait eski bir varsayılanın gösterilmesini önlemek için bunun yerine ilk yapılandırılmış sağlayıcı/model.
• Model referansları küçük harfe normalleştirilir; sağlayıcı kimlikleri ise bunun dışında tam eşleşir, bu nedenle plugin tarafından bildirilen kimliği kullanın.

Komutların tam davranışı ve yapılandırma: Eğik çizgi komutları.

CLI

openclaw models statusopenclaw models listopenclaw models set <provider/model>openclaw models set-image <provider/model>openclaw models scanopenclaw models aliases list|add|removeopenclaw models fallbacks list|add|remove|clearopenclaw models image-fallbacks list|add|remove|clearopenclaw models auth list|add|login|paste-api-key|paste-token|setup-token|order

Alt komut olmadan openclaw models, models status için bir kısayoldur; bu komut ayrıca kimlik doğrulama deposu profillerinin OAuth süre sonunu gösterir (varsayılan olarak 24 saat içinde uyarır). Tüm bayraklar, JSON şekilleri ve kimlik doğrulama profili alt komutları: Models CLI başvurusu.

Model kayıt defteri (models.json)

models.providers altında yapılandırılan özel sağlayıcılar, aracı dizini altındaki models.json dosyasına yazılır (varsayılan ~/.openclaw/agents/<agentId>/agent/models.json). Sağlayıcı plugini katalogları, oluşturulan ve pluginin sahip olduğu ayrı katalog parçaları olarak depolanır ve otomatik olarak yüklenir. Bu dosya varsayılan olarak yapılandırmayla birleştirilir; yalnızca yapılandırdığınız sağlayıcıları kullanmak için models.mode: "replace" ayarlayın.

İşaretçilerin kalıcılaştırılmasında kaynak belirleyicidir: OpenClaw, models.json dosyasını her yeniden oluşturduğunda — openclaw agent gibi komutla yönlendirilen yollar dâhil — işaretçileri çözümlenmiş çalışma zamanı gizli değerlerinden değil, etkin kaynak yapılandırma anlık görüntüsünden (çözümleme öncesi) yazar.

İlgili

• Aracı çalışma zamanları — OpenClaw, Codex ve diğer aracı döngüsü çalışma zamanları
• Yapılandırma başvurusu — model yapılandırma anahtarları
• Görüntü oluşturma — görüntü modeli yapılandırması
• Model yük devretmesi — geri dönüş zincirleri
• Model sağlayıcıları — sağlayıcı yönlendirmesi ve kimlik doğrulama
• Models CLI başvurusu — tüm komut ve bayrak başvurusu
• Müzik oluşturma — müzik modeli yapılandırması
• Video oluşturma — video modeli yapılandırması