Anthropic (Claude)¶

Anthropic, Claude model ailesini geliştirir ve API üzerinden erişim sağlar. OpenClaw’da bir API anahtarı veya setup-token ile kimlik doğrulama yapabilirsiniz.

Seçenek A: Anthropic API anahtarı¶

En uygun: standart API erişimi ve kullanıma dayalı faturalandırma. API anahtarınızı Anthropic Console’da oluşturun.

CLI kurulumu¶

openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Yapılandırma parçacığı¶

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

Prompt önbellekleme (Anthropic API)¶

OpenClaw, Anthropic’in prompt caching özelliğini destekler. Bu özellik yalnızca API içindir; abonelik kimlik doğrulaması önbellek ayarlarını dikkate almaz.

Yapılandırma¶

Model yapılandırmanızda cacheRetention parametresini kullanın:

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

Varsayılanlar¶

Anthropic API Anahtarı kimlik doğrulaması kullanıldığında, OpenClaw tüm Anthropic modelleri için otomatik olarak cacheRetention: "short" (5 dakikalık önbellek) uygular. Bunu, yapılandırmanızda açıkça cacheRetention ayarlayarak geçersiz kılabilirsiniz.

Eski parametre¶

Daha eski olan cacheControlTtl parametresi geriye dönük uyumluluk için hâlâ desteklenmektedir:

• "5m", short’ye eşlenir
• "1h", long’e eşlenir

Yeni cacheRetention parametresine geçmenizi öneririz.

OpenClaw, Anthropic API istekleri için extended-cache-ttl-2025-04-11 beta bayrağını içerir; sağlayıcı başlıklarını geçersiz kılıyorsanız bunu koruyun (bkz. /gateway/configuration).

Seçenek B: Claude setup-token¶

En uygun: Claude aboneliğinizi kullanmak için.

Setup-token nereden alınır¶

Setup-token’lar Anthropic Console’dan değil, Claude Code CLI tarafından oluşturulur. Bunu herhangi bir makinede çalıştırabilirsiniz:

claude setup-token

Belirteci OpenClaw’a yapıştırın (sihirbaz: Anthropic token (setup-token yapıştır)) veya gateway ana makinesinde çalıştırın:

openclaw models auth setup-token --provider anthropic

Belirteci farklı bir makinede oluşturduysanız, yapıştırın:

openclaw models auth paste-token --provider anthropic

CLI kurulumu (setup-token)¶

# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token

Yapılandırma parçası (setup-token)¶

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Notlar¶

• Setup-token’ı claude setup-token ile oluşturup yapıştırın veya gateway ana makinesinde openclaw models auth setup-token çalıştırın.
• Claude aboneliğinde “OAuth token refresh failed …” görürseniz, bir setup-token ile yeniden kimlik doğrulaması yapın. Bkz. /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription.
• Kimlik doğrulama ayrıntıları ve yeniden kullanım kuralları /concepts/oauth bölümündedir.

Sorun Giderme¶

401 hataları / belirtecin aniden geçersiz olması

• Claude abonelik kimlik doğrulaması süresi dolabilir veya iptal edilebilir. claude setup-token komutunu yeniden çalıştırın ve bunu gateway ana makinesine yapıştırın.
• Claude CLI oturumu farklı bir makinedeyse, gateway ana makinesinde openclaw models auth paste-token --provider anthropic kullanın.

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

• Kimlik doğrulama ajan başınadır. Yeni ajanlar ana ajanın anahtarlarını devralmaz.
• İlgili ajan için onboarding’i yeniden çalıştırın veya gateway ana makinesine bir setup-token / API anahtarı yapıştırın, ardından openclaw models status ile doğrulayın.

Profil anthropic:default için kimlik bilgileri 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 için bir setup-token / API anahtarı yapıştırın.

Kullanılabilir kimlik doğrulama profili yok (hepsi cooldown/kullanılamaz)

• openclaw models status --json içinde auth.unusableProfiles durumunu kontrol edin.
• Başka bir Anthropic profili ekleyin veya cooldown süresinin dolmasını bekleyin.

Daha fazlası: /gateway/troubleshooting ve /help/faq.