> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SSS: modeller ve kimlik doğrulama

Model ve kimlik doğrulama profili SSS. Kurulum, oturumlar, gateway, kanallar ve
sorun giderme için ana [SSS](/tr/help/faq) bölümüne bakın.

## Modeller: varsayılanlar, seçim, takma adlar, geçiş

<AccordionGroup>
  <Accordion title="“Varsayılan model” nedir?">
    OpenClaw’ın varsayılan modeli, şurada ayarladığınız değerdir:

    ```
    agents.defaults.model.primary
    ```

    Modeller `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.
  </Accordion>

  <Accordion title="Hangi modeli önerirsiniz?">
    **Önerilen varsayılan:** sağlayıcı yığınınızda mevcut olan en güçlü en yeni nesil modeli kullanın.
    **Araç etkinleştirilmiş veya güvenilmeyen girdi alan ajanlar için:** maliyet yerine model gücüne öncelik verin.
    **Rutin/düşük riskli sohbet için:** daha ucuz yedek modeller kullanın ve ajan rolüne göre yönlendirin.

    MiniMax’in kendi dokümanları vardır: [MiniMax](/tr/providers/minimax) ve
    [Yerel modeller](/tr/gateway/local-models).

    Genel kural: yüksek riskli işler için **karşılayabileceğiniz en iyi modeli**, rutin sohbet veya özetler için daha ucuz
    bir modeli kullanın. Modelleri ajan başına yönlendirebilir ve uzun görevleri
    paralelleştirmek için alt ajanlar kullanabilirsiniz (her alt ajan token tüketir). Bkz. [Modeller](/tr/concepts/models) ve
    [Alt ajanlar](/tr/tools/subagents).

    Güçlü uyarı: daha zayıf/aşırı nicemlenmiş modeller prompt
    injection ve güvenli olmayan davranışlara karşı daha savunmasızdır. Bkz. [Güvenlik](/tr/gateway/security).

    Daha fazla bağlam: [Modeller](/tr/concepts/models).
  </Accordion>

  <Accordion title="Yapılandırmamı silmeden modelleri nasıl değiştiririm?">
    **model komutlarını** kullanın veya yalnızca **model** alanlarını düzenleyin. Tam yapılandırma değişimlerinden kaçının.

    Güvenli seçenekler:

    * 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.json` içinde `agents.defaults.model` değerini düzenleyin

    Tüm yapılandırmayı değiştirmek istemiyorsanız kısmi bir nesneyle `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](/tr/concepts/models), [Yapılandır](/tr/cli/configure), [Yapılandırma](/tr/cli/config), [Doctor](/tr/gateway/doctor).
  </Accordion>

  <Accordion title="Kendi barındırdığım modelleri (llama.cpp, vLLM, Ollama) kullanabilir miyim?">
    Evet. Ollama, yerel modeller için en kolay yoldur.

    En hızlı kurulum:

    1. Ollama’yı `https://ollama.com/download` adresinden yükleyin
    2. `ollama pull gemma4` gibi yerel bir model çekin
    3. Bulut modellerini de istiyorsanız `ollama signin` çalıştırın
    4. `openclaw onboard` çalıştırın ve `Ollama` seçin
    5. `Local` veya `Cloud + Local` seçin

    Notlar:

    * `Cloud + Local` size bulut modellerini ve yerel Ollama modellerinizi verir
    * `kimi-k2.5:cloud` gibi bulut modelleri yerel çekme gerektirmez
    * elle geçiş için `openclaw models list` ve `openclaw models set ollama/<model>` kullanın

    Güvenlik notu: daha küçük veya yoğun biçimde nicemlenmiş modeller prompt
    injection saldırılarına daha savunmasızdır. Araç kullanabilen tüm botlar için **büyük modelleri** önemle öneririz.
    Yine de küçük modeller istiyorsanız, sanal alanı ve sıkı araç izin listelerini etkinleştirin.

    Dokümanlar: [Ollama](/tr/providers/ollama), [Yerel modeller](/tr/gateway/local-models),
    [Model sağlayıcıları](/tr/concepts/model-providers), [Güvenlik](/tr/gateway/security),
    [Sandboxing](/tr/gateway/sandboxing).
  </Accordion>

  <Accordion title="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 status` ile kontrol edin.
    * Güvenlik açısından hassas/araç etkin ajanlar için mevcut en güçlü en yeni nesil modeli kullanın.
  </Accordion>

  <Accordion title="Modelleri anında (yeniden başlatmadan) nasıl değiştiririm?">
    `/model` komutunu tek başına mesaj olarak kullanın:

    ```
    /model sonnet
    /model opus
    /model gpt
    /model gpt-mini
    /model gemini
    /model gemini-flash
    /model gemini-flash-lite
    ```

    Bunlar yerleşik takma adlardır. Özel takma adlar `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 3
    ```

    Sağlayıcı için belirli bir kimlik doğrulama profilini de zorlayabilirsiniz (oturum başına):

    ```
    /model opus@anthropic:default
    /model opus@anthropic:work
    ```

    İpucu: `/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 anthropic/claude-opus-4-6
    ```

    Varsayılana dönmek istiyorsanız, onu `/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.
  </Accordion>

  <Accordion title="İ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](/tr/concepts/models) ve [Model failover](/tr/concepts/model-failover).
  </Accordion>

  <Accordion title="Günlük görevler için GPT 5.5, kodlama için Codex 5.5 kullanabilir miyim?">
    Evet. Model seçimini ve çalışma zamanı seçimini ayrı ele alın:

    * **Yerel Codex kodlama ajanı:** `agents.defaults.model.primary` değerini `openai/gpt-5.5` olarak ayarlayın. ChatGPT/Codex abonelik kimlik doğrulaması istediğinizde `openclaw models auth login --provider openai` ile 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_KEY` yapılandırın.
    * **OpenAI ajan API anahtarı kimlik doğrulaması:** sıralı bir `openai` API anahtarı profiliyle `/model openai/gpt-5.5` kullanın.
    * **Alt ajanlar:** kodlama görevlerini kendi `openai/gpt-5.5` modeline sahip Codex odaklı bir ajana yönlendirin.

    Bkz. [Modeller](/tr/concepts/models) ve [Slash komutları](/tr/tools/slash-commands).
  </Accordion>

  <Accordion title="GPT 5.5 için hızlı modu nasıl yapılandırırım?">
    Oturum geçişi veya yapılandırma varsayılanı kullanın:

    * **Oturum başına:** oturum `openai/gpt-5.5` kullanırken `/fast on` gönderin.
    * **Model başına varsayılan:** `agents.defaults.models["openai/gpt-5.5"].params.fastMode` değerini `true` olarak 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 auto` veya `params.fastMode: "auto"` kullanın. Kesme varsayılan olarak 60 saniyedir; değiştirmek için etkin modelde `params.fastAutoOnSeconds` ayarlayın.

    Örnek:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          models: {
            "openai/gpt-5.5": {
              params: {
                fastMode: "auto",
                fastAutoOnSeconds: 30,
              },
            },
          },
        },
      },
    }
    ```

    OpenAI için hızlı mod, desteklenen yerel Responses isteklerinde `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](/tr/tools/thinking) ve [OpenAI hızlı mod](/tr/providers/openai#fast-mode).
  </Accordion>

  <Accordion title="Neden &#x22;Model ... is not allowed&#x22; 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:

    ```
    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
    ```

    Bu hata normal bir yanıt **yerine** döndürülür. Düzeltme: tam modeli
    `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.
  </Accordion>

  <Accordion title="Neden &#x22;Unknown model: minimax/MiniMax-M3&#x22; görüyorum?">
    Bu, **sağlayıcının yapılandırılmadığı** anlamına gelir (MiniMax sağlayıcı yapılandırması veya kimlik doğrulama
    profili bulunamadı), dolayısıyla model çözümlenemez.

    Düzeltme kontrol listesi:

    1. 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.
    2. 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
       (`minimax` için `MINIMAX_API_KEY`, `minimax-portal` için `MINIMAX_OAUTH_TOKEN` veya saklanan MiniMax
       OAuth).
    3. 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.7` veya
       `minimax/MiniMax-M2.7-highspeed`; OAuth kurulumu için
       `minimax-portal/MiniMax-M3`, `minimax-portal/MiniMax-M2.7` veya
       `minimax-portal/MiniMax-M2.7-highspeed`.
    4. Şunu çalıştırın:

       ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
       openclaw models list
       ```

       ve listeden seçin (veya sohbette `/model list`).

    Bkz. [MiniMax](/tr/providers/minimax) ve [Modeller](/tr/concepts/models).
  </Accordion>

  <Accordion title="MiniMax’i varsayılanım, OpenAI’ı karmaşık görevler için kullanabilir miyim?">
    Evet. Gerektiğinde **oturum başına** model değiştirerek **MiniMax’i varsayılan** olarak kullanın.
    Geri dönüşler “zor görevler” için değil, **hatalar** içindir; bu yüzden `/model` veya ayrı bir ajan kullanın.

    **Seçenek A: oturum başına değiştirin**

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },
      agents: {
        defaults: {
          model: { primary: "minimax/MiniMax-M3" },
          models: {
            "minimax/MiniMax-M3": { alias: "minimax" },
            "openai/gpt-5.5": { alias: "gpt" },
          },
        },
      },
    }
    ```

    Sonra:

    ```
    /model gpt
    ```

    **Seçenek B: ayrı ajanlar**

    * Ajan A varsayılanı: MiniMax
    * Ajan B varsayılanı: OpenAI
    * Ajana göre yönlendirin veya geçiş yapmak için `/agent` kullanın

    Belgeler: [Modeller](/tr/concepts/models), [Çok Ajanlı Yönlendirme](/tr/concepts/multi-agent), [MiniMax](/tr/providers/minimax), [OpenAI](/tr/providers/openai).
  </Accordion>

  <Accordion title="opus / sonnet / gpt yerleşik kısayollar mı?">
    Evet. OpenClaw birkaç varsayılan kısaltmayla gelir (yalnızca model `agents.defaults.models` içinde varsa uygulanır):

    * `opus` → `anthropic/claude-opus-4-8`
    * `sonnet` → `anthropic/claude-sonnet-4-6`
    * `gpt` → `openai/gpt-5.4`
    * `gpt-mini` → `openai/gpt-5.4-mini`
    * `gpt-nano` → `openai/gpt-5.4-nano`
    * `gemini` → `google/gemini-3.1-pro-preview`
    * `gemini-flash` → `google/gemini-3-flash-preview`
    * `gemini-flash-lite` → `google/gemini-3.1-flash-lite`

    Aynı adla kendi takma adınızı ayarlarsanız sizin değeriniz geçerli olur.
  </Accordion>

  <Accordion title="Model kısayollarını (takma adları) nasıl tanımlar/geçersiz kılarım?">
    Takma adlar `agents.defaults.models.<modelId>.alias` değerinden gelir. Örnek:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "anthropic/claude-opus-4-6" },
          models: {
            "anthropic/claude-opus-4-6": { alias: "opus" },
            "anthropic/claude-sonnet-4-6": { alias: "sonnet" },
          },
        },
      },
    }
    ```

    Ardından `/model sonnet` (veya desteklendiğinde `/<alias>`) bu model kimliğine çözümlenir.
  </Accordion>

  <Accordion title="OpenRouter veya Z.AI gibi diğer sağlayıcılardan modelleri nasıl eklerim?">
    OpenRouter (token başına ödeme; çok sayıda model):

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "openrouter/anthropic/claude-sonnet-4-6" },
          models: { "openrouter/anthropic/claude-sonnet-4-6": {} },
        },
      },
      env: { OPENROUTER_API_KEY: "sk-or-..." },
    }
    ```

    Z.AI (GLM modelleri):

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "zai/glm-5" },
          models: { "zai/glm-5": {} },
        },
      },
      env: { ZAI_API_KEY: "..." },
    }
    ```

    Bir sağlayıcıya/modele başvurur ancak gerekli sağlayıcı anahtarı eksikse çalışma zamanı kimlik doğrulama hatası alırsınız (ör. `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/<agentId>/agent/auth-profiles.json
    ```

    Düzeltme seçenekleri:

    * `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` / `token` profillerini 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.
  </Accordion>
</AccordionGroup>

## Model devretmesi ve "Tüm modeller başarısız oldu"

<AccordionGroup>
  <Accordion title="Devretme nasıl çalışır?">
    Devretme iki aşamada gerçekleşir:

    1. Aynı sağlayıcı içinde **kimlik doğrulama profili rotasyonu**.
    2. `agents.defaults.model.fallbacks` içindeki sonraki modele **model yedeği**.

    Başarısız profillere bekleme süreleri uygulanır (üstel geri çekilme), böylece bir sağlayıcı hız sınırına takıldığında veya geçici olarak başarısız olduğunda bile OpenClaw yanıt vermeye devam edebilir.

    Hız sınırı kovası düz `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.
  </Accordion>

  <Accordion title="&#x22;anthropic:default profili için kimlik bilgisi bulunamadı&#x22; ne anlama gelir?">
    Sistemin `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 doctor` tarafından geçirilir)
    * **Ortam değişkeninizin Gateway tarafından yüklendiğini doğrulayın**
      * Kabuğunuzda `ANTHROPIC_API_KEY` ayarladıysanız ancak Gateway'i systemd/launchd üzerinden çalıştırıyorsanız bunu devralmayabilir. `~/.openclaw/.env` içine koyun veya `env.shellEnv` değerini etkinleştirin.
    * **Doğru ajanı düzenlediğinizden emin olun**
      * Çok ajanlı kurulumlar birden fazla `auth-profiles.json` dosyası olabileceği anlamına gelir.
    * **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 status` kullanın.

    **"anthropic profili için kimlik bilgisi bulunamadı" düzeltme kontrol listesi**

    Bu, çalıştırmanın bir Anthropic kimlik doğrulama profiline sabitlendiği, ancak Gateway'in
    bunu kendi kimlik doğrulama deposunda bulamadığı anlamına gelir.

    * **Claude CLI kullanın**
      * Gateway ana makinesinde `openclaw models auth login --provider anthropic --method cli --set-default` çalıştırın.

    * **Bunun yerine bir API anahtarı kullanmak istiyorsanız**
      * `ANTHROPIC_API_KEY` değerini **gateway ana makinesinde** `~/.openclaw/.env` içine koyun.
      * Eksik profili zorlayan sabitlenmiş sıraları temizleyin:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models auth order clear --provider anthropic
        ```

    * **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.
  </Accordion>

  <Accordion title="Neden Google Gemini'yi de deneyip başarısız oldu?">
    Model yapılandırmanız Google Gemini'yi yedek olarak içeriyorsa (veya bir Gemini kısaltmasına geçtiyseniz), OpenClaw model yedeği sırasında bunu dener. Google kimlik bilgilerini yapılandırmadıysanız `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.
  </Accordion>
</AccordionGroup>

## Kimlik doğrulama profilleri: nedir ve nasıl yönetilir?

İlgili: [/concepts/oauth](/tr/concepts/oauth) (OAuth akışları, token saklama, çok hesaplı kalıplar)

<AccordionGroup>
  <Accordion title="Kimlik doğrulama profili nedir?">
    Kimlik doğrulama profili, bir sağlayıcıya bağlı adlandırılmış bir kimlik bilgisi kaydıdır (OAuth veya API anahtarı). Profiller burada bulunur:

    ```
    ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
    ```

    Kayıtlı profilleri gizli bilgileri dökmeden incelemek için `openclaw models auth list` çalıştırın (isteğe bağlı olarak `--provider <id>` veya `--json`). Ayrıntılar için [Modeller CLI](/tr/cli/models#auth-profiles) bölümüne bakın.
  </Accordion>

  <Accordion title="Tipik profil kimlikleri nelerdir?">
    OpenClaw şu tür sağlayıcı önekli kimlikler kullanır:

    * `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`)
  </Accordion>

  <Accordion title="Önce hangi kimlik doğrulama profilinin deneneceğini kontrol edebilir miyim?">
    Evet. Yapılandırma profiller için isteğe bağlı meta verileri ve sağlayıcı başına bir sıralamayı (`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):

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    # Defaults to the configured default agent (omit --agent)
    openclaw models auth order get --provider anthropic

    # Lock rotation to a single profile (only try this one)
    openclaw models auth order set --provider anthropic anthropic:default

    # Or set an explicit order (fallback within provider)
    openclaw models auth order set --provider anthropic anthropic:work anthropic:default

    # Clear override (fall back to config auth.order / round-robin)
    openclaw models auth order clear --provider anthropic
    ```

    Belirli bir ajanı hedeflemek için:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models auth order set --provider anthropic --agent main anthropic:default
    ```

    Gerçekte neyin deneneceğini doğrulamak için şunu kullanın:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models status --probe
    ```

    Saklanan bir profil açık sıradan çıkarılmışsa probe, sessizce denemek yerine
    o profil için `excluded_by_auth_order` bildirir.
  </Accordion>

  <Accordion title="OAuth ile API anahtarı arasındaki fark nedir?">
    OpenClaw ikisini de destekler:

    * **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 -p` kullanı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](https://support.claude.com/en/articles/15036540-use-the-claude-agent-sdk-with-your-claude-plan)
      bakın.
    * **API anahtarları** token başına ödeme faturalandırması kullanır.

    Sihirbaz açıkça Anthropic Claude CLI, OpenAI Codex OAuth ve API anahtarlarını destekler.
  </Accordion>
</AccordionGroup>

## İlgili

* [SSS](/tr/help/faq) — ana SSS
* [SSS — hızlı başlangıç ve ilk çalıştırma kurulumu](/tr/help/faq-first-run)
* [Model seçimi](/tr/concepts/model-providers)
* [Model yük devretmesi](/tr/concepts/model-failover)
