openclaw models

Model keşfi, tarama ve yapılandırma (varsayılan model, yedekler, kimlik doğrulama profilleri).

İlgili:

• Sağlayıcılar + modeller: Modeller
• Model seçimi kavramları + /models slash komutu: Modeller kavramı
• Sağlayıcı kimlik doğrulama kurulumu: Başlarken

Yaygın komutlar

openclaw models statusopenclaw models listopenclaw models set <model-or-alias>openclaw models scan

openclaw models status, çözümlenen varsayılanı/yedekleri ve bir kimlik doğrulama genel görünümünü gösterir. Sağlayıcı kullanım anlık görüntüleri kullanılabilir olduğunda, OAuth/API anahtarı durumu bölümü sağlayıcı kullanım pencerelerini ve kota anlık görüntülerini içerir. Geçerli kullanım penceresi sağlayıcıları: Anthropic, GitHub Copilot, Gemini CLI, OpenAI, MiniMax, Xiaomi ve z.ai. Kullanım kimlik doğrulaması, kullanılabildiğinde sağlayıcıya özgü kancalardan gelir; aksi halde OpenClaw, kimlik doğrulama profillerinden, env'den veya config'den eşleşen OAuth/API anahtarı kimlik bilgilerine geri döner. --json çıktısında, auth.providers env/config/store farkındalıklı sağlayıcı genel görünümüdür; auth.oauth ise yalnızca auth-store profil sağlığıdır. Yapılandırılan her sağlayıcı profiline karşı canlı kimlik doğrulama probları çalıştırmak için --probe ekleyin. Problar gerçek isteklerdir (token tüketebilir ve hız sınırlarını tetikleyebilir). Yapılandırılmış bir ajanın model/kimlik doğrulama durumunu incelemek için --agent <id> kullanın. Atlandığında, komut ayarlanmışsa OPENCLAW_AGENT_DIR kullanır; aksi halde yapılandırılmış varsayılan ajanı kullanır. Prob satırları kimlik doğrulama profillerinden, env kimlik bilgilerinden veya models.json içinden gelebilir. OpenAI ChatGPT/Codex OAuth sorun giderme için openclaw models status, openclaw models auth list --provider openai ve openclaw config get agents.defaults.model --json, bir ajanın yerel Codex çalışma zamanı üzerinden openai/* için kullanılabilir bir openai OAuth profiline sahip olup olmadığını doğrulamanın en hızlı yoludur. Bkz. OpenAI sağlayıcı kurulumu.

Notlar:

• models set <model-or-alias>, provider/model veya bir alias kabul eder.
• models list salt okunurdur: config, kimlik doğrulama profilleri, mevcut katalog durumu ve sağlayıcıya ait katalog satırlarını okur, ancak models.json dosyasını yeniden yazmaz.
• Auth sütunu sağlayıcı düzeyindedir ve salt okunurdur. Yerel kimlik doğrulama profili meta verilerinden, env işaretleyicilerinden, yapılandırılmış sağlayıcı anahtarlarından, yerel sağlayıcı işaretleyicilerinden, AWS Bedrock env/profil işaretleyicilerinden ve Plugin sentetik kimlik doğrulama meta verilerinden hesaplanır; sağlayıcı çalışma zamanını yüklemez, keychain sırlarını okumaz, sağlayıcı API'lerini çağırmaz veya model başına kesin yürütme hazır olma durumunu kanıtlamaz.
• models list --all --provider <id>, henüz o sağlayıcıyla kimlik doğrulaması yapmamış olsanız bile Plugin manifestlerinden veya paketlenmiş sağlayıcı katalog meta verilerinden sağlayıcıya ait statik katalog satırlarını içerebilir. Bu satırlar, eşleşen kimlik doğrulama yapılandırılana kadar yine de kullanılamaz olarak görünür.
• models list, sağlayıcı katalog keşfi yavaş olduğunda kontrol düzlemini yanıt verebilir tutar. Varsayılan ve yapılandırılmış görünümler, kısa bir beklemeden sonra yapılandırılmış veya sentetik model satırlarına geri döner ve keşfin arka planda tamamlanmasına izin verir. Tam olarak keşfedilmiş kataloğun tamamına ihtiyacınız olduğunda ve sağlayıcı keşfini beklemeye razı olduğunuzda --all kullanın.
• Geniş models list --all, sağlayıcı çalışma zamanı ek kancalarını yüklemeden manifest katalog satırlarını kayıt satırlarının üzerine birleştirir. Sağlayıcı filtreli manifest hızlı yolları yalnızca static olarak işaretlenen sağlayıcıları kullanır; refreshable olarak işaretlenen sağlayıcılar kayıt/cache destekli kalır ve manifest satırlarını ekler olarak eklerken, runtime olarak işaretlenen sağlayıcılar kayıt/çalışma zamanı keşfinde kalır.
• models list, yerel model meta verilerini ve çalışma zamanı sınırlarını ayrı tutar. Tablo çıktısında, etkin bir çalışma zamanı sınırı yerel bağlam penceresinden farklı olduğunda Ctx contextTokens/contextWindow gösterir; JSON satırları, bir sağlayıcı bu sınırı açığa çıkardığında contextTokens içerir.
• models list --provider <id>, moonshot veya openai gibi sağlayıcı kimliğine göre filtreler. Etkileşimli sağlayıcı seçicilerinden gelen Moonshot AI gibi görüntü etiketlerini kabul etmez.
• Model başvuruları ilk / üzerinden bölünerek ayrıştırılır. Model kimliği / içeriyorsa (OpenRouter tarzı), sağlayıcı önekini ekleyin (örnek: openrouter/moonshotai/kimi-k2).
• Sağlayıcıyı atlarsanız, OpenClaw girdiyi önce alias olarak, ardından bu tam model kimliği için benzersiz bir yapılandırılmış sağlayıcı eşleşmesi olarak çözer ve ancak bundan sonra yapılandırılmış varsayılan sağlayıcıya bir kullanımdan kaldırma uyarısıyla geri döner. Bu sağlayıcı artık yapılandırılmış varsayılan modeli açığa çıkarmıyorsa, OpenClaw eski bir kaldırılmış sağlayıcı varsayılanı göstermek yerine ilk yapılandırılmış sağlayıcı/modele geri döner.
• models status, kimlik doğrulama çıktısında gizli olmayan yer tutucular için (örneğin OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) bunları sır olarak maskelemek yerine marker(<value>) gösterebilir.

Modelleri tarama

models scan, OpenRouter'ın herkese açık :free kataloğunu okur ve adayları yedek kullanım için sıralar. Kataloğun kendisi herkese açık olduğundan, yalnızca meta veri taramaları bir OpenRouter anahtarı gerektirmez.

Varsayılan olarak OpenClaw, canlı model çağrılarıyla araç ve görüntü desteğini yoklamaya çalışır. Hiçbir OpenRouter anahtarı yapılandırılmamışsa komut yalnızca meta veri çıktısına geri döner ve :free modellerinin problar ve çıkarım için yine de OPENROUTER_API_KEY gerektirdiğini açıklar.

Seçenekler:

• --no-probe (yalnızca meta veri; config/sırlar araması yok)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (katalog isteği ve prob başına zaman aşımı)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

--set-default ve --set-image canlı problar gerektirir; yalnızca meta veri taraması sonuçları bilgilendirme amaçlıdır ve config'e uygulanmaz.

Modeller durumu

Seçenekler:

• --json
• --plain
• --check (çıkış 1=süresi dolmuş/eksik, 2=süresi dolmak üzere)
• --probe (yapılandırılmış kimlik doğrulama profillerinin canlı probu)
• --probe-provider <name> (bir sağlayıcıyı yokla)
• --probe-profile <id> (tekrarlanan veya virgülle ayrılmış profil kimlikleri)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (yapılandırılmış ajan kimliği; OPENCLAW_AGENT_DIR değerini geçersiz kılar)

--json, stdout'u JSON yükü için ayrılmış tutar. Kimlik doğrulama profili, sağlayıcı ve başlangıç tanılamaları stderr'e yönlendirilir; böylece betikler stdout'u doğrudan jq gibi araçlara pipe edebilir.

Prob durumu grupları:

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

Beklenebilecek prob ayrıntı/neden kodu durumları:

• excluded_by_auth_order: depolanmış bir profil vardır, ancak açık auth.order.<provider> onu atlamıştır; bu nedenle prob, denemek yerine dışlamayı bildirir.
• missing_credential, invalid_expires, expired, unresolved_ref: profil mevcut ancak uygun/çözümlenebilir değil.
• no_model: sağlayıcı kimlik doğrulaması vardır, ancak OpenClaw bu sağlayıcı için yoklanabilir bir model adayı çözememiştir.

Alias'lar + yedekler

openclaw models aliases listopenclaw models fallbacks list

Kimlik doğrulama profilleri

openclaw models auth addopenclaw models auth list [--provider <id>] [--json]openclaw models auth login --provider <id>openclaw models auth login --provider openai --profile-id openai:workopenclaw models auth paste-api-key --provider <id>openclaw models auth setup-token --provider <id>openclaw models auth paste-token

models auth add, etkileşimli kimlik doğrulama yardımcısıdır. Seçtiğiniz sağlayıcıya bağlı olarak bir sağlayıcı kimlik doğrulama akışı (OAuth/API anahtarı) başlatabilir veya sizi manuel token yapıştırmaya yönlendirebilir.

models auth list, seçilen ajan için kaydedilmiş kimlik doğrulama profillerini token, API anahtarı veya OAuth sır materyali yazdırmadan listeler. openai gibi tek bir sağlayıcıya filtrelemek için --provider <id>, betikleme için --json kullanın.

models auth login, bir sağlayıcı Plugin'inin kimlik doğrulama akışını (OAuth/API anahtarı) çalıştırır. Hangi sağlayıcıların yüklü olduğunu görmek için openclaw plugins list kullanın. Kimlik doğrulama sonuçlarını belirli bir yapılandırılmış ajan deposuna yazmak için openclaw models auth --agent <id> <subcommand> kullanın. Üst --agent bayrağı add, list, login, paste-api-key, setup-token, paste-token ve login-github-copilot tarafından dikkate alınır.

OpenAI modelleri için --provider openai varsayılan olarak ChatGPT/Codex hesap girişini kullanır. Yalnızca genellikle Codex abonelik sınırları için yedek olarak bir OpenAI API anahtarı profili eklemek istediğinizde --method api-key kullanın. Eski legacy OpenAI Codex önek kimlik doğrulama/profil durumunu openai değerine taşımak için openclaw doctor --fix çalıştırın.

Örnekler:

openclaw models auth login --provider openai --set-defaultopenclaw models auth login --provider openai --method api-keyopenclaw models auth paste-api-key --provider openaiopenclaw models auth list --provider openai

Notlar:

• login, oturum açma sırasında adlandırılmış profilleri destekleyen sağlayıcılar için --profile-id <id> kabul eder. Bunu aynı sağlayıcı için birden fazla oturum açmayı ayrı tutmak için kullanın.
• paste-api-key, başka yerde oluşturulmuş API anahtarlarını kabul eder, anahtar değerini sorar ve --profile-id geçmediğiniz sürece varsayılan profil kimliği <provider>:manual içine yazar. Otomasyonda anahtarı stdin'e pipe edin, örneğin printf "%s\n" "$OPENAI_API_KEY" | openclaw models auth paste-api-key --provider openai.
• setup-token ve paste-token, token kimlik doğrulama yöntemleri açığa çıkaran sağlayıcılar için genel token komutları olarak kalır.
• setup-token, etkileşimli bir TTY gerektirir ve sağlayıcının token kimlik doğrulama yöntemini çalıştırır (sağlayıcı açığa çıkarıyorsa varsayılan olarak o sağlayıcının setup-token yöntemini kullanır).
• paste-token, başka yerde veya otomasyondan oluşturulmuş bir token dizesini kabul eder.
• paste-token, --provider gerektirir, varsayılan olarak token değerini sorar ve --profile-id geçmediğiniz sürece varsayılan profil kimliği <provider>:manual içine yazar.
• Otomasyonda, sağlayıcı kimlik bilgilerinin shell geçmişinde veya süreç listelerinde görünmemesi için token'ı argüman olarak geçirmek yerine stdin'e pipe edin.
• paste-token --expires-in <duration>, 365d veya 12h gibi göreli bir süreden mutlak bir token sona erme zamanı depolar.
• openai için OpenAI API anahtarları ve ChatGPT/OAuth token materyali farklı kimlik doğrulama şekilleridir. sk-... OpenAI API anahtarları için paste-api-key, yalnızca token kimlik doğrulama materyali için paste-token kullanın.
• Anthropic notu: Anthropic personeli bize OpenClaw tarzı Claude CLI kullanımına yeniden izin verildiğini söyledi; bu nedenle OpenClaw, Anthropic yeni bir politika yayımlamadıkça bu entegrasyon için Claude CLI yeniden kullanımını ve claude -p kullanımını onaylanmış kabul eder.
• Anthropic setup-token / paste-token, desteklenen bir OpenClaw token yolu olarak kullanılabilir kalır, ancak OpenClaw artık kullanılabilir olduğunda Claude CLI yeniden kullanımını ve claude -p tercih eder.

İlgili

• CLI referansı
• Model seçimi
• Model yedeklemeye geçiş