OpenManus token sınırları ve Unknown BrowserUseTool hatası: biri mevcut, diğeri yok

OpenManus varsayılan olarak herhangi bir token sınırı uygulamaz. Kendi üst sınırı max_input_tokens olup, app/config.py dosyasında Optional olarak tanımlanır; varsayılan değeri None, açıklaması ise "Tüm isteklerde kullanılacak maksimum girdi token sayısı (sınırsız kullanım için None)" şeklindedir. Bu sınır, yazılımla birlikte sunulan yapılandırma örneklerinin hiçbirinde yer almaz. Dolayısıyla standart bir kurulum, kendiliğinden asla token sınırı hatası vermez — karşılaştığınız hata sağlayıcıdan kaynaklanır. Bu sınırı ayarladığınızda ise çoğu kişinin beklemediği iki davranış sergiler ve mevcut main sürümündeki bir kusur, hemen hata vermek yerine gecikmeli olarak hata vermesine neden olur.

Bu sayfanın ele aldığı diğer hata, Error: Unknown tool 'BrowserUseTool', aslında canlı bir hata değildir. Adını veren sınıf 15 Ağustos 2026'da OpenManus'tan silindi ve güncel Manus aracısı main üzerinde yerel olarak herhangi bir tarayıcı aracı kaydetmiyor. Her iki belirti de API anahtarı, uç nokta veya sağlayıcı sorunu değildir; base_url yönlendirmek de hiçbirini düzeltmez.

Öncesinde bir bağlam notu. Atıf yapılabilecek bir OpenManus sürümü yok: yalnızca üç etiket var, v0.1.0, v0.2.0 ve v0.3.0; bunların tamamı 10 Nisan 2025'te 34 saniyelik bir zaman aralığında yayımlandı ve o tarihten beri hiçbir şey etiketlenmedi; dolayısıyla herkes etiketsiz main çalıştırıyor. Kanonik depo FoundationAgents/OpenManus'dur — arşivlenmiş değil, MIT lisanslı, 58.371 yıldızlı ve son push 22 Ağustos 2026'da yapıldı (GitHub API, 21 Eylül 2026). Eski mannaandpoem/OpenManus yolunda artık yalnızca projenin taşındığını belirten bir README bulunuyor; bu nedenle 2025 eğitimlerinde alıntılanan dosya yolları ve satır numaraları artık orada bulunmayan kodu gösterir. Aşağıdaki her şey 21 Eylül 2026'da main dalındaki kaynak okunarak incelendi ve hiçbiri çalıştırılmadı.

Sahip olduğunuz dört mesajdan hangisi

Üçüncü satırı üreten dağıtım üç satırdan oluşur ve 2026 tarayıcı yeniden yazımından etkilenmemiştir: önce name = command.function.name, ardından if name not in self.available_tools.tool_map: return f"Error: Unknown tool '{name}'". İçinde tarayıcılara özgü hiçbir şey yoktur; bu nedenle modelin uydurduğu herhangi bir araç için aynı dize görünür.

Token sınırı isteğe bağlı, kümülatif ve yaklaşık bir değerdir

Üç farklı sayıya "token sınırı" denir ve hata mesajı yalnızca bunlardan biriyle ilgilidir.

İnsanları şaşırtan ikinci satırdır. LLM.check_token_limit(), app/llm.py içinde (self.total_input_tokens + input_tokens) <= self.max_input_tokens döndürür — bu, tek bir isteğe karşı kontrol değil, oturum için çalışan bir toplamdır. Bu nedenle uzun bir aracı çalıştırması, her tekil istek küçük olsa bile birikim yoluyla bu sınıra ulaşır ve hata metni hesabı açıkça belirtir: mevcut, gereken, maksimum. Varsayılan Manus aracısı max_steps = 20 ayarlar; her adım o ana kadarki konuşmayı yeniden gönderdiğinden kümülatif değer adım sayısından daha hızlı yükselir.

