--- read_when: - Varsayılan modelleri değiştirmek veya sağlayıcı kimlik doğrulama durumunu görüntülemek istiyorsunuz - Kullanılabilir modelleri/sağlayıcıları taramak ve kimlik doğrulama profillerinde hata ayıklamak istiyorsunuz summary: '`openclaw models` için CLI başvurusu (status/list/set/scan, takma adlar, geri dönüşler, kimlik doğrulama)' title: Modeller x-i18n: generated_at: "2026-06-28T00:23:11Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 15d0a01e0f8f971996359413306a1c694e5a787eaef69b13eb8ac63c2a7c8990 source_path: cli/models.md workflow: 16 --- # `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](/tr/providers/models) - Model seçimi kavramları + `/models` slash komutu: [Modeller kavramı](/tr/concepts/models) - Sağlayıcı kimlik doğrulama kurulumu: [Başlarken](/tr/start/getting-started) ## Yaygın komutlar ```bash openclaw models status openclaw models list openclaw models set 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 ` 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](/tr/providers/openai#check-and-recover-codex-oauth-routing). Notlar: - `models set `, `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 `, 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 `, `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()` 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 ` - `--max-age-days ` - `--provider ` - `--max-candidates ` - `--timeout ` (katalog isteği ve prob başına zaman aşımı) - `--concurrency ` - `--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 ` (bir sağlayıcıyı yokla) - `--probe-profile ` (tekrarlanan veya virgülle ayrılmış profil kimlikleri) - `--probe-timeout ` - `--probe-concurrency ` - `--probe-max-tokens ` - `--agent ` (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.` 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 ```bash openclaw models aliases list openclaw models fallbacks list ``` ## Kimlik doğrulama profilleri ```bash openclaw models auth add openclaw models auth list [--provider ] [--json] openclaw models auth login --provider openclaw models auth login --provider openai --profile-id openai:work openclaw models auth paste-api-key --provider openclaw models auth setup-token --provider 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 `, 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 ` 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: ```bash openclaw models auth login --provider openai --set-default openclaw models auth login --provider openai --method api-key openclaw models auth paste-api-key --provider openai openclaw 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 ` 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 `: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 `: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 `, `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ı](/tr/cli) - [Model seçimi](/tr/concepts/model-providers) - [Model yedeklemeye geçiş](/tr/concepts/model-failover)