Belirteç kullanımı ve maliyetler

OpenClaw karakterleri değil, tokenları izler. Tokenlar modele özeldir, ancak çoğu OpenAI tarzı model İngilizce metin için token başına ortalama ~4 karakter kullanır.

Sistem istemi nasıl oluşturulur

OpenClaw her çalıştırmada kendi sistem istemini birleştirir. Şunları içerir:

• Araç listesi + kısa açıklamalar
• Skills listesi (yalnızca meta veriler; talimatlar gerektiğinde read ile yüklenir). Yerel Codex turları, kompakt Skills bloğunu tur kapsamlı iş birliği geliştirici talimatları olarak alır; diğer harness'lar bunu normal istem yüzeyinde alır. Bu, skills.limits.maxSkillsPromptChars ile sınırlandırılır ve agents.list[].skillsLimits.maxSkillsPromptChars konumunda isteğe bağlı ajan bazlı geçersiz kılma içerir.
• Kendi kendini güncelleme talimatları
• Çalışma alanı + bootstrap dosyaları (AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md yeni olduğunda, ayrıca mevcut olduğunda MEMORY.md). Yerel Codex turları, bu çalışma alanı için bellek araçları kullanılabildiğinde yapılandırılmış ajan çalışma alanından ham MEMORY.md yapıştırmaz; bunun yerine tur kapsamlı iş birliği geliştirici talimatlarına küçük bir bellek işaretçisi ekler ve gerektiğinde bellek araçlarını kullanır. Araçlar devre dışıysa, bellek araması kullanılamıyorsa veya etkin çalışma alanı ajan bellek çalışma alanından farklıysa, MEMORY.md normal sınırlı tur bağlamı yolunu kullanır. Küçük harfli kök memory.md enjekte edilmez; MEMORY.md ile eşleştirildiğinde openclaw doctor --fix için eski onarım girdisidir. Büyük enjekte edilen dosyalar agents.defaults.bootstrapMaxChars (varsayılan: 20000) tarafından kısaltılır ve toplam bootstrap enjeksiyonu agents.defaults.bootstrapTotalMaxChars (varsayılan: 60000) ile sınırlandırılır. memory/*.md günlük dosyaları normal bootstrap isteminin parçası değildir; sıradan turlarda bellek araçları üzerinden isteğe bağlı kalırlar, ancak sıfırlama/başlatma model çalıştırmaları, o ilk tur için yakın tarihli günlük bellek içeren tek seferlik bir başlatma bağlamı bloğunu başa ekleyebilir. Yalın sohbet /new ve /reset komutları model çağrılmadan onaylanır. Başlatma girişi agents.defaults.startupContext tarafından kontrol edilir. Compaction sonrası AGENTS.md alıntıları ayrıdır ve açık agents.defaults.compaction.postCompactionSections katılımı gerektirir.
• Zaman (UTC + kullanıcı saat dilimi)
• Yanıt etiketleri + Heartbeat davranışı
• Çalışma zamanı meta verileri (host/OS/model/thinking)

Tam dökümü Sistem İstemi bölümünde görün.

Kimlik bilgilerini veya kimlik doğrulama parçacıklarını belgelendirirken, yalnızca dokümantasyon değişikliklerinde secret-scanner hatalı pozitiflerini önlemek için Gizli Yer Tutucu Kuralları kullanın.

Bağlam penceresinde neler sayılır

Modelin aldığı her şey bağlam sınırına dahil edilir:

• Sistem istemi (yukarıda listelenen tüm bölümler)
• Konuşma geçmişi (kullanıcı + asistan mesajları)
• Araç çağrıları ve araç sonuçları
• Ekler/transkriptler (görüntüler, ses, dosyalar)
• Compaction özetleri ve budama yapıtları
• Sağlayıcı sarmalayıcıları veya güvenlik başlıkları (görünür değildir, ancak yine de sayılır)

Bazı çalışma zamanı açısından ağır yüzeylerin kendi açık sınırları vardır:

• agents.defaults.contextLimits.memoryGetMaxChars
• agents.defaults.contextLimits.memoryGetDefaultLines
• agents.defaults.contextLimits.toolResultMaxChars
• agents.defaults.contextLimits.postCompactionMaxChars

Ajan bazlı geçersiz kılmalar agents.list[].contextLimits altında bulunur. Bu ayarlar, sınırlı çalışma zamanı alıntıları ve enjekte edilen çalışma zamanı sahipli bloklar içindir. Bootstrap sınırlarından, başlatma bağlamı sınırlarından ve Skills istem sınırlarından ayrıdır.

toolResultMaxChars gelişmiş bir üst sınırdır (1000000 karaktere kadar). Ayarlanmadığında OpenClaw, etkin model bağlam penceresinden canlı araç sonucu sınırını seçer: 100K tokenın altında 16000 karakter, 100K+ tokenda 32000 karakter ve 200K+ tokenda 64000 karakter; yine de çalışma zamanı bağlam payı korumasıyla sınırlıdır.

Görüntüler için OpenClaw, sağlayıcı çağrılarından önce transkript/araç görüntü yüklerini küçültür. Bunu ayarlamak için agents.defaults.imageMaxDimensionPx (varsayılan: 1200) kullanın:

• Daha düşük değerler genellikle görsel token kullanımını ve yük boyutunu azaltır.
• Daha yüksek değerler OCR/UI ağırlıklı ekran görüntüleri için daha fazla görsel ayrıntıyı korur.

Pratik bir döküm için (enjekte edilen dosya, araçlar, Skills ve sistem istemi boyutu başına), /context list veya /context detail kullanın. Bkz. Bağlam.

Geçerli token kullanımını görme

Sohbette şunları kullanın:

• /status → oturum modeli, bağlam kullanımı, son yanıt giriş/çıkış tokenları ve etkin model için yerel fiyatlandırma yapılandırıldığında tahmini maliyet içeren emoji ağırlıklı durum kartı.
• /usage off|tokens|full → her yanıta yanıt başına kullanım alt bilgisi ekler.
  • Oturum başına kalıcıdır (responseUsage olarak saklanır).
  • /usage reset (takma adlar: inherit, clear, default) — oturumun yapılandırılmış varsayılanı yeniden devralması için oturum geçersiz kılmasını temizler.
  • /usage tokens tur token/önbellek ayrıntılarını gösterir.
  • /usage full kompakt model/bağlam/maliyet ayrıntılarını gösterir; tahmini maliyet yalnızca OpenClaw kullanım meta verilerine ve etkin model için yerel fiyatlandırmaya sahip olduğunda görünür. Özel messages.usageTemplate düzenleri token/önbellek alanlarını içerebilir.
• /usage cost → OpenClaw oturum günlüklerinden yerel bir maliyet özeti gösterir.

Diğer yüzeyler:

• TUI/Web TUI: /status + /usage desteklenir.
• CLI: openclaw status --usage ve openclaw channels list, normalleştirilmiş sağlayıcı kota pencerelerini gösterir (X% left, yanıt başına maliyetleri değil). Geçerli kullanım penceresi sağlayıcıları: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi ve z.ai.

Kullanım yüzeyleri, görüntülemeden önce yaygın sağlayıcıya özgü alan takma adlarını normalleştirir. OpenAI ailesi Responses trafiği için bu hem input_tokens / output_tokens hem de prompt_tokens / completion_tokens içerir; böylece taşıma katmanına özgü alan adları /status, /usage veya oturum özetlerini değiştirmez. Gemini CLI kullanımı da normalleştirilir: varsayılan stream-json ayrıştırıcı asistan message olaylarını okur ve CLI açık bir stats.input alanı sağlamadığında stats.cached, cacheRead alanına eşlenir ve stats.input_tokens - stats.cached kullanılır. Eski JSON geçersiz kılmaları yanıt metnini hâlâ response üzerinden okur. Yerel OpenAI ailesi Responses trafiği için WebSocket/SSE kullanım takma adları da aynı şekilde normalleştirilir ve total_tokens eksik veya 0 olduğunda toplamlar normalleştirilmiş giriş + çıkış değerine geri döner. Geçerli oturum anlık görüntüsü seyrek olduğunda, /status ve session_status en son transkript kullanım günlüğünden token/önbellek sayaçlarını ve etkin çalışma zamanı model etiketini de kurtarabilir. Mevcut sıfır olmayan canlı değerler yine de transkript geri dönüş değerlerine göre önceliklidir ve saklanan toplamlar eksik veya daha küçük olduğunda daha büyük istem odaklı transkript toplamları kazanabilir. Sağlayıcı kota pencereleri için kullanım kimlik doğrulaması, kullanılabildiğinde sağlayıcıya özgü hook'lardan gelir; aksi takdirde OpenClaw, auth profillerinden, env'den veya yapılandırmadan eşleşen OAuth/API-key kimlik bilgilerine geri döner. Asistan transkript girdileri, etkin model için fiyatlandırma yapılandırıldığında ve sağlayıcı kullanım meta verileri döndürdüğünde usage.cost dahil olmak üzere aynı normalleştirilmiş kullanım şeklini kalıcılaştırır. Bu, canlı çalışma zamanı durumu ortadan kalktıktan sonra bile /usage cost ve transkript destekli oturum durumu için kararlı bir kaynak sağlar.

OpenClaw sağlayıcı kullanım muhasebesini geçerli bağlam anlık görüntüsünden ayrı tutar. Sağlayıcı usage.total, önbelleğe alınmış giriş, çıkış ve birden fazla araç döngüsü model çağrısını içerebilir; bu yüzden maliyet ve telemetri için yararlıdır ancak canlı bağlam penceresini olduğundan fazla gösterebilir. Bağlam görünümleri ve tanılamalar, context.used için en son istem anlık görüntüsünü (promptTokens veya istem anlık görüntüsü yoksa son model çağrısını) kullanır.

Maliyet tahmini (gösterildiğinde)

Maliyetler model fiyatlandırma yapılandırmanızdan tahmin edilir:

models.providers.<provider>.models[].cost

Bunlar input, output, cacheRead ve cacheWrite için 1M token başına USD değerleridir. Fiyatlandırma eksikse /usage full maliyeti atlar; her yanıtta token/önbellek ayrıntılarına ihtiyacınız olduğunda /usage tokens veya özel bir messages.usageTemplate kullanın. Maliyet görünümü API-key auth ile sınırlı değildir: aws-sdk gibi API-key dışı sağlayıcılar, yapılandırılmış model girdileri yerel fiyatlandırma içerdiğinde ve sağlayıcı kullanım meta verileri döndürdüğünde tahmini maliyet gösterebilir.

Sidecar'lar ve kanallar Gateway hazır yoluna ulaştıktan sonra OpenClaw, henüz yerel fiyatlandırması olmayan yapılandırılmış model referansları için isteğe bağlı bir arka plan fiyatlandırma bootstrap'i başlatır. Bu bootstrap uzak OpenRouter ve LiteLLM fiyatlandırma kataloglarını getirir. Çevrimdışı veya kısıtlı ağlarda bu katalog getirmelerini atlamak için models.pricing.enabled: false ayarlayın; açık models.providers.*.models[].cost girdileri yerel maliyet tahminlerini yönlendirmeye devam eder.

Önbellek TTL ve budama etkisi

Sağlayıcı istem önbelleğe alma yalnızca önbellek TTL penceresi içinde geçerlidir. OpenClaw isteğe bağlı olarak cache-ttl pruning çalıştırabilir: önbellek TTL süresi dolduğunda oturumu budar, ardından önbellek penceresini sıfırlar; böylece sonraki istekler tüm geçmişi yeniden önbelleğe almak yerine yeni önbelleğe alınmış bağlamı yeniden kullanabilir. Bu, bir oturum TTL'yi aşacak kadar boşta kaldığında önbellek yazma maliyetlerini düşük tutar.

Bunu Gateway yapılandırması içinde yapılandırın ve davranış ayrıntılarını Oturum budama içinde görün.

Heartbeat boşta kalma aralıklarında önbelleği sıcak tutabilir. Model önbellek TTL'niz 1h ise Heartbeat aralığını bunun hemen altına (ör. 55m) ayarlamak, tam istemin yeniden önbelleğe alınmasını önleyerek önbellek yazma maliyetlerini azaltabilir.

Çok ajanlı kurulumlarda tek bir paylaşılan model yapılandırması tutabilir ve önbellek davranışını agents.list[].params.cacheRetention ile ajan başına ayarlayabilirsiniz.

Tam bir ayar ayar kılavuzu için İstem Önbelleğe Alma bölümüne bakın.

Anthropic API fiyatlandırması için önbellek okumaları giriş tokenlarından önemli ölçüde daha ucuzdur, önbellek yazmaları ise daha yüksek bir çarpanla ücretlendirilir. En güncel oranlar ve TTL çarpanları için Anthropic'in istem önbelleğe alma fiyatlandırmasına bakın: https://docs.anthropic.com/docs/build-with-claude/prompt-caching

Örnek: Heartbeat ile 1h önbelleği sıcak tutma

agents:  defaults:    model:      primary: "anthropic/claude-opus-4-6"    models:      "anthropic/claude-opus-4-6":        params:          cacheRetention: "long"    heartbeat:      every: "55m"

Örnek: ajan başına önbellek stratejisiyle karma trafik

agents:  defaults:    model:      primary: "anthropic/claude-opus-4-6"    models:      "anthropic/claude-opus-4-6":        params:          cacheRetention: "long" # default baseline for most agents  list:    - id: "research"      default: true      heartbeat:        every: "55m" # keep long cache warm for deep sessions    - id: "alerts"      params:        cacheRetention: "none" # avoid cache writes for bursty notifications

agents.list[].params, seçilen modelin params değerlerinin üstüne birleştirilir; böylece yalnızca cacheRetention değerini geçersiz kılıp diğer model varsayılanlarını değiştirmeden devralabilirsiniz.

Anthropic 1M bağlam

OpenClaw, Opus 4.8, Opus 4.7, Opus 4.6 ve Sonnet 4.6 gibi GA yetenekli Claude 4.x modellerini Anthropic'in 1M bağlam penceresiyle boyutlandırır. Bu modeller için params.context1m: true gerekmez.

agents:  defaults:    models:      "anthropic/claude-opus-4-6":        alias: opus

Eski yapılandırmalar context1m: true değerini tutabilir, ancak OpenClaw artık bu ayar için Anthropic'in kullanımdan kaldırılmış context-1m-2025-08-07 beta başlığını göndermez ve desteklenmeyen eski Claude modellerini 1M'ye genişletmez.

Gereksinim: kimlik bilgisi uzun bağlam kullanımı için uygun olmalıdır. Uygun değilse, Anthropic bu istek için sağlayıcı taraflı bir hız sınırı hatası döndürür.

Anthropic'i OAuth/abonelik tokenlarıyla (sk-ant-oat-*) doğrularsanız, OpenClaw, eski yapılandırmada kalmışsa kullanımdan kaldırılmış context-1m-* betasını çıkarırken OAuth için gerekli Anthropic beta başlıklarını korur.

Token baskısını azaltma ipuçları

• Uzun oturumları özetlemek için /compact kullanın.
• İş akışlarınızda büyük araç çıktılarını kısaltın.
• Ekran görüntüsü ağırlıklı oturumlar için agents.defaults.imageMaxDimensionPx değerini düşürün.
• Skills açıklamalarını kısa tutun (skill listesi isteme eklenir).
• Ayrıntılı, keşif odaklı işler için daha küçük modelleri tercih edin.

Tam skill listesi ek yük formülü için Skills bölümüne bakın.

İlgili

• API kullanımı ve maliyetleri
• İstem önbelleğe alma
• Kullanım takibi