Sayım aynı zamanda OpenManus'un kendi tahminidir. LLM.__init__, tiktoken.encoding_for_model(self.model) işlevini çağırır ve KeyError durumunda cl100k_base kodlamasına geri döner; dolayısıyla tiktoken'ın hazır bir kodlama tanımı bulunmayan herhangi bir model kimliği — Claude veya Gemini kimliği ya da ağ geçidi ad alanlı bir kimlik — için uygulanan bütçe, sağlayıcının sayımı değil yaklaşık bir değerdir.

# config/config.toml
[llm]
model = "claude-sonnet-4-6"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

# The RESPONSE cap. Ships as 8192 in config.example.toml; the code default is 4096.
max_tokens = 8192

# The CUMULATIVE INPUT budget for the whole run. Absent from every shipped
# example, and None in code — so a stock install enforces no ceiling at all.
max_input_tokens = 400000

Bir üst sınırın parasal karşılığı

max_input_tokens kümülatif girişi sınırladığından, tek bir çalıştırmanın giriş tarafı için doğrudan bir maliyet üst sınırına dönüşür. Aşağıdaki rakamlar belirtilen üst sınır üzerinden yapılan örnek token hesabıdır; ölçülmüş görev maliyeti veya fatura üst sınırı değildir: ayar tarafından sınırlandırılan giriş tokenlarını, milyon başına güncel Kunavo kataloğu fiyatlarıyla ücretlendirir. Çıktı bu ayar tarafından hiç kapsanmaz — son sütun, örnek yapılandırmanın gönderdiği max_tokens = 8192 başına tek bir yanıtı fiyatlandırır; yirmi adımlı bir çalıştırma bunlardan yirmi tane üretebilir.

İki yorum. Üst sınır bir durdurucudur, bütçe değildir: çalıştırmanın giriş tarafının en fazla ne kadara mal olabileceğini söyler; görevin tamamlanıp tamamlanmadığı hakkında hiçbir şey söylemez. OpenManus tiktoken ile saydığı için uyguladığı üst sınır ile sağlayıcınızın faturalandırdığı tokenlar iki farklı ölçümdür — sayıyı kontrolden çıkan bir döngüyü sınırlayacak şekilde ayarlayın, ardından hesabınızın gerçekten kaydettiği değerle karşılaştırın. Kunavo kataloğundaki tutar, üst sınır değil faturalandırma tabanıdır: üst sistem ücretini bildirdiğinde fatura, katalog maliyeti ile geçerli kâr payı çarpanıyla çarpılmış üst sistem maliyetinden büyük olanıdır. Minimum Kunavo yüklemesi $10 ön ödemeli kredidir; bu bir finansman minimumudur, görev ücreti veya abonelik değildir — faturalandırma ayrıntılarına bakın.

Token hatası neden geç gelir?

Bu, mevcut main sürümünde okuyabileceğiniz bir kusurdur ve token sınırı hatasının takılma gibi görünmesinin nedenidir. app/llm.py içindeki üç @retry dekoratörü — ask, ask_with_images ve ask_tool üzerinde — aynı şekilde yazılmıştır:

Aşağı akıştaki aracı döngüsü bu yapıyla çelişmek yerine onu doğrular. app/agent/toolcall.py istisnayı yakalar ve isinstance(e.__cause__, TokenLimitExceeded) koşulunu test eder — tenacity tarafından oluşturulan RetryError istisnası, __cause__ alanının açılması yoluyla ele alınır; döngünün kendi günlük satırı da "Token limit error (from RetryError)" şeklindedir. Ancak bundan sonra kullanıcıya görünen "Maximum token limit reached, cannot continue execution" mesajını ekler ve aracı durumunu tamamlandı olarak ayarlar. Başka bir deyişle, tüketici kodu zaten dekoratör yorumunun gerçekleşmediğini söylediği yeniden denemeyi varsayar.

