Modeller CLI

Model ref'leri bir sağlayıcı ve model seçer. Genellikle düşük seviyeli ajan çalışma zamanını seçmezler. Örneğin openai/gpt-5.5, agents.defaults.agentRuntime.id değerine bağlı olarak normal OpenAI sağlayıcı yolu üzerinden veya Codex uygulama sunucusu çalışma zamanı üzerinden çalışabilir. Codex çalışma zamanı modunda openai/gpt-* ref'i API anahtarı faturalandırması anlamına gelmez; auth bir Codex hesabından veya openai-codex auth profilinden gelebilir. Bkz. Ajan çalışma zamanları.

# Model seçimi nasıl çalışır?

OpenClaw modelleri şu sırayla seçer:

# Seçim kaynağı ve fallback davranışı

Aynı provider/model, nereden geldiğine bağlı olarak farklı şeyler ifade edebilir:

• Yapılandırılmış varsayılanlar (agents.defaults.model.primary ve ajana özgü birinciller) normal başlangıç noktasıdır ve agents.defaults.model.fallbacks kullanır.
• Otomatik fallback seçimleri geçici kurtarma durumudur. Sonraki turların önce kötü olduğu bilinen bir birincili yoklamadan fallback zincirini kullanmaya devam edebilmesi için modelOverrideSource: "auto" ile saklanırlar.
• Kullanıcı oturumu seçimleri kesindir. /model, model seçici, session_status(model=...) ve sessions.patch, modelOverrideSource: "user" saklar; seçilen sağlayıcı/model erişilemez durumdaysa OpenClaw başka bir yapılandırılmış modele düşmek yerine görünür şekilde başarısız olur.
• Cron --model / payload model, iş başına bir birincildir. İş açık payload fallbacks sağlamadıkça yapılandırılmış fallback'leri kullanmaya devam eder (katı bir cron çalıştırması için fallbacks: [] kullanın).
• CLI varsayılan model ve izin listesi seçicileri, tam yerleşik kataloğu yüklemek yerine açık models.providers.*.models listelenerek models.mode: "replace" değerine uyar.
• Control UI model seçici, Gateway'den yapılandırılmış model görünümünü ister: varsa agents.defaults.models, aksi halde açık models.providers.*.models ve kullanılabilir auth'a sahip sağlayıcılar. Tam yerleşik katalog, view: "all" ile models.list veya openclaw models list --all gibi açık gezinti görünümleri için ayrılmıştır.

# Hızlı model politikası

• Birincil modelinizi erişiminiz olan en güçlü son nesil modele ayarlayın.
• Maliyet/gecikmeye duyarlı görevler ve daha düşük riskli sohbet için fallback'ler kullanın.
• Araç etkin ajanlar veya güvenilmeyen girdiler için eski/zayıf model katmanlarından kaçının.

# Onboarding (önerilir)

Config dosyasını elle düzenlemek istemiyorsanız onboarding'i çalıştırın:

openclaw onboard

OpenAI Code (Codex) aboneliği (OAuth) ve Anthropic (API anahtarı veya Claude CLI) dahil yaygın sağlayıcılar için model + auth kurabilir.

# Config anahtarları (genel bakış)

