​

Anthropic (Claude)

​

Seçenek A: Anthropic API anahtarı

​

CLI kurulumu

openclaw onboard
# seçin: Anthropic API key

# veya etkileşimsiz
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

​

Claude CLI yapılandırma parçacığı

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

​

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

• Anthropic Claude 4.6 modelleri, açık bir düşünme düzeyi ayarlanmamışsa OpenClaw içinde varsayılan olarak adaptive düşünme kullanır.
• Mesaj başına (/think:<level>) veya model parametrelerinde geçersiz kılabilirsiniz: agents.defaults.models["anthropic/<model>"].params.thinking.
• İlgili Anthropic belgeleri:
  • Adaptive thinking
  • Extended thinking

​

Hızlı mod (Anthropic API)

• /fast on, service_tier: "auto" değerine eşlenir
• /fast off, service_tier: "standard_only" değerine eşlenir
• Yapılandırma varsayılanı:

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

• OpenClaw, Anthropic hizmet katmanlarını yalnızca doğrudan api.anthropic.com istekleri için enjekte eder. anthropic/* trafiğini bir proxy veya gateway üzerinden yönlendirirseniz /fast, service_tier değerine dokunmaz.
• Açık Anthropic serviceTier veya service_tier model parametreleri, ikisi birden ayarlandığında /fast varsayılanını geçersiz kılar.
• Anthropic, etkin katmanı yanıtta usage.service_tier altında bildirir. Priority Tier kapasitesi olmayan hesaplarda service_tier: "auto" yine de standard olarak çözümlenebilir.

​

Prompt caching (Anthropic API)

​

Yapılandırma

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

​

Varsayılanlar

​

Aracı başına cacheRetention geçersiz kılmaları

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" }, // çoğu aracı için temel
        },
      },
    },
    list: [
      { id: "research", default: true },
      { id: "alerts", params: { cacheRetention: "none" } }, // yalnızca bu aracı için geçersiz kıl
    ],
  },
}

1. agents.defaults.models["provider/model"].params
2. agents.list[].params (id eşleşirse, anahtar bazında geçersiz kılar)

​

Bedrock Claude notları

• Bedrock üzerindeki Anthropic Claude modelleri (amazon-bedrock/*anthropic.claude*), yapılandırıldığında cacheRetention pass-through kabul eder.
• Anthropic dışındaki Bedrock modelleri, çalışma zamanında cacheRetention: "none" olmaya zorlanır.
• Anthropic API-key akıllı varsayılanları da, açık bir değer ayarlanmadığında Claude-on-Bedrock model başvuruları için cacheRetention: "short" değerini tohumlar.

​

1M bağlam penceresi (Anthropic beta)

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

​

Seçenek B: mesaj sağlayıcısı olarak Claude CLI

• claude-cli/claude-sonnet-4-6
• claude-cli/claude-opus-4-6

1. OpenClaw, gateway host üzerinde claude -p --output-format stream-json --include-partial-messages ... komutunu başlatır ve prompt’u stdin üzerinden gönderir.
2. İlk tur --session-id <uuid> gönderir.
3. Takip eden turlar, depolanan Claude oturumunu --resume <sessionId> ile yeniden kullanır.
4. Sohbet mesajlarınız yine normal OpenClaw mesaj hattından geçer, ancak asıl model yanıtı Claude CLI tarafından üretilir.

​

Gereksinimler

• Claude CLI, gateway host üzerinde kurulu ve PATH üzerinde erişilebilir olmalı ya da mutlak bir komut yoluyla yapılandırılmış olmalıdır.
• Claude CLI, aynı host üzerinde zaten kimlik doğrulaması yapılmış olmalıdır:

claude auth status

• OpenClaw, yapılandırmanız açıkça claude-cli/... veya claude-cli backend yapılandırmasına başvurduğunda, gateway başlangıcında paketlenmiş Anthropic plugin’ini otomatik olarak yükler.

​

Yapılandırma parçacığı

{
  agents: {
    defaults: {
      model: {
        primary: "claude-cli/claude-sonnet-4-6",
      },
      models: {
        "claude-cli/claude-sonnet-4-6": {},
      },
      sandbox: { mode: "off" },
    },
  },
}

{
  agents: {
    defaults: {
      cliBackends: {
        "claude-cli": {
          command: "/opt/homebrew/bin/claude",
        },
      },
    },
  },
}

​

Elde ettikleriniz

• Yerel CLI’den yeniden kullanılan Claude abonelik kimlik doğrulaması (çalışma zamanında okunur, kalıcı olarak saklanmaz)
• Normal OpenClaw mesaj/oturum yönlendirmesi
• Turlar arasında Claude CLI oturum sürekliliği (kimlik doğrulama değişikliklerinde geçersiz kılınır)
• Loopback MCP bridge aracılığıyla Claude CLI’ye sunulan gateway araçları
• Canlı kısmi mesaj ilerlemesiyle JSONL akışı

​

Anthropic kimlik doğrulamasından Claude CLI’ye geçiş

• Claude CLI, OpenClaw’u çalıştıran aynı gateway host üzerinde kurulu olmalı
• Claude CLI orada zaten oturum açmış olmalı: claude auth login

openclaw models auth login --provider anthropic --method cli --set-default

openclaw onboard --auth-choice anthropic-cli

• Claude CLI’nin gateway host üzerinde zaten oturum açtığını doğrular
• varsayılan modeli claude-cli/... olarak değiştirir
• anthropic/claude-opus-4-6 gibi Anthropic varsayılan model geri dönüşlerini claude-cli/claude-opus-4-6 olarak yeniden yazar
• agents.defaults.models içine eşleşen claude-cli/... girdileri ekler

openclaw models status

• mevcut Anthropic kimlik doğrulama profillerinizi silmez
• ana varsayılan model/allowlist yolu dışındaki her eski anthropic/... yapılandırma başvurusunu kaldırmaz

​

Önemli sınırlamalar

• Bu, Anthropic API sağlayıcısı değildir. Bu, yerel CLI çalışma zamanıdır.
• OpenClaw, araç çağrılarını doğrudan enjekte etmez. Claude CLI, gateway araçlarını bir loopback MCP bridge üzerinden alır (bundleMcp: true, varsayılan).
• Claude CLI, JSONL (stream-json ile --include-partial-messages) üzerinden yanıt akışı sağlar. Prompt’lar argv üzerinden değil, stdin üzerinden gönderilir.
• Kimlik doğrulama, canlı Claude CLI kimlik bilgilerinden çalışma zamanında okunur ve OpenClaw profillerine kalıcı olarak kaydedilmez. Etkileşimsiz bağlamlarda anahtarlık istemleri bastırılır.
• Oturum yeniden kullanımı cliSessionBinding meta verisi ile izlenir. Claude CLI oturum durumu değiştiğinde (yeniden giriş, token rotasyonu), depolanan oturumlar geçersiz kılınır ve yeni bir oturum başlar.
• En iyi kullanım alanı, paylaşımlı çok kullanıcılı faturalama kurulumları değil, kişisel bir gateway host’tur.

​

Notlar

• Anthropic’in herkese açık Claude Code belgeleri hâlâ claude -p gibi doğrudan CLI kullanımını belgelemektedir. Yerel, kullanıcı tarafından yönetilen geri dönüşün büyük olasılıkla izinli olduğunu düşünüyoruz; ancak Anthropic’in OpenClaw kullanıcılarına gönderdiği ayrı bildirim, OpenClaw Claude-login yolunun üçüncü taraf harness kullanımı olduğunu ve Extra Usage gerektirdiğini söylüyor (abonelikten ayrı olarak kullandıkça öde faturalandırılır). Üretim için bunun yerine Anthropic API anahtarlarını öneriyoruz.
• Anthropic setup-token, OpenClaw içinde eski/manuel bir yol olarak yeniden kullanılabilir durumdadır. Anthropic’in OpenClaw’a özgü faturalama bildirimi hâlâ geçerlidir, bu yüzden Anthropic’in bu yol için Extra Usage gerektirdiği beklentisiyle kullanın.
• Kimlik doğrulama ayrıntıları ve yeniden kullanım kuralları /concepts/oauth içindedir.

​

Sorun giderme

• Eski Anthropic token kimlik doğrulaması süresi dolabilir veya iptal edilebilir.
• Yeni kurulum için gateway host üzerindeki yerel Claude CLI yoluna veya bir Anthropic API anahtarına geçin.

• Kimlik doğrulama aracı başınadır. Yeni aracılar ana aracının anahtarlarını devralmaz.
• O aracı için onboarding işlemini yeniden çalıştırın veya gateway host üzerinde bir API anahtarı yapılandırın, ardından openclaw models status ile doğrulayın.

• Hangi kimlik doğrulama profilinin etkin olduğunu görmek için openclaw models status çalıştırın.
• Onboarding işlemini yeniden çalıştırın veya o profil yolu için bir API anahtarı ya da Claude CLI yapılandırın.

• auth.unusableProfiles için openclaw models status --json çıktısını denetleyin.
• Anthropic rate-limit cooldown süreleri model kapsamlı olabilir; bu nedenle geçerli model cooldown durumundayken kardeş bir Anthropic modeli yine de kullanılabilir olabilir.
• Başka bir Anthropic profili ekleyin veya cooldown süresinin dolmasını bekleyin.