Birleştirilmiş bir düzeltme yok. "fix: prevent needless retry of TokenLimitExceeded and fix search engine fallback" başlıklı PR #1348, 10 Ağustos 2026'da birleştirilmeden kapatıldı; yeniden gönderimi #1407 ise 21 Eylül 2026'da hâlâ açık ve birleştirilmemişti. İlgili bağlam taşması PR'ı #1391, "add tool description token budget to prevent context overflow", 18 Ağustos 2026'da birleştirilmeden kapatıldı. Bakımcıların bunları neden kapattığı burada incelenmedi; yalnızca birleştirilmedikleri biliniyor. 17 Mart 2025 tarihli geçmiş raporu issue #779 "hitting token limit", 17 Eylül 2026'da bir etkinliksizlik botu tarafından state_reason: not_planned ile kapatıldı — bu bir zaman aşımıdır, çözüm değildir. Bunlardan biri birleştirilene kadar pratik önlemler, max_input_tokens parametresini ayarlamadan bırakıp fazla büyük istekleri sağlayıcının reddetmesine izin vermek veya bu parametreyi ayarlayıp gecikmeyi kabul etmektir.

Unknown tool 'BrowserUseTool', artık mevcut olmayan bir sürümden gelen bir hatadır

Issue #789, "Result: Error: Unknown tool 'BrowserUseTool'", 18 Mart 2025'te açıldı ve 21 Eylül 2026'da hâlâ açıktı; inactive olarak etiketlenmişti. Nedeni hiçbir zaman uç nokta veya anahtar değildi. Bildiren kişinin kendi günlüğü, modelin Python sınıf adını (BrowserUseTool) gönderdiğini, kayıtlı araç adının ise browser_use olduğunu gösteriyor; aynı çalıştırmanın bir sonraki adımında browser_use çağrıldığında dağıtım sorunsuz gerçekleşmiş. Yapıştırdığı günlük "Activating tool: 'browser_use'" satırında bitiyor ve kapanış cümlesi teşhisin tamamını veriyor: "BrowserUseTool seems not work, but browser_use can". Yorum yapanlardan verilen tek tavsiye daha güçlü bir model denemekti; araç çağırma doğruluğu sorunu için doğru yaklaşım budur.

Bu teşhis güncel main için geçerli değildir; çünkü artık doğru adlandırılması gereken browser_use adlı bir araç yoktur. 15 Ağustos 2026'da ab8dfe43 ("feat(browser): use Browser Use CLI 3.0") ve 05c5bbb1 ("refactor(browser): use CLI 3.0 MCP server") commit'leri yerel tarayıcı aracını sildi. main üzerindeki app/tool/ dizin listesinde browser_use_tool.py bulunmuyor; ağaçta BrowserUseTool dizesinin kalan tek örneği app/agent/sandbox_agent.py içindeki yorum satırıdır.

Dolayısıyla bugün bu tam dize için çözüm checkout'unuzu güncellemek ve eski depo yoluna göre yazılmış eğitimlerden çıkarım yapmayı bırakmaktır. Tahmin etmek yerine belirtilmesi gereken bir nokta: MCP bağlantısı başarısız olduğunda app/agent/manus.py günlükte Failed to connect to Browser Use CLI 3.0 yazar ve dört yerel araçla devam eder; bu da modelin kayıtlı olmayan bir tarayıcı aracını adlandırmasına olanak tanır. Bunun pratikte bir Unknown tool mesajı üretip üretmeyeceği ve hangi ad altında üretileceği burada gözlemlenmedi — bunu belgelenmiş bir belirti değil, bakılacak bir yer olarak değerlendirin. Ayrıca requirements.txt dosyasının uv>=0.6.0 sürüm kısıtını sabitlediğini unutmayın; normal bir kurulumun uvx komutunu PATH ortam değişkeninizde belirtilen bir konuma koyup koymadığı doğrulanmadı.

Arama sırasında karşınıza çıkabilecek ve yukarıdaki paragrafların özellikle iddia etmediği bir nokta daha var: depo, varsayılan yolun hiç yüklemediği tarayıcı kodunu gerçekten içeriyor. Ayrı Daytona sandbox giriş noktası sandbox_main.py, SandboxManus aracısını oluşturur; bu aracı app/tool/sandbox/sb_browser_tool.py dosyasından alınan SandboxBrowserTool aracını yerel araç olarak kaydeder — browser_use değil, sandbox_browser adıyla. Dolayısıyla "yerel tarayıcı aracı yok" ifadesi tüm ağaç için değil, main.py dosyasını çalıştırarak aldığınız varsayılan Manus aracısı için geçerlidir.

