IronClaw'da "Context budget exceeded" tek bir hata değildir. Dört farklı hata varyantı bu ifadeyi taşır; hiçbiri modelinizin bağlam penceresi değildir ve hiçbir yapılandırma dosyası, ortam değişkeni veya CLI bayrağı bunlardan herhangi birinin arkasındaki sayıyı değiştirmez. Bütçe, 20.000 token rezerviyle derleme sırasında sabitlenmiş 128.000 tokendir ve bu bütçeyi dolduran üç katman — kimlik dosyaları, beceri parçacıkları ve araç şemaları — bu sınırın üstüne eklenir, içine dahil edilmez; bu, bu sayfanın teorisi değil, IronClaw'ın kendi açık hata raporudur.
İsim kalabalık olduğu için bir ayrım yapalım. Buradaki proje github.com/nearai/ironclaw, NEAR AI'ın Rust tabanlı agent çalışma zamanıdır — kelimeyle ilgili ticari aramalara hâkim olan Corsair oyun faresi veya yine agent yazılımı satan ve kendisini OpenClaw ile karşılaştıran, konuyla ilgisiz ironclaw.tech şirketi değildir. IronClaw ve OpenClaw karşılaştırması bu ayrımı tam olarak açıklar. Aşağıdaki kaynak düzeyindeki tüm rakamlar, 21 Eylül 2026'da GitHub contents API üzerinden, main kaynağından b0b999d commit'inde okunmuştur (10 Eylül 2026'da commit edilmiştir). Bu commit, 28 Ağustos 2026'da yayımlanan ironclaw-v1.4.0 sürüm etiketinden daha yenidir. 1 Ekim 2026'da daha yeni ironclaw-v1.4.1 sürüm ikilisi (29 Eylül 2026'da yayımlanmış, notlarında bütçe değişikliği olmayan Google OAuth ve Wasmtime yaması) yerel bir test uç noktasına karşı çalıştırıldı; yaptığı şey aşağıda kaydedilmiş ve bu sürümle sınırlandırılmıştır; kaynak rakamları ise commit ile sınırlandırılmıştır.
Baktığınız "context budget exceeded" hangisi?
Bunlar Rust thiserror görüntüleme dizeleridir; günlüklerde ve hata ayrıntılarında görünenler bunlardır. Kesin ifadeyi okumak, hangi katmanın başarısız olduğunu gösterir.
| Kesin dize | Nerede oluşturulur | Onu tetikleyen şey |
|---|---|---|
skill context: context budget exceeded | ironclaw_loop_contracts/src/skill_context.rs | Tek bir beceri parçacığının model içeriği 64 KiB'den fazla olması veya tüm parçacıkların toplamının 256 KiB'yi aşması. Token değil bayt söz konusudur — ihlalde bulunanı çıkarmak yerine tüm beceri bağlamı oluşturma işlemi başarısız olur. |
skill context budget exceeded | ironclaw_loop_host/src/skill_bundle_context_source.rs | Herhangi bir token bütçelemesi yapılmadan önce sayılan 100 görünür beceri paketi adayından fazlası. Ana makine katmanı, yukarıdaki sözleşme düzeyi bayt hatasını eşlerken de bu ifadeyi yeniden üretir; dolayısıyla dize tek başına ikisini ayırt etmez. |
skill activation context budget exceeded | skill_activation/activation.rs | Bir turda 8 etkin beceriden fazlası veya tahmini maliyeti seçicinin kalan token bütçesini aşan bir beceri. Bu bütçe, seçicinin kendi varsayılanına göre 4.000, oluşturma çalışma zamanı dosya sistemi beceri kaynağını bağladığında ise 6.000'dir. |
identity context budget exceeded | ironclaw_loop_host/src/identity_context.rs | Bugün hiçbir şey. Kendi belge açıklamasında bunun "Reserved for a future hard-limit mode" olduğu ve oluşturucunun "truncates silently on budget overflow rather than returning this error" şeklinde çalıştığı belirtilir. |
Gerçek bir model taşması için kullanıcının gördüğü ifadede bu sözcüklerin hiçbiri bulunmaz. Ana makinenin yazdığı sabit hata cümlesi "The run failed because the model context was too large. Retry with a shorter request or start a new thread.", model ağ geçidinden sağlayıcıya eşlenen hata ise "model request exceeded its context budget" şeklindedir. İki uyarı: Bu sayfa uçtan uca bir çalıştırmanın izini sürmediğinden, bir beceri katmanı hatasının sonunda hangi kullanıcıya dönük cümleye dönüştüğü burada belirlenmemiştir. Ayrıca yaygın biçimde tekrarlanan "Model request context exceeds the available input budget" dizesi nearai/ironclaw içinde hiçbir yerde bulunmaz — farklı bir agent projesine aittir ve bu projeyi teşhis etmek için kullanılmamalıdır.
Yapılandıramayacağınız 128.000
PromptContextTokenBudget üç sabit sunar: 128.000 tokenlık bağlam sınırı, 20.000 tokenlık rezerv ve ana döngü için 0 olan maksimum çıktı değeri. Görünür kayıt dökümü sınırı, son iki değerden büyük olanın çıkarılmasıyla hesaplanır; yani 108.000 token — dosyadaki sabit bir değer değil, varsayılanlardan yapılan aritmetiktir. Üçüncü terim testler dışında hiçbir zaman atanmaz; bu nedenle rezerv her zaman sabit 20.000'dir. Depodaki test dışı her oluşturma işlemi düz PromptContextTokenBudget::default() biçimindedir — biri sıkıştırma stratejisinde, biri döngü sürücüsü ana makinesinin TextOnlyLoopHostConfig varsayılanında; farklı sayılar taşıyan her ::new(…) çağrısı bir #[cfg(test)] modülünün içindedir.
IronClaw'ın kendi #5739 sorunu bunu başlıkta söyler: "Effective context budget is a hardcoded 128K that ignores the model's context_length and has no config override" — 6 Temmuz 2026'dan beri açık ve 21 Eylül 2026'da hâlâ açıktı. Bundan üç tuzak çıkar:
budget.*anahtarları bu değildir. IronClaw'ın yapılandırma sayfası, "budget — cost controls" başlığı altındakibudget.user_daily_usd,budget.pause_atve benzerlerini belgeler; bunlar agent harcamalarını sınırlamak için kullanılır. Bunlar para ayarlarıdır (bunlardan ikisi,budget.overestimate_factorvebudget.default_tz, dolar tutarı değil çarpan ve saat dilimidir). Hiçbir düzeydeki anahtar bağlam sınırını, rezervi, kimlik üst sınırını veya beceri bütçesini ayarlamaz — yayımlanmış öncelik sırası da "compiled defaults < config.toml < environment variables < CLI flags" şeklindedir; dolayısıyla eksik bir anahtar her yerde eksiktir.- PR #5790 yanlış bir ipucudur. Başlığı "prompt-context budget override through host factory" önerir. API, bunu 27 Ağustos 2026'da
merged: falseile kapatılmış olarak bildirir. - Düzeltmelerin tümü öneridir. Aynı 20.000 rezervle modelin ilan edilen penceresinin %90'ını kullanacak olan #8053 ile #7976 ve #5435, kontrol edildiğinde hâlâ açıktı.
Üçüncü taraf bir uç nokta için ek bir adım vardır ve belirleyici olan da budur. ModelMetadata.context_length, bir Option'dır; LlmProvider trait'inin varsayılanı None döndürür — "Varsayılan davranış, boyut bilgisi olmadan model adını döndürür" — ve genel OpenAI uyumlu bağdaştırıcı herhangi bir geçersiz kılma tanımlamadığından bu varsayılanı devralır. Bu nedenle özel bir uç nokta hiçbir zaman pencere boyutu bildirmez. IronClaw, modeliniz bir milyon veya 32.000 token tutsa da 108.000 kayıt dökümü tokenı planlar ve #8053 tam olarak bu yolun hiç ayarlamadığı alanı okuyacaktır. Bu uç noktanın nasıl yapılandırıldığını görmek için IronClaw özel API kurulumu sayfasına bakın; bu sayfa bütçeye odaklanır.
Bütçeye dokunmadan istemi dolduran katmanlar
IronClaw'ın 3 Eylül 2026'da açılan ve kontrol edildiğinde hâlâ açık olan geliştirme sorunu #8057, mekanizmayı üreticinin kendi sözleriyle açıklar: istem bütçesi "yalnızca kayıt dökümünün boyutunu belirler", kimlik içeriği, beceri ve bellek parçacıkları, kanal bağlamı ve araç şemaları ise "kayıt dökümüne ayrılan bütçeyi azaltmadan bu bütçenin üzerine eklenir; dolayısıyla sağlayıcının aldığı istek, döngünün uyduğunu düşündüğü bütçeyi aşabilir." Bu bir hata raporudur, yayımlanmış sürümün davranışını belgeleyen bir metin değildir — ancak her bir katman kurallara uyuyor görünürken bir çalıştırmanın boyut nedeniyle başarısız olabilmesinin nedeni budur.
| Katman | Kendi üst sınırı | Üst sınırdaki davranış |
|---|---|---|
| Kayıt dökümü tokenları | Tahmini 108.000 | En yeniden başlayarak ilerler ve sığmayan ilk iletide break yaparak daha eski tüm iletileri düşürür. main üzerinde kasıtlıdır: ortadaki bir iletiyi atlamak "can orphan provider tool calls from their result references". |
| Kayıt dökümü iletileri | 128 | Token bütçelemesinden önce uygulanan ayrı bir sayım sınırı; bu nedenle kısa iletilerden oluşan uzun bir iş parçacığı 108.000'in çok altında olsa bile kesilir. |
| Kimlik dosyaları | Tahmini 8.000 | Ayrıca break yapar; bu nedenle ilk aşırı boyutlu adaydan sonraki her şey de sessizce düşürülür. Adaylar, SOUL.md, AGENTS.md, SYSTEM.md ve MEMORY.md dahil olmak üzere sabit 11 dosyalık izin listesinden gelir. |
| Beceri etkinleştirme | 8 yuva; seçici varsayılanına göre tahmini 4.000 token, oluşturma çalışma zamanı bağladığında 6.000 | Her iki durumda da skill activation context budget exceeded hatasını üretir |
| Beceri parçacığı baytları | Her biri 64 KiB, toplam 256 KiB | Kesin hata; tüm oluşturma başarısız olur |
| İlan edilen araçlar | Tahmini 12.000 token, 32 araç — veya pencere biliniyorsa model penceresinin onda biri; hangisi daha küçükse | Geri kalanını erteler. Moddan bağımsız olarak ilan edilen 27 çekirdek araç adını sınırlandırmaz. |
| Sabitlenmiş, kabul edilmiş görev | Tek başına 108.000'in içine sığmalıdır | Tamamen farklı hata sınıfı: accepted task exceeds the prompt context token budget, herhangi bir yeniden denemeden önce oluşturulur |
Araç katmanı ölçülebilirdir ve IronClaw bunu ölçer. 93 araçlık sentetik bir düzenek üzerindeki commit edilmiş kıyaslama, 22 araç ilan edilmişken tahmini şema tokenlarını 21.355'ten 3.843'e düşürdüğünü kaydeder — %82,0; depo içinde 2,0 puanlık sapma toleransı ve %50,0 tabanıyla korunur. Bu rakamlar burada çalıştırılarak üretilmedi; test dosyasından okundu — yayımlanan ikilinin ölçülen yükü yukarıdaki bölümde yer alır ve farklı bir yapıdadır: 93 araçlık düzenek değil, varsayılan araç kümesidir. Bunları, düzenek üzerindeki IronClaw iç karakter sayımı tahminleri olarak değerlendirin; kendi araç isteminiz olarak değil, sağlayıcının tokenizer sayımları olarak da değil. Doğru çıkarım yapıdır: aşamalı açıklama şemanın çoğunu kaldırır, ancak her açıklama modunda 27 çekirdek ad ilan edildiği için hiçbir ayarın ortadan kaldıramadığı birkaç bin tokenlık bir taban bırakır.
Yayımlanan 1.4.1 ikilisinin yaptığı
1 Ekim 2026'da checksum doğrulamalı ironclaw-v1.4.1 sürüm ikilisi, [llm.default] yuvasına sahip bir kapsayıcıda, openai_compatible sağlayıcısında, her isteği kaydeden yerel bir test sunucusuna yönlendirilerek çalıştırıldı. ironclaw repl üzerinden her çalıştırmada bir kısa ileti:
REBORN_TOOL_DISCLOSURE | İstekteki araç şemaları | Araç şemasının baytları |
|---|---|---|
ayarlanmamış, namespaces veya bridged | 26 — 23 yerleşik araç ile tool_search, tool_describe ve tool_call | 35.703 |
compact | 26 | 35.406 |
signatures | 26 | 35.435 |
off | 50 | 61.630 |
true — geçerli bir değer değil | 50 | 61.630, off ile aynı |
Dolayısıyla taban, yayımlanan derlemede gerçektir: hiçbir açıklama modu 26 şemadan az göndermedi ve IronClaw'ın token başına dört karakterlik kendi tahminine göre 35.703 bayt, sizden tek bir kelime gelmeden önce yaklaşık 8.900 token demektir — sistem ve kimlik iletileri de yaklaşık 24.000 bayt ekler. Bu, sağlayıcı token sayımı değil, baytlar üzerinden yapılan aritmetiktir. Aşağıda açıklanan yazım hatası tehlikesi çıkarım değil, doğrulanmış bir sonuçtur: true, ekranda bunu belirten hiçbir şey olmadan tam olarak off yükünü üretti ve araç istemini neredeyse iki katına çıkardı.
Kesin bütçe, kaynakta belirtildiği gibi devreye girdi. Yaklaşık 380.000 karakterlik bir ileti uç noktaya gönderildi; yaklaşık 460.000 karakterlik bir ileti — token başına dört karakter hesabıyla 108.000 tokenı aşan — makineden hiç ayrılmadı. REPL yalnızca Prompt aşamasını, BudgetExceeded türünü ve accepted task exceeds the prompt context token budget özetini belirten uyarı günlük satırlarını yazdırdı. Yapılandırmada veya ortamda bu sınırı değiştiren hiçbir ayar bulunamadı. Beceri katmanı hataları, gerçek bir modelin taşması ve Kunavo üzerinden yapılan herhangi bir istek çalıştırılmadı.
Yeniden denemek çözüm değildir; bir yazım hatası durumu daha da kötüleştirir
Varsayılan kurtarma stratejisi bağlam taşmasını iterasyon kapsamında tam olarak bir kez, ShrinkContext değişikliğiyle yeniden dener ve ardından işlemi durdurur — üreticinin kendi test adları model_context_overflow_compacts_once_then_aborts ve second_model_context_overflow_aborts_without_another_compaction şeklindedir. Bu nedenle aynı aşırı boyutlu istekte yeniden denemeye basmak başarılı olamaz. Ölçek açısından aynı stratejinin varsayılanları max_model_availability_attempts: 12 ve max_attempts_per_class: 2 değerlerine izin verir; bu sınıf için tek ShrinkContext denemesi yapılır.
Sıkıştırma daha erken de kurtaramaz: tetikleme eşiği aynı 108.000'dir; dolayısıyla kayıt dökümü bu değere ulaşmadan önce hiçbir şey sıkıştırmayı zorlamaz. Zorunlu ve kurtarma sıkıştırmaları devre kesiciyi aşar; bu, döngünün yeniden denemeden önce aşırı boyutlu bir istemi küçültmesinin tek yoludur. Alternatif strateji için bir uyarı: 3 Temmuz 2026'dan beri açık olan #5582 sorunu, ActiveTaskPreservingCompactionStrategy stratejisinin taşma bayrağını hiç okumadığını bildirir. Belirli bir dağıtımın hangi stratejiyi seçtiği burada izlenmedi.
Her şeyden önce kontrol edilmesi gereken bir yapılandırma tehlikesi vardır. Aşamalı araç açıklaması REBORN_TOOL_DISCLOSURE değişkeninden okunur, off | compact | signatures | namespaces | bridged değerlerini kabul eder ve ayarlanmamış veya boş olduğunda varsayılan olarak namespaces değerini kullanır. Boş olmayan herhangi bir başka değer — bir yazım hatası, eskiden kalmış true veya on — sessizce Off değerine dönüşür; aynı dosyada bu değer "Kontrol kolu: yetkilendirilmiş her şemayı ilan et." şeklinde belgelenmiştir. UTF-8 olmayan bir değer de aynı sonucu verir. Tek sinyal bir tracing::debug! satırıdır ve bunun etkisi önemli ölçüde daha büyük bir araç istemidir. Yazımını tahmin etmek yerine değişkeni kaldırın.
Bugün gerçekten değiştirebileceğiniz şeyler
Bağlam bütçesini, sıkıştırmayı veya bu dört hatadan herhangi birini kapsayan yayımlanmış bir IronClaw belgeleri sayfası yoktur; bu nedenle aşağıdaki kaldıraçlar, docs ve kodun birlikte desteklediği şeylerdir — üretici tarafından onaylanmış bir çözüm değildir.
Beceri bağlamı baskısını azaltan belgelenmiş tek kaldıraç, ortam değişkeni değil bir yapılandırma bayrağıdır. IronClaw'ın beceriler sayfası, bunu [skills] altında ayarlamanızı söyler ve anahtar kelime ve etiket etkinleştirmenin yanı sıra açık $my-skill ifadelerinin de becerileri eklemeye devam ettiğini belirtir:
[skills]
# Documented lever: stops regex auto-activation from loading full skill
# context. Keyword/tag activation and $my-skill mentions still inject skills.
regex_activation_enabled = falseSınırları belirtilmiş üç seçenek daha vardır. Bir becerinin max_context_tokens frontmatter alanı aynı belgeler sayfasına göre varsayılan olarak 2000'dir; ancak buraya küçük bir sayı yazmak büyük bir beceriyi küçültmez: gövde tahmini bildirilen değerin iki katından fazlaysa seçici "using actual estimate" şeklinde günlük kaydı tutar ve ölçülen boyutu hesaba katar. Tepkisel bir rutin, allowed_tools üzerinden araç yüzeyini daraltabilir; bu yalnızca o rutine uygulanır, etkileşimli turlara değil. Dosya araçları ancak ALLOW_LOCAL_TOOLS=true olduğunda açıktır: IronClaw'ın dosya araçları belgeleri, "barındırılan veya paylaşılan ortamlarda dosya sistemine yanlışlıkla erişilmesini önlemek" amacıyla varsayılan olarak devre dışı olduklarını söyler; dolayısıyla kapalı bırakılmaları istemde bir şema kümesi daha az olması demektir. Bu üç seçeneğin hiçbiri 128.000'e dokunmaz.
Son olarak, güncelliğini yitirmiş bir sayıya göre plan yapmayın. #7485 sorunu, 108.000 tokenlık bütçenin ASCII içeriği için "fiilen yaklaşık 54 bin gerçek token" olduğunu ve sıkıştırmanın "yaklaşık 2 kat erken" devreye girdiğini bildirdi. Bu, iki token tahmincisinden birindeki çift sayımdı. PR #7502 bunları birleştirdi ve 11 Ağustos 2026'da birleştirildi; GitHub compare API, birleştirme commit'ini v1.3.0 ve v1.4.0 etiketlerinin içinde ve main içinde gösterir. v1.2.0 ve v1.1.0 ile karşılaştırıldığında sonuç "diverged" olur; bu nedenle onu içeren en erken sürüm belirlenememiştir — v1.3.0 ve sonrasını söyleyin. Geçerli tek tahminci ASCII karakterlerini token başına 4 karakter, 3 baytlık ASCII dışı karakterleri ise yaklaşık 1,5 token olarak hesaplar; bu da CJK ağırlıklı bir kayıt dökümünün 108.000'i İngilizce bir dökümden çok daha hızlı dolduracağı anlamına gelir.
Tavanın tur başına maliyeti ve hangi yolun kazandığı
Bu, ölçülmüş bir görev maliyeti veya fatura tavanı değil, açıklayıcı token aritmetiğidir. Maksimum yüklenmiş tek bir tur varsayın: 108.000 tokenlık tavandaki kayıt dökümü, 8.000 kimlik tokenı, 4.000 beceri bağlamı tokenı (seçicinin varsayılan bütçesi; 6.000 bağlayan oluşturulmuş bir çalışma zamanı bunu artırır) ve yukarıda kaydedilen kıyaslamadan 3.843 ilan edilmiş araç şeması tokenı — 123.843 tahmini giriş tokenı — ayrıca 2.000 çıkış tokenı. Bunlar IronClaw'ın sentetik bir düzenek üzerindeki kendi tahminleridir; dolayısıyla gerçek bir sağlayıcı tokenizer'ı farklı sonuç verecektir. Oranlar, milyon token başına güncel Kunavo kataloğu fiyatlarıdır.
| Model | 1 milyon başına giriş / çıkış | Tahmini maliyet, tam tavanlı tek tur | Açıklama Off'a geri dönerse tur başına eklenen |
|---|---|---|---|
| Claude Haiku 4.5 | $0,70 / $3,50 | $0,094 | +$0,012 |
| GPT-5.6 Terra | $0,70 / $4,20 | $0,095 | +$0,012 |
| Claude Sonnet 4.6 | $2,10 / $10,50 | $0,281 | +$0,037 |
| Claude Opus 5 | $3,50 / $17,50 | $0,468 | +$0,061 |
Bu bölümün amacı son sütundur. Yanlış yazılmış bir REBORN_TOOL_DISCLOSURE, her tura 17.512 tahmini giriş tokenı ekler — Claude Sonnet 4.6 üzerinde bu, başka hiçbir şey değişmeden önce tur başına $0,037 demektir ve sürekli açık bir agent günde birçok tur çalıştırır. İkinci çıkarım, bundan kaçmak için uzun bağlamlı bir modelin ücretini ödemenin işe yaramadığıdır: IronClaw, pencere ne olursa olsun kendi sayısına göre oluşturur; dolayısıyla ek pencere hiçbir şey kazandırmazken daha yüksek oran tüm 123.843 tokenları üzerinden ücretlendirilir. Bunlardan herhangi birini bütçe olarak değerlendirmeden önce kendi günlük tur sayınızla çarpın.
| Yol | Yayımlanan fiyat | Şu durumda avantajlıdır |
|---|---|---|
| Kendi barındırdığınız IronClaw | $0 yazılım; README rozeti "License: MIT OR Apache-2.0" yazarken GitHub API'sinin tek lisans alanı Apache-2.0 bildirir | Uç noktanın kontrolü sizde olsun istiyorsunuz. Başlamak için veritabanı sunucusu gerekmez — depolama belgeleri durumun varsayılan yerel profil altında gömülü dosyalarda tutulduğunu ve PostgreSQL'in sunulan veya çok kullanıcılı dağıtımlar için tercih edilmesi gerektiğini söyler. |
| Doğrudan sağlayıcı API'si | Üreticinin token başına oranları | Tüm gün tek bir aile ve o üreticinin kendi önbelleklemesini istiyorsunuz |
| OpenAI uyumlu bir gateway | Ağ geçidinin token başına oranları | Göreve göre aileleri değiştiriyor ve tek anahtar istiyorsunuz — hiçbir pencerenin ilan edilmediğini kabul ederek; bu yol için herhangi bir ağ geçidinde durum böyledir |
| ironclaw.com Starter | 5 ABD doları üzeri çizilmiş ve 0 ABD doları/ay olarak, "5 ABD doları kredi dahil", 1 agent örneği şeklinde gösterilir | Barındırılan yolu deniyorsunuz. Bunu kalıcı bir $0 planı değil, tanıtım olarak değerlendirin |
| ironclaw.com Basic | 20 ABD doları/ay, "20 ABD doları kredi dahil", en fazla 2 agent örneği, kullanım havuzlama | Krediyi paylaşan iki dağıtım |
| ironclaw.com Pro+ | 200 ABD doları/ay, "200 ABD doları kredi dahil", en fazla 5 agent örneği, gelişmiş modellere erken erişim, öncelikli destek | En üst barındırılan katman |
| Yerel model | İstek başına ücret yok; bunun yerine donanım | Küçük veya özel işler — ancak küçük bir yerel pencerede bile IronClaw'ın yine 108.000 token oluşturacağını unutmayın |
Barındırılan plan satırları 21 Eylül 2026'da ironclaw.com sitesinden okunmuştur; ironclaw.com/pricing HTTP 404 döndürdüğünden planlar ana sayfada yer alır. Her üç kartın üzerindeki başlık "Spin up to 5 agents in a Trusted Execution Environment with up to 130M tokens per month" şeklindedir — beş agent Pro+ için maksimum olduğundan bu başlık tek bir kartın değil, en üst planın sınırını belirtir ve 130 milyon tokenlık rakam hiçbir kartta görünmez. Dahil edilen kredilerin kaç tokene dönüştüğü ve tükendiğinde ne olduğu yayımlanmamıştır; burada da tahmin edilmemiştir.
Kunavo embedding, metinden konuşmaya veya konuşmadan metne modeli sunmaz; bu nedenle kurulumunuzdaki herhangi bir alma veya ses adımı dışarıdaki bir sağlayıcıyı çağırmalıdır.
Deneyin, ardından ücreti okuyun
IronClaw'ı OpenAI uyumlu bir ağ geçidine yönlendirirseniz, Kunavo'nun chat-completions uç noktası, openai_compatible sağlayıcı kimliğinin beklediği biçimdir. Bu, her iki tarafın belgelerinden okunan bir protokol eşleşmesidir — yukarıdaki 1 Ekim çalıştırması Kunavo'yu değil, yerel bir test sunucusunu kullandı; bu nedenle Kunavo herhangi bir uyumluluk iddiasında bulunmaz. Çalışan bir yönlendirme kullanılabilir durumda tutun, sınırlandırılmış tek bir görev çalıştırın ve IronClaw'ın görüntülediği kendi aritmetiğine değil, hesabınızın kaydettiği kullanıma göre mutabakat yapın. Kunavo katalog tutarı bir üst sınır değil, faturalandırma tabanıdır: üst akış ücretini bildirdiğinde fatura, katalog maliyeti ile üst akış maliyetinin geçerli çarpanla çarpımından büyük olanıdır. Ön ödemeli kredide minimum yükleme $10 tutarındadır — bu bir finansman minimumudur; görev ücreti veya abonelik değildir; hazır olduğunuzda faturalandırma ayrıntılarına bakın ve bir anahtara fon sağlamak için hesap oluşturun. İlgili seçenekler için AI maliyet optimizasyonu, tamamlanan görev başına maliyeti ölçmeyi ele alır; PicoClaw ve ZeroClaw ise döngü uzunluğunun aynı şekilde bir maliyet kaldıracı olduğu iki kardeş çalışma zamanını ele alır.
Sık sorulan sorular
IronClaw'da "context budget exceeded" ne anlama gelir?
Bu tek bir hata değildir. nearai/ironclaw içindeki dört ayrı Rust hata varyantı bu ifadeyi taşır: bir beceri parçacığının model içeriği 64 KiB'yi veya tüm parçacıkların toplam model içeriği 256 KiB'yi aştığında "skill context: context budget exceeded"; 100'den fazla görünür beceri paketi adayı olduğunda oluşturulan ve ana makine katmanı bu bayt hatasını yeniden eşlediğinde de kullanılan "skill context budget exceeded"; bir turda 8'den fazla etkin beceri olduğunda veya bir becerinin tahmini maliyeti seçicinin kalan token bütçesini aştığında — seçicinin kendi varsayılanı 4.000, bileşim çalışma zamanı dosya sistemi beceri kaynağını bağladığında 6.000 — "skill activation context budget exceeded"; ve kimlik hattı bunun yerine sessizce kırpma yaptığı için bir kaynak yorumunda gelecekteki bir kesin sınır modu için ayrıldığı belirtilen "identity context budget exceeded". Bu dört varyantın hiçbiri modelin bağlam penceresi değildir. 21 Eylül 2026'da b0b999d commit'inde ana daldan okundu.
IronClaw'ın bağlam bütçesini nasıl artırırım?
Yeniden derlemeden artıramazsınız. İstem bağlamı bütçesi, 20.000 token rezerve sahip derleme içine gömülü 128.000 token sınırıdır; depodaki test dışı her oluşturma düz bir varsayılandır ve bunun için hiçbir config anahtarı, ortam değişkeni veya CLI bayrağı yoktur. IronClaw'ın 6 Temmuz 2026'dan beri açık olan kendi issue #5739'u da başlığında aynı şeyi söyler. Yapılandırma sayfasındaki budget.* anahtarları bağlam token'ları değil, para üzerindeki maliyet kontrolleridir ve [skills] yapılandırma bölümü Rust config struct'ında tam olarak tek bir alan taşır: regex_activation_enabled. Başlığı istem-bağlamı bütçesi geçersiz kılmasını vaat eden PR #5790, 27 Ağustos 2026'da birleştirilmeden kapatıldı — çözüm olarak ona atıfta bulunmak terk edilmiş bir çalışmaya atıfta bulunmaktır. Tüm durumlar 21 Eylül 2026'da kontrol edildi.
Daha büyük bağlam penceresine sahip bir model bunu düzeltir mi?
Özel bir OpenAI uyumlu uç noktada hayır. IronClaw istemini modelden değil, kendi derleme içine gömülü sayısından boyutlandırır ve genel bir uç nokta ona aksi yönde bilgi vermez: ModelMetadata.context_length bir Option'dır, LlmProvider trait varsayılanı "Default returns the model name with no size info" yorumuyla None döndürür ve genel OpenAI uyumlu bağdaştırıcı herhangi bir geçersiz kılma tanımlamaz; dolayısıyla bu None'u devralır. IronClaw'ı milyon token'lık bir modele yönlendirin, yine 108.000 transkript token'ı için plan yapar; küçük bir yerel modele yönlendirin, 108.000 token'lık istek oluşturur ve sağlayıcının isteği reddetmesine izin verir. Birleştirilmemiş PR #8053 bütçeyi ilan edilen pencereden türetecekti; bu yolun hiçbir zaman ayarlamadığı alan tam olarak budur. 21 Eylül 2026'da b0b999d commit'inde okundu.
IronClaw limite ulaşılmadan önce neden önceki iletileri atıyor?
Token bütçesinden önce iki sınırlayıcı çalışır. Ayrı bir 128 iletilik üst sınır, transkript taramasına uygulanır; bu nedenle kısa iletilerden oluşan uzun bir ileti dizisi, token ödeneğinin çok altında olsa bile sayı nedeniyle kesilebilir. Ardından transkript seçimi en yenilerden başlayarak ilerler ve sığmayan ilk iletide durur; o iletiyi atlamak yerine daha eski her iletiyi düşürür — ana dalda bu, kasıtlı ve belgelenmiş bir tercihtir; yorumda, ortadaki bir iletiyi atlamanın "sağlayıcı araç çağrılarını sonuç referanslarından koparabileceği" açıklanır. IronClaw issue #7485 bunun yerine atlamayı önerdi; bu öneri kabul edilmedi. 21 Eylül 2026'da b0b999d commit'inde okundu.
SKILLS_MAX_TOKENS ayarlamak beceri bütçesini değiştirir mi?
Hayır ve bu, bilinmesi gereken belgelenmiş bir çelişkidir. IronClaw'ın Çince beceriler belgeleri SKILLS_MAX_TOKENS=4000 okuyan bir kod bloğu yayımlar ve bütçe tükenene kadar becerilerin seçilmesini açıklar. İngilizce beceriler sayfası değişkenden hiç bahsetmez ve IronClaw'ın depodaki kendi kurallar dosyası "eski SKILLS_MAX_TOKENS env var'ının hiçbir şey tarafından okunmadığını" belirtir. 21 Eylül 2026'da depo genelinde yapılan GitHub kod araması üç dosya döndürdü: söz konusu kurallar dosyası, Çince belgeler sayfası ve bir dahili animasyon betiği — Rust yok. Gerçekte yürürlükte olan değer derleme içine gömülüdür: DEFAULT_MAX_SKILL_CONTEXT_TOKENS, seçicinin varsayılanı olarak 4000'dür ve composition runtime dosya sistemi beceri kaynağını 6000 olarak bağlar. Her iki durumda da değer yalnızca yeniden derlemeyle değişir.
Aynı isteği yeniden denemek yardımcı olur mu?
Hayır. IronClaw'ın varsayılan kurtarma stratejisi, model bağlamı taşmasını iterasyon kapsamında, ShrinkContext değişikliğiyle tam olarak bir kez yeniden dener ve ikinci taşmada işlemi durdurur — üreticinin kendi test adları model_context_overflow_compacts_once_then_aborts ve second_model_context_overflow_aborts_without_another_compaction şeklindedir. Görünür kayıt dökümü sınırından daha büyük olan sabitlenmiş, kabul edilmiş görev iletisi de bu aşamaya ulaşamaz: "accepted task exceeds the prompt context token budget" iletisini taşıyan farklı bir hata sınıfıyla hemen başarısız olur. İsteği kısaltın veya yeni bir iş parçacığı başlatın; IronClaw'ın kullanıcıya gösterdiği kendi hata cümlesi de bunu yapmanızı söyler. 21 Eylül 2026'da b0b999d commit'inde okunmuştur.
1 Ekim 2026'da çalıştırıldı: ironclaw-v1.4.1 sürüm ikilisi, yerel bir test sunucusuna karşı — yukarıdaki açıklama tablosu ve bütçe probu; #5739, #8053, #8057, #7976 ve #5435 için sorun durumları aynı gün yeniden kontrol edildi ve tümü hâlâ açıktı. 21 Eylül 2026'da kontrol edildi. Kaynak sabitleri, hata dizeleri, kurtarma stratejisi, token tahmincisi, açıklama modları ve karşılaştırma ölçütü, GitHub contents API aracılığıyla main nearai/ironclaw deposundan b0b999d commit'inde; sorun ve pull request durumları GitHub issues API aracılığıyla; docs.ironclaw.com üzerindeki beceriler, yapılandırma, depolama ve dosya araçları sayfaları ile ironclaw.com üzerindeki plan kartları doğrudan getirilerek okundu. v1.4.0 sürüm etiketi checkout edilmedi, hiçbir IronClaw örneği çalıştırılmadı, depodaki hiçbir test yürütülmedi, dört hatanın hiçbiri tetiklenerek yeniden oluşturulmadı ve Kunavo IronClaw'ı çalışma zamanında test etmedi. Kunavo token ücretleri canlı katalogdan alınmıştır ve her dolar tutarı örnek amaçlı token aritmetiğidir.