Providers
Anthropic
Anthropic, Claude model ailesini geliştirir. OpenClaw iki kimlik doğrulama yolu destekler:
- API anahtarı - kullanıma dayalı faturalandırmayla Anthropic API'sine doğrudan erişim (
anthropic/*modelleri) - Claude CLI - aynı ana makinedeki mevcut bir Claude Code oturumunu yeniden kullanır
Kullanım ve maliyet takibi
OpenClaw, kullanılabilir Anthropic kimlik bilgisini algılar ve eşleşen kullanım yüzeyini seçer:
- Claude aboneliği/kurulum kimlik bilgileri, kota dönemlerini ve isteğe bağlı ek kullanım bütçesini gösterir.
ANTHROPIC_ADMIN_KEYveyaANTHROPIC_ADMIN_API_KEY, günlük harcama, token/önbellek toplamları, en çok kullanılan modeller ve maliyet kategorileri dâhil olmak üzere sağlayıcının bildirdiği 30 günlük kuruluş maliyetini ve Messages API kullanımını Control UI Kullanım bölümünde gösterir.- Anthropic sağlayıcı profilinde saklanan bir
sk-ant-admin...kimlik bilgisi, otomatik olarak Admin API anahtarı olarak algılanır.
Admin API maliyet geçmişi, Anthropic'in Kullanım ve Maliyet API'sinden gelir. Bu, OpenClaw'ın oturumdan türetilen tahmini maliyetinden ayrı, gerçek sağlayıcı faturalandırmasıdır.
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.
İlk kurulumu çalıştırın
openclaw onboard# şunu seçin: Anthropic API keyYa da anahtarı doğrudan iletin:
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"Modelin kullanılabilir olduğunu doğrulayın
openclaw models list --provider anthropicYapılandırma örneği
{ env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" }, agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}Claude CLI
En uygun kullanım: ayrı bir API anahtarı olmadan mevcut bir Claude CLI oturumunu yeniden kullanma.
Claude CLI'nin kurulu olduğundan ve oturum açıldığından emin olun
Şununla doğrulayın:
claude --versionİlk kurulumu çalıştırın
openclaw onboard# şunu seçin: Claude CLIOpenClaw, mevcut Claude CLI kimlik bilgilerini algılar ve yeniden kullanır.
Modelin kullanılabilir olduğunu doğrulayın
openclaw models list --provider anthropicKurulum token'ı alma
Claude Code'un kurulu olduğu herhangi bir makinede claude setup-token komutunu çalıştırın. Bu komut,
sk-ant-oat01- ile başlayan uzun ömürlü bir token yazdırır.
İlk kurulum sırasında macOS uygulamasında Connect with an API key or token altında Anthropic setup-token seçeneğini belirleyerek token'ı yapıştırın veya şunu kullanın:
openclaw models auth login --provider anthropic --method setup-tokenYapılandırma örneği
Standart Anthropic model başvurusunu ve bir CLI çalışma zamanı geçersiz kılmasını tercih edin:
{ 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 başvuruları uyumluluk için
çalışmaya devam eder; 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ı politikasına 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 değerlendirir:
- Anthropic'in 15 Haziran 2026 tarihli destek güncellemesi, daha önce duyurulan ayrı Agent SDK kredi planını duraklattı.
- Abonelik planındaki Claude Agent SDK,
claude -pve üçü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ı oturumları, 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'un Pro/Max ve Team/Enterprise planı makalelerine bakın.
Anthropic, bir OpenClaw sürümü olmadan Claude Code faturalandırma 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ı verilen belgelerini kontrol edin.
Bilgisayarlar arasındaki Claude oturumları
Paketle gelen Anthropic plugin'i, normal oturumlar kenar çubuğuna bir Claude Code grubu ekler. Satırlar normal Sohbet bölmesinde açılır. Gateway'de ve bağlı node ana makinelerinde arşivlenmemiş Claude Code oturumlarını keşfeder:
- Claude CLI oturumları, geçerli proje dizini kayıtlarından ve sınırlı meta veri
öneki
~/.claude/projects/altında yan zincir olmayan birsdk-clioturumunu tanımlayan güncel JSONL dosyalarından gelir. - Claude Desktop oturumları, meta verileri aynı Claude Code oturum kimliğine işaret ettiğinde Desktop başlığını, etkinlik zamanını ve arşiv durumunu kullanır.
- Yalnızca CLI oturumunda arşiv bayrağı bulunmaz; bu nedenle dökümü mevcut olduğu sürece görünür kalır.
Keşif için ek OpenClaw yapılandırması gerekmez. Anthropic plugin'i
paketle gelir ve varsayılan olarak etkindir; yerel bir macOS node'u, yerel
~/.claude/projects/ dizini mevcut olduğunda salt okunur Claude oturum komutlarını duyurur.
Bu komutlar ilk göründüğünde node eşleştirme yükseltmesini onaylayın.
Kenar çubuğu, satırları Gateway veya eşleştirilmiş node ana makinelerine göre gruplandırır, her ana makineden
en yeni sınırlı sayfayla başlar ve normal 30 saniyelik
aralıkla yenilenir. Daha fazla geçmişi olan her ana makine için sonraki sayfayı eklemek üzere
bir katalog grubunun altındaki Daha fazla oturum yükle seçeneğini kullanın; eklenen satırlar görünür kalır ve
yenilemeler sırasında aynı derinliğe kadar yeniden getirilir. Katalog istemcileri
sessions.catalog.list kullanır; bir satırı açmak sessions.catalog.read kullanır.
Terminal devralma, claude değerini hizmet/arka plan işlemi PATH'inden önce sahip ana makine kullanıcısının oturum açma kabuğu
PATH'inden çözümler. Bu, uygulama tarafından başlatılan oturumların
operatörün normal bir terminalde kullandığı Claude CLI ile uyumlu kalmasını sağlar.
Bir satır seçildiğinde önce en yeni döküm sayfası okunur. Daha eski döküm öğelerini yükle, belirsiz bir bayt imlecini izler ve tüm geçmişi yüklemek yerine JSONL dosyasından başka bir sınırlı bölümü okur. Normal kullanıcı, asistan, akıl yürütme, araç çağrısı ve araç sonucu içerikleri korunur. Node/Gateway güvenlik tavanından büyük tekil bir öğe, açıkça kesilmiş olarak işaretlenir.
Gateway'e yerel bir claude-cli satırında normal yazma alanına yazmak,
sessions.catalog.continue çağrısını yapar. OpenClaw, yerel katalog kaydını yeniden çözümler,
modeli kilitli yerel bir oturum oluşturur veya yeniden kullanır, en fazla 200 görünür
öğeyi ya da 512 KiB'ı içe aktarır ve Claude CLI bağlamasını başlatır. İlk tur
--fork-session ile sürdürülür; Claude çatala yeni bir oturum kimliği atar, böylece sonraki turlar
çatalı kullanır ve kaynak oturum değiştirilmeden kalır.
Başsız bir node ana makinesi de aşağıdaki node'a özgü ayarı etkinleştirip node ana makinesini yeniden başlatarak Claude CLI satırlarının sürdürülebilmesini sağlayabilir:
{ nodeHost: { agentRuns: { claude: { enabled: true }, }, },}Node, yalnızca ayar etkinleştirildiğinde ve yerel claude yürütülebilir dosyası
çözümlendiğinde agent.cli.claude.run.v1 duyurur. OpenClaw, katalog kaydını bu node'da yeniden çözümler,
aynı sınırlı geçmişi içe aktarır ve benimsenen oturumu node'a ve katalog tarafından bildirilen
çalışma dizinine bağlar. Her tur, ilgili node'un Claude dosyalarını ve oturumunu kullanarak node'un
gerçek claude -p işlemini çalıştırır. Node'un yürütme onayı politikası yine geçerlidir;
Gateway bu katılımı zorlayamaz.
Node sürdürme v1 yalnızca tek seferliktir. Gateway geri döngü MCP yapılandırmasını ve Gateway Skills plugin'i bağımsız değişkenlerini atlar, bir Gateway dökümünden yeniden başlangıç yapmaz ve eklerle görselleri reddeder. Claude Desktop satırları yalnızca görüntülenebilir olarak kalır. Yerel macOS uygulama node'ları da uygulama çalıştırma komutunu duyurana kadar yalnızca görüntülenebilir olarak kalır.
Node komutu ve güvenlik sınırı için Node'lar: Claude oturumları ve dökümleri bölümüne bakın.
Düşünme varsayılanları (Claude Sonnet 5, Mythos 5, Fable 5, 4.8 ve 4.6)
anthropic/claude-sonnet-5, varsayılan olarak high efor düzeyinde uyarlanabilir düşünmeyi kullanır.
Düşünmeyi devre dışı bırakmak için /think off, modelin daha yüksek
yerel efor düzeyleri içinse /think xhigh|max kullanın. Anthropic bu modelde
söz konusu istek özelliklerini desteklemediğinden OpenClaw, Sonnet 5 için manuel
düşünme bütçelerini, özel örnekleme parametrelerini, asistan ön doldurmalarını ve Priority Tier'ı göndermez.
Katalog, 31 Ağustos 2026'ya kadar Anthropic'in başlangıç $2/$10 girdi/çıktı fiyatlandırmasını kullanır;
standart $3/$15 fiyatlandırması 1 Eylül 2026'da başlar.
anthropic/claude-fable-5 her zaman uyarlanabilir düşünmeyi kullanır ve varsayılan efor düzeyi high
olarak belirlenmiştir. Anthropic bu model için düşünmenin devre dışı bırakılmasına izin vermediğinden
/think off ve /think minimal bunun yerine low efor düzeyiyle eşleştirilir. Anthropic,
düşünmenin etkin olduğu hiçbir istekte sıcaklık geçersiz kılmasını kabul etmediğinden OpenClaw ayrıca
Fable 5 isteklerinde özel sıcaklık değerlerini göndermez.
anthropic/claude-mythos-5, aynı sürekli etkin
uyarlanabilir düşünme sözleşmesine sahip, sınırlı erişimli bir modeldir. OpenClaw varsayılan olarak high kullanır,
/think off ve /think minimal değerlerini low ile eşleştirir ve çağıran tarafından seçilen örnekleme parametrelerini göndermez.
Katalog; modelin 1.000.000 tokenlık bağlam penceresini, 128.000 tokenlık çıktı
sınırını, görüntü girdisini ve $10/$50 girdi/çıktı fiyatlandırmasını yayımlar.
Claude Opus 4.8'de düşünme, OpenClaw'da varsayılan olarak kapalı kalır. Uyarlanabilir düşünmeyi
/think high|xhigh|max ile açıkça etkinleştirdiğinizde OpenClaw,
Anthropic'in Opus 4.8 efor değerlerini gönderir; Claude 4.6 modelleri (Opus 4.6 ve Sonnet 4.6)
varsayılan olarak adaptive kullanır.
Her mesaj için /think:<level> ile veya model parametrelerinde geçersiz kılın:
{ agents: { defaults: { models: { "anthropic/claude-opus-4-8": { params: { thinking: "high" }, }, }, }, },}Güvenlik reddi yedek modeli (Claude Fable 5)
Bunun var olma nedeni
Fable 5 sınıflandırıcıları, kısıtlı alanlardaki istekler için stop_reason: "refusal" döndürür
ve zararsız konulara yakın çalışmalarda da yanlış pozitif sonuç verir (güvenlik
araçları, yaşam bilimleri ve hatta modelden ham muhakemesini yeniden üretmesini
istemek gibi). Yedek model olmadan, başka bir Claude modeli isteği memnuniyetle
yanıtlayabilecek olsa bile istek bir hatayla sonlanır; Anthropic'in kendi ret mesajı,
API entegratörlerine bir yedek model yapılandırmalarını söyler.
Nasıl çalışır?
anthropic/claude-fable-5modeline doğrudan API anahtarıyla gönderilen her istek için OpenClaw, Anthropic'in sunucu tarafındaki yedek model katılımını gönderir:server-side-fallback-2026-06-01beta üst bilgisi vefallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8, Anthropic'in Fable 5 için izin verdiği tek yedek hedeftir.- Yalnızca güvenlik sınıflandırıcısının reddi yedek modeli tetikler. Hız sınırları, aşırı yükler ve sunucu hataları daha önceki gibi davranır ve OpenClaw'ın normal model yük devretme sürecinden geçer.
- Kurtarma aynı çağrı içinde gerçekleşir. Herhangi bir çıktıdan önceki ret, gecikme dışında görünmez; yanıtın tamamı Opus 4.8'den gelir. Akışın ortasında gerçekleşen bir rette kısmi metin, yedek modelin devam edeceği önek olarak korunurken reddedilen modelin muhakemesi ve araç çağrıları Anthropic'in yeniden oynatma kuralları uyarınca atılır (bunlar geri yansıtılmamalı veya yürütülmemelidir).
- Claude Opus 4.8 de reddederse istek, bu özellikten önce olduğu gibi reddi hata olarak gösterir.
Yedek modele geçiş Anthropic API düzeyinde gerçekleştiğinden claude-opus-4-8,
yapılandırılmış model listenizde veya yedek zincirinizde bulunmak zorunda değildir; Fable özellikli
bir API anahtarı her zaman Opus'u kullanabilir.
Gözlemlenebilirlik ve faturalandırma
- Yedek model tarafından yanıtlanan bir istek, asistan mesajına
fromModelvetoModeladlarını belirten birprovider_fallbacktanılaması kaydeder ve mesajınresponseModelalanıclaude-opus-4-8bildirir. - Anthropic her denemeyi ayrı faturalandırır: çıktıdan önceki ret ücretsizdir ve kurtarma Claude Opus 4.8 tarifeleriyle (şu anda Fable 5 tarifelerinin yarısı) faturalandırılır. OpenClaw'ın istek başına maliyet tahmini, bununla uyumlu olması için yedek model tarafından yanıtlanan istekleri Opus tarifeleriyle hesaplar.
- Akışın ortasındaki bir ret, Anthropic tarafında daha önce akışla gönderilmiş Fable kısmi çıktısının da ayrıca faturalandırılmasına neden olur; bu bölüm API'nin deneme başına kullanımında bildirilir ancak OpenClaw'ın istek başına tahminine dahil edilmez.
Kapsam
api.anthropic.com adresine API anahtarıyla kimlik doğrulama üzerinden yapılan
anthropic/claude-fable-5 istekleri için geçerlidir. OAuth (Claude CLI aboneliğinin yeniden kullanılması), proxy temel URL'leri,
Bedrock, Vertex ve Foundry istekleri değişmez ve retleri hata olarak
göstermeye devam eder.
Canlı olarak doğrulandı: Fable 5'ten ham düşünce zincirini yeniden üretmesini isteyen
zararsız bir istem, yedek modeller olmadan gönderildiğinde category: "reasoning_extraction" ile reddedilir;
aynı istem OpenClaw üzerinden gönderildiğinde ise provider_fallback tanılaması eklenmiş,
Opus tarafından sağlanan normal bir yanıt döndürür.
Temel davranış için Anthropic'in retler ve yedek model kılavuzuna bakın.
İstem önbelleğe alma
OpenClaw, API anahtarıyla kimlik doğrulamada Anthropic'in istem önbelleğe alma özelliğini destekler.
| Değer | Önbellek süresi | Açıklama |
|---|---|---|
"short" (varsayılan) |
5 dakika | API anahtarıyla kimlik doğrulamada otomatik olarak uygulanır |
"long" |
1 saat | Genişletilmiş önbellek |
"none" |
Önbelleğe alma yok | İstem önbelleğe almayı devre dışı bırakır |
{ agents: { defaults: { models: { "anthropic/claude-opus-4-6": { params: { cacheRetention: "long" }, }, }, }, },}Ajan başına önbellek geçersiz kılmaları
Temel değer olarak model düzeyindeki parametreleri kullanın, ardından belirli ajanlar için agents.list[].params aracılığıyla 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"].paramsagents.list[].params(eşleşenid, anahtara göre geçersiz kılar)
Bu, bir aracının uzun ömürlü bir önbellek tutmasına olanak tanırken aynı modeldeki başka bir aracının ani yoğunluklu/düşük yeniden kullanım oranlı trafik için önbelleğe almayı devre dışı bırakmasını sağlar.
Bedrock Claude notları
- Bedrock üzerindeki Anthropic Claude modelleri (
amazon-bedrock/*anthropic.claude*) yapılandırıldığındacacheRetentiondoğrudan aktarımını kabul eder. - Anthropic dışı 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 Bedrock üzerindeki Claude referansları için
cacheRetention: "short"değerini de başlangıç değeri olarak belirler.
Gelişmiş yapılandırma
Hızlı mod
OpenClaw'ın paylaşılan /fast anahtarı, api.anthropic.com hedefine doğrudan API anahtarı trafiği için Anthropic'in service_tier alanını ayarlar.
| Komut | Eşlendiği değer |
|---|---|
/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'i görüntü ve PDF anlama özelliğini kaydeder. OpenClaw, yapılandırılan 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
Claude Sonnet 5, Mythos 5 ve Fable 5, tam olarak 1.000.000 tokenlık bir girdi
penceresine sahiptir ve 128.000'e kadar çıktı tokenını destekler. Anthropic'in 1M bağlam
penceresi, uyarlanabilir düşünme özelliğine sahip Claude 4.x modellerinde de genel kullanıma sunulmuştur: Opus 4.8,
Opus 4.7, Opus 4.6 ve Sonnet 4.6. OpenClaw bu modellerin boyutlarını
otomatik olarak belirler; params.context1m gerekmez:
{ agents: { defaults: { models: { "anthropic/claude-sonnet-5": {}, "anthropic/claude-mythos-5": {}, "anthropic/claude-opus-4-6": {}, }, }, },}Eski yapılandırmalar params.context1m: true değerini koruyabilir; bu,
bu modeller için zararsız ve etkisizdir ve OpenClaw artık kullanımdan kaldırılmış
context-1m-2025-08-07 beta üstbilgisini hiçbir durumda göndermez. Bu değere sahip eski anthropicBeta yapılandırma
girdileri, istek üstbilgisi çözümlemesi sırasında kaldırılır ve
desteklenmeyen eski Claude modelleri normal bağlam pencerelerini kullanmayı sürdürür.
params.context1m: true, Claude CLI arka ucu
(claude-cli/*) için de aynı şekilde davranır: genel kullanıma uygun Opus ve Sonnet modelleri zaten
1M pencereyi otomatik olarak alır; dolayısıyla parametre burada da isteğe bağlıdır.
Claude Opus 4.8 1M bağlamı
anthropic/claude-opus-4-8 ve onun claude-cli varyantı varsayılan olarak 1M bağlam
penceresine sahiptir; params.context1m: true gerekmez.
Sorun giderme
401 hataları / belirtecin aniden geçersizleşmesi
Anthropic belirteciyle kimlik doğrulamanın süresi dolar ve bu kimlik doğrulama iptal edilebilir. Yeni kurulumlarda 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 ilk katılım sürecini 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 komutunu çalıştırın. İlk katılım sürecini 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 öğesini kontrol edin. Anthropic hız sınırı bekleme süreleri model kapsamlı olabilir; bu nedenle aynı gruptaki başka bir Anthropic modeli hâlâ kullanılabilir. Başka bir Anthropic profili ekleyin veya bekleme süresinin dolmasını bekleyin.
İlgili
Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.
Claude CLI arka uç kurulumu ve çalışma zamanı ayrıntıları.
İstem önbelleğe almanın sağlayıcılar genelinde nasıl çalıştığı.
Kimlik doğrulama ayrıntıları ve kimlik bilgilerini yeniden kullanma kuralları.