Arama sırasında ayrı tutmanız gereken bir ad: OpenManus/OpenManus-RL, ayrı bir kuruluştaki ayrı bir depodur; aracı çalışma zamanının bir sürümü değil, pekiştirmeli öğrenme araştırma projesidir ve dosya düzeninin her iki hatayla da ilgisi yoktur.

Farklı bir API uç noktası neyi değiştirir, neyi değiştirmez

Yukarıdaki her iki belirti de OpenManus içinde üretilir; bu nedenle "başka bir sağlayıcı bunu düzeltir mi?" sorusunun dürüst yanıtı hayırdır. Uç nokta seçiminin etkilediği şey, bu ikisiyle kolayca karıştırılabilecek yakın bir hata kümesidir.

Beşinci satırda, genel tavsiyeden ziyade bu uç noktaya özgü, birinci taraf bir ayrıntı var. Kunavo'nun dağıtıcısı, bu parametreleri desteklenmeyen olarak bildiren katalog modelleri için temperature, top_p ve top_k alanlarını iletmeden önce kaldırır — şu anda Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Opus 4.8, Claude Opus 4.7, Claude Sonnet 5 — ve bunu protokol geçişinde yaptığı için, bu alanların çıkarıldığı gövdeyi yeniden deneme girişimleri de görür. Diğer tüm modellerde alan, OpenManus'un gönderdiği şekilde iletilir. Bu, söz konusu modeller için belirli bir 400 hatasını ortadan kaldırır; OpenManus'un burada test edildiği anlamına gelmez. Kunavo, OpenManus'u çalışma zamanında test etmemiştir ve bu sayfadaki hiçbir şey uyumluluk sonucu değildir.

Tek bir hatayı ayıklamak yerine yolları değerlendiriyorsanız, OpenAI uyumlu API genel yolun neyi taşıyıp neyi taşımadığını, LLM ağ geçidi aileler arasında tek anahtarın ne zaman değerli olduğunu ve AI maliyet optimizasyonu listelenen en düşük fiyat ile bir görevi tamamlamanın en ucuz yolu arasındaki farkı ele alır — bir aracı döngüsünde karar verdiren ayrım budur. Başka bir istemcide aynı tür teşhis için OpenCode sağlayıcısı bulunamadı bölümüne bakın.

OpenManus'u onarmak yerine kuruyor musunuz? Uç nokta tarafı [llm] içinde üç alandır: model, base_url ve api_key. Hızlı başlangıçtan başlayın, istek biçimini sohbet tamamlamalarıyla karşılaştırın ve bir anahtara bakiye yüklemeye hazır olduğunuzda Kunavo hesabı oluşturun. Denerken çalışan bir yolu kullanılabilir tutun ve başka hiçbir şeyi değiştirmeden önce sınırlandırılmış bir görev çalıştırın.

Sık sorulan sorular

21 Eylül 2026'da ve daha geniş kapsam olmadan kontrol edildi: app/llm.py, app/config.py, app/agent/toolcall.py, app/agent/manus.py, app/agent/base.py, app/agent/sandbox_agent.py, app/tool/sandbox/sb_browser_tool.py, sandbox_main.py, app/exceptions.py, requirements.txt, config/config.example.toml ve main dalındaki README; app/tool/ dizin listesi; silinen tarayıcı aracının commit geçmişi; issue #779 ve #789'un GitHub kayıtları, yorumları ve #1348, #1391 ve #1407 pull request'leri; depo ve sürüm meta verileri; Anthropic'in model kullanımdan kaldırma sayfası. Hiçbir şey çalıştırılmadı — kurulum yok, OpenManus çalıştırması yok, her iki hatanın yeniden üretimi yok ve OpenManus üzerinden herhangi bir uç noktaya istek yok; dolayısıyla buradaki her davranış iddiası gözlemlenen bir hata değil kaynak okumasıdır ve hiçbiri gerçekleştirilmediği için başarılı bir minimum çalıştırma raporlanmamaktadır. Kunavo token fiyatları canlı katalogdan alınmıştır ve her dolar tutarı, ölçülmüş görev maliyeti değil örnek token hesabıdır.