• agents.defaults.model.primary ve agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary ve agents.defaults.imageModel.fallbacks
• agents.defaults.pdfModel.primary ve agents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary ve agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary ve agents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models (izin listesi + alias'lar + sağlayıcı parametreleri)
• models.providers (models.json içine yazılan özel sağlayıcılar)

# Güvenli izin listesi düzenlemeleri

agents.defaults.models değerini elle güncellerken eklemeli yazımlar kullanın:

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

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

agents.defaults.models ayarlanırsa /model ve oturum geçersiz kılmaları için izin listesi haline gelir. Kullanıcı bu izin listesinde olmayan bir model seçtiğinde OpenClaw şunu döndürür:

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

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ı /model ... --runtime ... komutunu yeniden deneyin. Yerel Codex yürütmesi için seçilen model hâlâ openai/gpt-5.5 olur; codex çalışma zamanı harness'i seçer ve Codex auth'unu ayrı olarak kullanır.

Yerel/GGUF modeller için izin listesinde sağlayıcı önekli tam ref'i saklayın; örneğin ollama/gemma4:26b, lmstudio/Gemma4-26b-a4-it-gguf veya openclaw models list --provider <provider> tarafından gösterilen tam sağlayıcı/model. İzin listesi etkinken yalın yerel dosya adları veya görünen adlar yeterli değildir.

Örnek izin listesi config'i:

{
  agent: {
    model: { primary: "anthropic/claude-sonnet-4-6" },
    models: {
      "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
      "anthropic/claude-opus-4-6": { alias: "Opus" },
    },
  },
}

# Sohbette model değiştirme (/model)

Yeniden başlatmadan mevcut oturum için model değiştirebilirsiniz:

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

Tam komut davranışı/config: Slash komutları.

# CLI komutları

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

openclaw models (alt komut yok) models status için bir kısayoldur.

# models list

Varsayılan olarak yapılandırılmış/kimlik doğrulaması kullanılabilir modelleri gösterir. Faydalı bayraklar:

--allboolean

Tam katalog. Kimlik doğrulaması yapılandırılmadan önce paketlenmiş, sağlayıcıya ait statik katalog satırlarını içerir; böylece yalnızca keşif amaçlı görünümler, eşleşen sağlayıcı kimlik bilgilerini ekleyene kadar kullanılamayan modelleri gösterebilir.

--localboolean

Yalnızca yerel sağlayıcılar.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcHJvdmlkZXIgPGlk " type="string"> Sağlayıcı kimliğine göre filtrele, örneğin moonshot. Etkileşimli seçicilerdeki görüntü etiketleri kabul edilmez.

--plainboolean

Her satırda bir model.

--jsonboolean

Makine tarafından okunabilir çıktı.

# models status

Çözümlenen birincil modeli, yedekleri, görüntü modelini ve yapılandırılmış sağlayıcıların kimlik doğrulaması özetini gösterir. Ayrıca kimlik doğrulaması deposunda bulunan profiller için OAuth süre sonu durumunu da gösterir (varsayılan olarak 24 saat içinde uyarır). --plain yalnızca çözümlenen birincil modeli yazdırır.

Örnek (Claude CLI):

claude auth login
openclaw models status

# Tarama (OpenRouter ücretsiz modelleri)

openclaw models scan, OpenRouter'ın ücretsiz model kataloğunu inceler ve isteğe bağlı olarak modelleri araç ve görüntü desteği için problayabilir.

--no-probeboolean

Canlı probları atla (yalnızca meta veriler).

"--min-params

"--max-age-days

"--provider

"--max-candidates

--set-defaultboolean

agents.defaults.model.primary değerini ilk seçime ayarla.

--set-imageboolean

agents.defaults.imageModel.primary değerini ilk görüntü seçimine ayarla.

Tarama sonuçları şuna göre sıralanır:

1. Görüntü desteği
2. Araç gecikmesi
3. Bağlam boyutu
4. Parametre sayısı

Girdi:

• OpenRouter /models listesi (:free filtresi)
• Canlı problar, kimlik doğrulaması profillerinden veya OPENROUTER_API_KEY üzerinden OpenRouter API anahtarı gerektirir (bkz. Ortam değişkenleri)
• İsteğe bağlı filtreler: --max-age-days, --min-params, --provider, --max-candidates
• İstek/prob denetimleri: --timeout, --concurrency

Canlı problar bir TTY içinde çalıştığında, yedekleri etkileşimli olarak seçebilirsiniz. Etkileşimsiz modda varsayılanları kabul etmek için --yes iletin. Yalnızca meta veri sonuçları bilgilendirme amaçlıdır; OpenClaw'ın kullanılamaz, anahtarsız bir OpenRouter modeli yapılandırmaması için --set-default ve --set-image canlı problar gerektirir.

# Model kayıt defteri (models.json)

models.providers içindeki özel sağlayıcılar, aracı dizini altında models.json dosyasına yazılır (varsayılan ~/.openclaw/agents/<agentId>/agent/models.json). models.mode replace olarak ayarlanmadıkça bu dosya varsayılan olarak birleştirilir.

# İlgili

• Aracı çalışma zamanları — PI, 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 devri — yedek zincirleri
• Model sağlayıcıları — sağlayıcı yönlendirmesi ve kimlik doğrulaması
• Müzik oluşturma — müzik modeli yapılandırması
• Video oluşturma — video modeli yapılandırması