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 Code oturumunu yeniden kullanma
Kullanım ve maliyet takibi
OpenClaw, kullanılabilir Anthropic kimlik bilgisini algılar ve eşleşen kullanım yüzeyini seçer:
- Claude abonelik/kurulum kimlik bilgileri, kota aralıklarını ve isteğe bağlı ek kullanım bütçesini gösterir.
ANTHROPIC_ADMIN_KEYveyaANTHROPIC_ADMIN_API_KEY, Control UI Kullanım bölümünde sağlayıcının bildirdiği 30 günlük kuruluş maliyetini ve Messages API kullanımını; günlük harcama, token/önbellek toplamları, en çok kullanılan modeller ve maliyet kategorileriyle birlikte gösterir.- Anthropic sağlayıcı profilinde depolanan 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 oturum verilerinden türetilen tahmini maliyetinden ayrı olan gerçek sağlayıcı faturalandırmasıdır.
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
openclaw onboard# 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-5" } } },}Claude CLI
En uygun olduğu durum: ayrı bir API anahtarı olmadan mevcut bir Claude CLI oturumunu yeniden kullanma.
Claude CLI'ın kurulu ve oturumun açık olduğundan emin olun
Şununla doğrulayın:
claude --versionİlk kurulumu çalıştırın
openclaw onboard# 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 referansını ve bir CLI çalışma zamanı geçersiz kılmasını tercih edin:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-5" }, models: { "anthropic/claude-opus-5": { agentRuntime: { id: "claude-cli" }, }, }, }, },}Eski claude-cli/claude-opus-4-7 model referansları uyumluluk amacıyla
ç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 yerleştirmelidir.
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çinse 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ırmanın ö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 ve bağlı node ana makinelerindeki arşivlenmemiş Claude Code oturumlarını keşfeder:
- Claude CLI oturumları geçerli proje dizini kayıtlarından gelir. Dizine eklenmemiş
transkriptler için sınırlı bir meta veri geri dönüşü,
~/.claude/projects/altındaki eşzamanlı, yan zincir olmayan etkileşimli (cli) ve başsız Agent SDK CLI (sdk-cli) oturumlarını tanır. - 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ğı bulunmadığından, transkripti 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 ~/.claude/projects/ dizini mevcut olduğunda yerel bir macOS node'u
salt okunur Claude oturum komutlarını duyurur.
Bu komutlar ilk kez 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 ve her
ana makinenin en yeni sınırlı sayfasını, ilgili bilgisayar yanıt verir vermez gösterir. Ana makine bağlantısı
değişikliklerinden sonra, sayfa yeniden odağa geldiğinde ve görünürken en fazla
30 saniyede bir yeniden uzlaştırma yapar; böylece OpenClaw dışında oluşturulan Claude oturumları
yeniden yükleme olmadan görünür. Değişen bir katalog daha hızlı bir takip geçişini tetikler. Daha fazla
geçmişi bulunan 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 boyunca aynı derinliğe
kadar yeniden getirilir. Katalog istemcileri sessions.catalog.list kullanır; bir satır açılırken
sessions.catalog.read kullanılır.
Terminal denetimini devralma, claude konumunu hizmet/daemon PATH'inden önce sahip ana makine kullanıcısının oturum açma kabuğu
PATH'inden çözümler. Bu, uygulamadan 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 transkript sayfası okunur. Daha eski transkript öğelerini yükle, opak 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çeriği korunur. Node/Gateway güvenlik tavanından büyük olan tekil bir öğe, kesilmiş olarak açıkça işaretlenir.
Gateway'e yerel bir claude-cli satırında normal oluşturucuya metin yazmak,
sessions.catalog.continue çağrısını yapar. OpenClaw yerel katalog kaydını yeniden çözümler,
modele 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 yerel 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 duyurusunu yapar. OpenClaw, söz konusu node'daki katalog
kaydını 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 turda
o node'un Claude dosyalarını ve oturumunu kullanarak node'un gerçek claude -p işlemi çalıştırılır.
Node'un exec onay politikası uygulanmaya devam eder; Gateway 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 dışarıda bırakır, bir Gateway transkriptinden yeniden başlangıç vermez ve eklerle görselleri reddeder. Claude Desktop satırları salt görüntülenebilir olarak kalır. Yerel macOS uygulama node'ları da uygulama çalıştırma komutunu duyurana kadar salt görüntülenebilir olarak kalır.
Node komutu ve güvenlik sınırı için Node'lar: Claude oturumları ve transkriptleri bölümüne bakın.
Düşünme varsayılanları (Claude Opus 5, Sonnet 5, Mythos 5, Fable 5, 4.8 ve 4.6)
anthropic/claude-opus-5 varsayılan olarak high efor düzeyinde uyarlamalı düşünmeyi kullanır.
Düşünmeyi devre dışı bırakmak için /think off, modelin daha yüksek
yerel efor düzeyleri için ise /think xhigh|max kullanın. Anthropic bu modelde
bu istek özelliklerini desteklemediğinden OpenClaw, Opus 5 için manuel düşünme
bütçelerini, özel örnekleme parametrelerini, asistan ön doldurmalarını ve Priority Tier'ı
kullanmaz. Katalog; modelin 1.000.000 tokenlık bağlam penceresini, 128.000 tokenlık çıktı
sınırını, görüntü girdisini ve $5/$25 girdi/çıktı fiyatlandırmasını yayımlar.
anthropic/claude-sonnet-5 aynı uyarlamalı düşünme varsayılanlarını ve istek
kısıtlamalarını kullanır. 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 uyarlamalı düşünmeyi kullanır ve varsayılan eforu
high düzeyidir. Anthropic bu modelde düşünmenin devre dışı bırakılmasına
izin vermediğinden /think off ve /think minimal, bunun yerine
low efor düzeyine eşlenir. Anthropic, düşünmenin etkin olduğu herhangi
bir istekte sıcaklık geçersiz kılmasını reddettiğinden OpenClaw ayrıca Fable 5
isteklerinde özel sıcaklık değerlerini kullanmaz.
anthropic/claude-mythos-5, aynı sürekli etkin uyarlamalı 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 değerine eşler
ve çağıranın seçtiği örnekleme parametrelerini kullanmaz. 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, OpenClaw'da düşünmeyi varsayılan olarak kapalı tutar. Uyarlamalı
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-5": { params: { thinking: "high" }, }, }, }, },}Güvenlik reddi durumunda yedek modele geçiş (Claude Fable 5)
Bunun var olma nedeni
Fable 5 sınıflandırıcıları, kısıtlı alanlardaki isteklerde stop_reason: "refusal"
döndürür ve zararsız çalışmalara yakın konularda da yanlış pozitif sonuç verir
(güvenlik araçları, yaşam bilimleri veya modelden ham akıl yürütmesini 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 yönelik her doğrudan API anahtarı isteğinde OpenClaw, Anthropic'in sunucu tarafı yedek modele geçiş kabulünü gönderir:server-side-fallback-2026-06-01beta başlığı ilefallbacks: [{"model": "claude-opus-4-8"}]. Claude Opus 4.8, Anthropic'in Fable 5 için izin verdiği tek yedek hedeftir.- Yedek modele geçişi yalnızca güvenlik sınıflandırıcısının reddi tetikler. Hız sınırları, aşırı yüklenmeler ve sunucu hataları eskisiyle tamamen aynı şekilde 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ış ortasında ret durumunda, kısmi metin yedek modelin devam edeceğ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 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 sunabilir.
Gözlemlenebilirlik ve faturalandırma
- Yedek model tarafından yanıtlanan bir istek, asistan mesajında
fromModelvetoModeladlarını belirten birprovider_fallbacktanılaması kaydeder ve mesajınresponseModelalanıclaude-opus-4-8bildirir. - Anthropic her denemeyi ayrı ücretlendirir: çıktıdan önceki ret ücretsizdir ve kurtarma Claude Opus 4.8 tarifeleriyle ücretlendirilir (şu anda Fable 5 tarifelerinin yarısı). OpenClaw'ın istek başına maliyet tahmini, buna uygun olarak yedek model tarafından yanıtlanan istekleri Opus tarifeleriyle fiyatlandırır.
- Akış ortasındaki ret ayrıca Anthropic tarafında daha önce akışla gönderilmiş Fable bölümünü ücretlendirir; 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 hedefine karşı API anahtarı kimlik doğrulamasıyla
anthropic/claude-fable-5 için geçerlidir. OAuth (Claude CLI aboneliğinin yeniden kullanımı),
proxy temel URL'leri, Bedrock, Vertex ve Foundry istekleri değişmez ve bu ortamlarda
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, yedekler olmadan gönderildiğinde category: "reasoning_extraction" ile reddedilir;
aynı istem OpenClaw üzerinden gönderildiğinde ise provider_fallback tanılamasının
eklendiği, Opus tarafından yanıtlanan normal bir yanıt döndürür.
Temel davranış için Anthropic'in retler ve yedek modele geçiş kılavuzuna bakın.
İstem önbelleğe alma
OpenClaw, API anahtarı kimlik doğrulamasında 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ında otomatik 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" }, }, }, }, },}Aracı başına önbellek geçersiz kılmaları
Model düzeyindeki parametreleri temel değerleriniz olarak kullanın, ardından belirli aracıları agents.entries.*.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.entries.*.params(eşleşenid, anahtara göre geçersiz kılar)
Bu, bir aracının uzun ömürlü bir önbelleği korumasına, aynı modeldeki başka bir aracının ise ani yoğunluklu/düşük yeniden kullanımlı trafik için önbelleğe almayı devre dışı bırakmasına olanak tanır.
Bedrock Claude notları
- Bedrock'taki Anthropic Claude modelleri (
amazon-bedrock/*anthropic.claude*) yapılandırıldığındacacheRetentionaktarı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'taki 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 yönelik doğrudan API anahtarı trafiğinde 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 plugini, görüntü ve PDF anlama desteğini 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-5 |
| 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 Opus 5, 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, uyarlamalı düşünmeye 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 modelleri
otomatik olarak boyutlandırır; params.context1m gerekmez:
{ agents: { defaults: { models: { "anthropic/claude-opus-5": {}, "anthropic/claude-sonnet-5": {}, "anthropic/claude-mythos-5": {}, "anthropic/claude-opus-4-6": {}, }, }, },}Eski yapılandırmalar params.context1m: true değerini tutabilir; bu modeller için
zararsız ve etkisizdir ve OpenClaw artık kullanımdan kaldırılmış
context-1m-2025-08-07 beta başlığını hiçbir koşulda göndermez. Bu değere sahip eski
anthropicBeta yapılandırma girdileri, istek başlığı çözümlemesi sırasında
kaldırılır ve desteklenmeyen eski Claude modelleri normal bağlam pencerelerinde kalı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 aldığından parametre burada da isteğe bağlıdır.
Claude Opus 5 1M bağlamı
anthropic/claude-opus-5 ve 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 token 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ı agent başınadır; yeni agent'lar ana agent'ın anahtarlarını devralmaz. İlgili agent için ilk katılımı 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ı 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 değerini kontrol edin. Anthropic hız sınırı bekleme süreleri modele özgü olabilir; dolayısıyla 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ı.