Providers

Anthropic

Anthropic, Claude model ailesini geliştirir. OpenClaw iki kimlik doğrulama rotasını destekler:

  • API anahtarı — kullanıma dayalı faturalandırmayla doğrudan Anthropic API erişimi (anthropic/* modelleri)
  • Claude CLI — aynı ana makinedeki mevcut Claude Code oturum açmasını yeniden kullanma

Başlarken

API anahtarı

En uygun olduğu durum: standart API erişimi ve kullanıma dayalı faturalandırma.

  • API anahtarınızı alın

    Anthropic Console içinde bir API anahtarı oluşturun.

  • İlk kurulumu çalıştırın

    bash
    openclaw onboard# choose: Anthropic API key

    Veya anahtarı doğrudan geçirin:

    bash
    openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
  • Modelin kullanılabilir olduğunu doğrulayın

    bash
    openclaw models list --provider anthropic
  • Yapılandırma örneği

    json5
    {  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

    Claude CLI

    En uygun olduğu durum: ayrı bir API anahtarı olmadan mevcut Claude CLI oturum açmasını yeniden kullanma.

  • Claude CLI'ın kurulu ve oturum açmış olduğundan emin olun

    Şununla doğrulayın:

    bash
    claude --version
  • İlk kurulumu çalıştırın

    bash
    openclaw onboard# choose: Claude CLI

    OpenClaw mevcut Claude CLI kimlik bilgilerini algılar ve yeniden kullanır.

  • Modelin kullanılabilir olduğunu doğrulayın

    bash
    openclaw models list --provider anthropic
  • Yapılandırma örneği

    Kanonik Anthropic model ref'ini ve bir CLI çalışma zamanı geçersiz kılmasını tercih edin:

    json5
    {  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

    Eski claude-cli/claude-opus-4-7 model ref'leri uyumluluk için hâlâ çalışır, ancak yeni yapılandırma sağlayıcı/model seçimini anthropic/* olarak tutmalı ve yürütme arka ucunu sağlayıcı/model çalışma zamanı ilkesine koymalıdır.

    Faturalandırma ve claude -p

    OpenClaw, Claude CLI çalıştırmaları için Claude Code'un etkileşimsiz claude -p yolunu kullanır. Anthropic şu anda bu yolu Agent SDK/programatik kullanım olarak ele alır:

    • Anthropic'in 15 Haziran 2026 destek güncellemesi, daha önce duyurulan ayrı Agent SDK kredi planını duraklattı.
    • Şimdilik, abonelik planı kapsamındaki Claude Agent SDK, claude -p ve üçüncü taraf uygulama kullanımı hâlâ oturum açılmış aboneliğin kullanım sınırlarından düşer.
    • Daha önce duyurulan aylık Agent SDK kredisi, Anthropic bu planı gözden geçirirken kullanılamaz.
    • Console/API anahtarı oturum açmaları kullandıkça öde API faturalandırmasını kullanır ve abonelik Agent SDK kredisini almaz.

    Duraklatma bildirimi için Anthropic'in Agent SDK planı makalesine, abonelik davranışı için Claude Code planı makalelerindeki Pro/Max ve Team/Enterprise bölümlerine bakın.

    Anthropic, OpenClaw sürümü olmadan Claude Code faturalandırmasını ve hız sınırı davranışını değiştirebilir. Faturalandırma öngörülebilirliği önemli olduğunda claude auth status, /status ve Anthropic'in bağlantılı dokümanlarını kontrol edin.

    Thinking varsayılanları (Claude Fable 5, 4.8 ve 4.6)

    anthropic/claude-fable-5 her zaman uyarlanabilir thinking kullanır ve varsayılan olarak high çabayı kullanır. Anthropic bu model için thinking'in devre dışı bırakılmasına izin vermediğinden, /think off ve /think minimal low çaba kullanır. OpenClaw ayrıca Fable 5 istekleri için özel sıcaklık değerlerini atlar.

    Claude Opus 4.8, OpenClaw'da thinking'i varsayılan olarak kapalı tutar. /think high|xhigh|max ile uyarlanabilir thinking'i açıkça etkinleştirdiğinizde OpenClaw, Anthropic'in Opus 4.8 çaba değerlerini gönderir; Claude 4.6 modelleri varsayılan olarak adaptive kullanır.

    İleti başına /think:<level> ile veya model parametrelerinde geçersiz kılın:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

    Güvenlik reddi fallback'i (Claude Fable 5)

    Bu neden var?

    Fable 5 sınıflandırıcıları, kısıtlı alanlardaki isteklerde stop_reason: "refusal" döndürür ve zararsıza yakın çalışmalarda da yanlış pozitif verebilir (güvenlik araçları, yaşam bilimleri veya hatta modelden ham akıl yürütmesini yeniden üretmesini istemek). Bir fallback olmadan tur, başka bir Claude modeli memnuniyetle hizmet verebilecek olsa bile bir hatayla ölür; Anthropic'in kendi ret iletisi API entegratörlerine bir fallback modeli yapılandırmalarını söyler.

    Nasıl çalışır?

    1. anthropic/claude-fable-5 modeline yapılan her doğrudan API anahtarı isteği için OpenClaw, Anthropic'in sunucu tarafı fallback katılımını gönderir: server-side-fallback-2026-06-01 beta başlığı ve fallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8, Anthropic'in Fable 5 için izin verdiği tek fallback hedefidir.
    2. Yalnızca güvenlik sınıflandırıcısı reddi fallback'i tetikler. Hız sınırları, aşırı yükler ve sunucu hataları aynen önceki gibi davranır ve OpenClaw'ın normal model failover akışından geçer.
    3. Kurtarma aynı çağrının içinde gerçekleşir. Herhangi bir çıktıdan önce gelen ret, gecikme dışında görünmezdir; tüm yanıt Opus 4.8'den gelir. Akış ortası bir rette kısmi metin, fallback modelin devam ettiği önek olarak tutulurken, reddedilen modelin akıl yürütmesi ve araç çağrıları Anthropic'in yeniden oynatma kuralları uyarınca atılır (bunlar geri yankılanmamalı veya yürütülmemelidir).
    4. Claude Opus 4.8 de reddederse tur, bu özellikten öncekiyle tamamen aynı şekilde reddi bir hata olarak yüzeye çıkarır.

    Fallback Anthropic API düzeyinde gerçekleşir, bu yüzden claude-opus-4-8 modelinin yapılandırılmış model listenizde veya fallback zincirinizde olması gerekmez; Fable uyumlu bir API anahtarı her zaman Opus'a hizmet verebilir.

    Gözlemlenebilirlik ve faturalandırma

    • Fallback ile sunulan bir tur, asistan iletisinde fromModel ve toModel adlarını veren bir provider_fallback tanılaması kaydeder ve iletinin responseModel alanı claude-opus-4-8 bildirir.
    • Anthropic deneme başına faturalandırır: çıktıdan önce gelen ret ücretsizdir ve kurtarma Claude Opus 4.8 fiyatlarıyla faturalandırılır (şu anda Fable 5 fiyatlarının yarısı). OpenClaw'ın tur başına maliyet tahmini, eşleşmesi için fallback ile sunulan turları Opus fiyatlarıyla fiyatlandırır.
    • Akış ortası bir ret, Anthropic tarafında zaten akışa verilmiş Fable kısmını ayrıca faturalandırır; bu bölüm API'nin deneme başına kullanımında bildirilir, ancak OpenClaw'ın tur başına tahminine katılmaz.

    Kapsam

    api.anthropic.com karşısında API anahtarı kimlik doğrulamasıyla anthropic/claude-fable-5 için geçerlidir. OAuth (Claude CLI abonelik yeniden kullanımı), proxy temel URL'leri, Bedrock, Vertex ve Foundry istekleri değişmeden kalır ve orada retleri hâlâ hata olarak yüzeye çıkarır.

    Canlı doğrulandı: Fable 5'ten ham düşünce zincirini yeniden üretmesini isteyen zararsız bir istem, fallback'ler olmadan gönderildiğinde category: "reasoning_extraction" ile reddedilir ve OpenClaw üzerinden gönderilen aynı istem, provider_fallback tanılaması eklenmiş normal, Opus tarafından sunulan bir yanıt döndürür.

    Temel davranış için Anthropic'in retler ve fallback kılavuzuna bakın.

    İstem önbelleğe alma

    OpenClaw, API anahtarı kimlik doğrulaması için Anthropic'in istem önbelleğe alma özelliğini destekler.

    Değer Önbellek süresi Açıklama
    "short" (varsayılan) 5 dakika API anahtarı kimlik doğrulaması için otomatik uygulanır
    "long" 1 saat Genişletilmiş önbellek
    "none" Önbelleğe alma yok İstem önbelleğe almayı devre dışı bırakır
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}
    Ajan başına önbellek geçersiz kılmaları

    Temel ayarınız olarak model düzeyi parametreleri kullanın, ardından belirli ajanları agents.list[].params üzerinden geçersiz kılın:

    json5
    {  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },    list: [      { id: "research", default: true },      { id: "alerts", params: { cacheRetention: "none" } },    ],  },}

    Yapılandırma birleştirme sırası:

    1. agents.defaults.models["provider/model"].params
    2. agents.list[].params (eşleşen id, anahtara göre geçersiz kılar)

    Bu, aynı modeldeki başka bir ajan ani/düşük yeniden kullanım trafiği için önbelleğe almayı devre dışı bırakırken bir ajanın uzun ömürlü önbellek tutmasını sağlar.

    Bedrock Claude notları
    • Bedrock üzerindeki Anthropic Claude modelleri (amazon-bedrock/*anthropic.claude*), yapılandırıldığında cacheRetention doğrudan geçişini kabul eder.
    • Anthropic olmayan Bedrock modelleri çalışma zamanında cacheRetention: "none" değerine zorlanır.
    • API anahtarı akıllı varsayılanları, açık bir değer ayarlanmadığında Claude-on-Bedrock referansları için cacheRetention: "short" değerini de başlangıçta ekler.

    Gelişmiş yapılandırma

    Hızlı mod

    OpenClaw'ın paylaşılan /fast anahtarı doğrudan Anthropic trafiğini destekler (api.anthropic.com için API anahtarı ve OAuth).

    Komut Şuna eşlenir
    /fast on service_tier: "auto"
    /fast off service_tier: "standard_only"
    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-sonnet-4-6": {          params: { fastMode: true },        },      },    },  },}
    Medya anlama (görüntü ve PDF)

    Paketlenmiş Anthropic Plugin, görüntü ve PDF anlamayı kaydeder. OpenClaw, yapılandırılmış Anthropic kimlik doğrulamasından medya yeteneklerini otomatik olarak çözümler; ek yapılandırma gerekmez.

    Özellik Değer
    Varsayılan model claude-opus-4-8
    Desteklenen girdi Görüntüler, PDF belgeleri

    Bir konuşmaya görüntü veya PDF eklendiğinde, OpenClaw bunu otomatik olarak Anthropic medya anlama sağlayıcısı üzerinden yönlendirir.

    1M bağlam penceresi

    Anthropic'in 1M bağlam penceresi, Opus 4.8, Opus 4.7, Opus 4.6 ve Sonnet 4.6 gibi GA uyumlu Claude 4.x modellerinde kullanılabilir. OpenClaw bu modelleri otomatik olarak 1M boyutunda ayarlar:

    json5
    {  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

    Eski yapılandırmalar params.context1m: true değerini koruyabilir, ancak OpenClaw artık kullanımdan kaldırılmış context-1m-2025-08-07 beta başlığını göndermez. Bu değere sahip eski anthropicBeta yapılandırma girdileri, istek başlığı çözümlemesi sırasında yok sayılır ve desteklenmeyen eski Claude modelleri normal bağlam pencerelerinde kalır.

    params.context1m: true, uygun GA uyumlu Opus ve Sonnet modelleri için Claude CLI arka ucuna da (claude-cli/*) uygulanır; böylece bu CLI oturumlarının çalışma zamanı bağlam penceresi doğrudan API davranışıyla eşleşecek şekilde korunur.

    Claude Opus 4.8 1M bağlamı

    anthropic/claude-opus-4-8 ve claude-cli varyantı varsayılan olarak 1M bağlam penceresine sahiptir; params.context1m: true gerekmez.

    Sorun giderme

    401 hataları / belirteç aniden geçersiz

    Anthropic belirteç kimlik doğrulamasının süresi dolar ve iptal edilebilir. Yeni kurulumlar için bunun yerine Anthropic API anahtarı kullanın.

    "anthropic" sağlayıcısı için API anahtarı bulunamadı

    Anthropic kimlik doğrulaması ajan başınadır; yeni ajanlar ana ajanın anahtarlarını devralmaz. Bu ajan için onboarding'i yeniden çalıştırın (veya Gateway ana makinesinde bir API anahtarı yapılandırın), ardından openclaw models status ile doğrulayın.

    "anthropic:default" profili için kimlik bilgisi bulunamadı

    Hangi kimlik doğrulama profilinin etkin olduğunu görmek için openclaw models status çalıştırın. Onboarding'i yeniden çalıştırın veya bu profil yolu için bir API anahtarı yapılandırın.

    Kullanılabilir kimlik doğrulama profili yok (tümü bekleme süresinde)

    auth.unusableProfiles için openclaw models status --json çıktısını kontrol edin. Anthropic hız sınırı bekleme süreleri modele özgü olabilir, bu yüzden kardeş bir Anthropic modeli hâlâ kullanılabilir olabilir. Başka bir Anthropic profili ekleyin veya bekleme süresinin bitmesini bekleyin.

    İlgili

    Was this useful?
    On this page

    On this page