Providers

Anthropic

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

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

Başlarken

API anahtarı

En uygun kullanım: 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.

Onboarding çalıştırın

openclaw onboard
# choose: Anthropic API key

Ya da anahtarı doğrudan geçirin:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

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

openclaw models list --provider anthropic

Yapılandırma örneği

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Claude CLI

En uygun kullanım: ayrı bir API anahtarı olmadan mevcut bir Claude CLI oturum açmasını yeniden kullanma.

Claude CLI'nin yüklü ve oturum açmış olduğundan emin olun

Şununla doğrulayın:

claude --version

Onboarding çalıştırın

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

openclaw models list --provider anthropic

Yapılandırma örneği

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

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

Eski claude-cli/claude-opus-4-7 model referansları 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 agentRuntime.id içine koymalıdır.

Düşünme varsayılanları (Claude 4.6)

Claude 4.6 modelleri, açık bir düşünme düzeyi ayarlanmadığında OpenClaw içinde varsayılan olarak adaptive düşünmeyi kullanır.

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

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { thinking: "adaptive" },
        },
      },
    },
  },
}

İstem önbellekleme

OpenClaw, API anahtarı kimlik doğrulaması için Anthropic'in istem önbellekleme ö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	Uzatılmış önbellek
`"none"`	Önbellekleme yok	İstem önbelleklemeyi devre dışı bırak

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

Aracı başına önbellek geçersiz kılmaları

Model düzeyi parametreleri temeliniz olarak kullanın, ardından belirli aracıları agents.list[].params üzerinden geçersiz kılın:

{
  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ı:

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

Bu, bir aracının uzun ömürlü bir önbelleği korurken aynı modeldeki başka bir aracının ani/düşük yeniden kullanım trafiği için önbelleklemeyi devre dışı bırakmasına olanak tanır.

Bedrock Claude notları

Bedrock üzerindeki Anthropic Claude modelleri (amazon-bedrock/*anthropic.claude*), yapılandırıldığında cacheRetention 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ıç olarak ayarlar.

Gelişmiş yapılandırma

Hızlı mod

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

Komut	Şuna eşlenir
`/fast on`	`service_tier: "auto"`
`/fast off`	`service_tier: "standard_only"`

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-sonnet-4-6": {
          params: { fastMode: true },
        },
      },
    },
  },
}

Medya anlama (görüntü ve PDF)

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

Özellik	Değer
Varsayılan model	`claude-opus-4-7`
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 (beta)

Anthropic'in 1M bağlam penceresi beta kapılıdır. Bunu model başına etkinleştirin:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true },
        },
      },
    },
  },
}

OpenClaw bunu isteklerde anthropic-beta: context-1m-2025-08-07 değerine eşler.

params.context1m: true, uygun Opus ve Sonnet modelleri için Claude CLI arka ucuna (claude-cli/*) da uygulanır ve bu CLI oturumları için çalışma zamanı bağlam penceresini doğrudan API davranışıyla eşleşecek şekilde genişletir.

Claude Opus 4.7 1M bağlam

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

Sorun giderme

401 hataları / token aniden geçersiz

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

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

Anthropic kimlik doğrulaması aracı başınadır; yeni aracılar ana aracının anahtarlarını devralmaz. Bu aracı 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 model kapsamlı olabilir, bu nedenle kardeş bir Anthropic modeli hâlâ kullanılabilir olabilir. Başka bir Anthropic profili ekleyin veya bekleme süresinin bitmesini bekleyin.

İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

CLI arka uçları

Claude CLI arka ucu kurulumu ve çalışma zamanı ayrıntıları.

İstem önbellekleme

İstem önbelleklemenin sağlayıcılar arasında nasıl çalıştığı.

OAuth ve kimlik doğrulama

Kimlik doğrulama ayrıntıları ve kimlik bilgisi yeniden kullanım kuralları.

# Başlarken

API anahtarı

API anahtarınızı alın

Onboarding çalıştırın

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

# Yapılandırma örneği

Claude CLI

Claude CLI'nin yüklü ve oturum açmış olduğundan emin olun

Onboarding çalıştırın

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

# Yapılandırma örneği

# Düşünme varsayılanları (Claude 4.6)

# İstem önbellekleme

# Gelişmiş yapılandırma

# Sorun giderme

# İlgili

Başlarken

Yapılandırma örneği

Yapılandırma örneği

Düşünme varsayılanları (Claude 4.6)

İstem önbellekleme

Gelişmiş yapılandırma

Sorun giderme

İlgili