--- read_when: - Sağlayıcı kullanım/kota yüzeylerini bağlıyorsunuz - Kullanım izleme davranışını veya kimlik doğrulama gereksinimlerini açıklamanız gerekir summary: Kullanım takibi yüzeyleri ve kimlik bilgisi gereksinimleri title: Kullanım takibi x-i18n: generated_at: "2026-07-12T12:15:14Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: c413dcbe838d94c57ba3f6ef9609331e139de6d0abbdb3860753a519bd490314 source_path: concepts/usage-tracking.md workflow: 16 --- ## Nedir - Sağlayıcı kullanımını/kotasını doğrudan her sağlayıcının kullanım uç noktasından alır. Tahmini sağlayıcı faturalandırması yoktur; yalnızca sağlayıcının bildirdiği plan adları, kota aralıkları, bakiyeler, harcamalar, bütçeler, günlük maliyet geçmişi, token/model ilişkilendirmesi veya hesap durumu özetleri kullanılır. - İnsanlar tarafından okunabilir kota aralığı çıktısı, sağlayıcı tüketilen kotayı, kalan kotayı veya yalnızca ham sayıları bildirse bile `X% kaldı` biçimine normalleştirilir. Sıfırlanabilir kota aralıkları olmayan sağlayıcılar bunun yerine sağlayıcı özet metnini (örneğin bir bakiye) gösterir. - Oturum düzeyindeki `/status` ve `session_status` aracı, canlı oturum anlık görüntüsünde token/model verileri eksik olduğunda oturumun transkript günlüğüne geri döner. Bu geri dönüş eksik token/önbellek sayaçlarını doldurur, etkin çalışma zamanı model etiketini kurtarabilir ve oturum meta verileri eksik veya daha küçük olduğunda (`totalTokensFresh !== true`, sıfır ya da transkriptten türetilen değerin altında) istem odaklı daha büyük toplamı tercih eder. Sıfır olmayan canlı değerler her zaman geri dönüşe göre önceliklidir. ## Nerede görünür - Sohbetlerde `/status`: oturum token'larını ve tahmini maliyeti içeren durum kartı (yalnızca API anahtarı kullanılan modeller). Sağlayıcı kullanımı, mevcut olduğunda **geçerli model sağlayıcısı** için normalleştirilmiş bir `X% kaldı` aralığı veya sağlayıcı özet metni olarak gösterilir. - Sohbetlerde `/usage off|tokens|full`: yanıt başına kullanım altbilgisi. - Sohbetlerde `/usage cost`: OpenClaw oturum günlüklerinden birleştirilen yerel maliyet özeti. - CLI: `openclaw status --usage`, sağlayıcı başına tam kullanım/kota dökümünü yazdırır. - CLI: `openclaw models status`, OAuth/token kimlik doğrulama profillerini listeler ve kullanım aralığı olan her sağlayıcının yanında bunun özetini gösterir. - Denetim Arayüzü: **Kullanım**, OpenClaw'ın oturumdan türetilen token ve tahmini maliyet analizinin üzerinde sağlayıcı planı ve faturalandırma kartlarını gösterir. Anthropic ve OpenAI Admin API kimlik bilgileri, sağlayıcı tarafından bildirilen bugünkü, 7 günlük ve 30 günlük harcamayı; günlük eğilimleri, token toplamlarını, en çok kullanılan modelleri ve maliyet kategorilerini ekler. - Denetim Arayüzü: sohbet oluşturucunun bağlam halkası açılır penceresi, abonelik sağlayıcıları için **plan kullanımını** gösterir: sıfırlanma zamanlarıyla birlikte aralık başına çubuklar (5 saatlik, haftalık, model kapsamlı), biliniyorsa sağlayıcı planı (örneğin `Max (20x)`) ve ek kullanım kredileri. Plan üzerinden faturalandırılan oturumlar token başına dolar tahminlerini gizler; API üzerinden faturalandırılan oturumlar `Tahm. maliyet` ve türe göre maliyet dökümünü göstermeye devam eder. Claude Code CLI (`claude-cli`) kurulumları aynı Anthropic abonelik kullanımını yeniden kullanır. - macOS menü çubuğu: sağlayıcı kullanım anlık görüntüleri mevcut olduğunda Bağlam'ın altında kök düzeyinde bir "Kullanım" bölümü görünür. Bkz. [Menü çubuğu](/tr/platforms/mac/menu-bar). `openclaw channels list` artık sağlayıcı kullanımını yazdırmaz; bunun yerine kullanıcıları `openclaw status` veya `openclaw models list` komutuna yönlendirir. ## Anthropic ve OpenAI maliyet geçmişi Abonelik kotası ile API faturalandırması farklı sağlayıcı yüzeyleridir: - Anthropic abonelik/kurulum kimlik bilgileri Claude kota aralıklarını ve isteğe bağlı ek kullanım bütçelerini göstermeye devam eder. Bunun yerine kuruluş Kullanım ve Maliyet API'si geçmişini göstermek için `ANTHROPIC_ADMIN_KEY` veya `ANTHROPIC_ADMIN_API_KEY` ayarlayın. `sk-ant-admin` ile başlayan bir Anthropic sağlayıcı kimlik bilgisi otomatik olarak algılanır. - OpenAI ChatGPT/Codex OAuth, planı, kota aralıklarını ve kredi bakiyesini göstermeye devam eder. Bunun yerine kuruluş maliyetini ve tamamlama kullanım geçmişini göstermek için `OPENAI_ADMIN_KEY` ayarlayın; isteğe bağlı olarak kapsamı tek bir projeyle sınırlamak için `OPENAI_PROJECT_ID` ayarlayın. Bu anahtarlar özel uç noktalara ait olabileceğinden OpenClaw, `OPENAI_API_KEY`, sağlayıcı yapılandırması veya kimlik doğrulama profillerindeki çıkarım kimlik bilgilerini kuruluş API'lerine hiçbir zaman göndermez. Yönetici kimlik bilgileri, gerçek kuruluş faturalandırmasını sağladıkları için önceliklidir. OpenClaw, sağlayıcının bildirdiği bu toplamları yerel oturum tahminleriyle birleştirmez; iki bölüm bilinçli olarak farklı soruları yanıtlar. ## Varsayılan kullanım altbilgisi modu `/usage off|tokens|full`, bir oturumun altbilgisini ayarlar ve bu seçim söz konusu oturum için hatırlanır. `messages.responseUsage`, henüz seçim yapmamış oturumların modunu başlangıçta belirler; böylece her seferinde `/usage` yazmadan altbilgi varsayılan olarak açık olabilir. Her kanal için tek bir mod veya `default` geri dönüşü içeren kanal başına bir eşleme ayarlayın: ```jsonc { "messages": { "responseUsage": "tokens", // veya: { "default": "off", "discord": "full" } }, } ``` Kabul edilen değerler: `"off"`, `"tokens"`, `"full"` ve eski diğer ad `"on"` (`"tokens"` olarak değerlendirilir). ### Üç farklı oturum durumu Bir oturumun `responseUsage` alanının temsil edilebilir üç durumu vardır ve her birinin anlamı farklıdır: | Durum | Saklanan değer | Etkin mod | | -------------------------- | ------------------------------- | ----------------------------------------------------------------------- | | **Ayarlanmamış / devral** | `undefined` (yok) | `messages.responseUsage` yapılandırma varsayılanına, ardından `off` değerine geçer. | | **Açıkça kapalı** | `"off"` (saklanır) | Her zaman kapalıdır; kapalı olmayan bir yapılandırma varsayılanı altbilgiyi yeniden etkinleştiremez. | | **Açıkça açık** | `"tokens"` veya `"full"` (saklanır) | Yapılandırma varsayılanından bağımsız olarak bu mod kullanılır. | ### Öncelik Etkin mod = oturum geçersiz kılması → kanal yapılandırma girdisi → `default` → `off`. Açıkça verilen `/usage off`, oturumda `"off"` değişmez değeri olarak **kalıcılaştırılır**; bu, "ayarlanmamış" ile aynı değildir. Kapalı olmayan bir `messages.responseUsage` varsayılanı, kullanıcı açıkça devre dışı bıraktıktan sonra altbilgiyi yeniden açamaz. ### Sıfırlama ile kapatma arasındaki fark - `/usage off`, altbilgiyi kapalı olmaya zorlar ve bu seçimi kalıcılaştırır. Yapılandırılmış kapalı olmayan bir varsayılan bunu geçersiz kılamaz. - `/usage reset` (diğer adlar: `default`, `inherit`, `inherited`, `clear`, `unpin`) oturum geçersiz kılmasını temizler. Ardından oturum, etkin yapılandırma varsayılanını (`messages.responseUsage`) **devralır**. Herhangi bir varsayılan yapılandırılmamışsa altbilgi kapalı kalır. - Tam oturum sıfırlaması (`/reset` veya `/new`) ya da oturum devri, kullanıcının görüntüleme seçiminin oturum devirlerinde korunması için açık kullanım modu tercihini **korur**. Geçersiz kılmayı yalnızca `/usage reset` (ve diğer adları) temizler. ### Geçiş davranışı Bağımsız değişken olmadan `/usage` şu sırayla geçiş yapar: kapalı → token'lar → tam → kapalı. Döngünün başlangıç noktası **etkin** geçerli moddur (ayarlanmamışsa oturum geçersiz kılması yapılandırma varsayılanına geçer); böylece döngü her zaman kullanıcının altbilgide o anda gördüğüyle eşleşir. ### Yapılandırma Yapılandırma yoksa önceki davranış korunur (altbilgi, `/usage` kullanılana kadar kapalıdır). Oturum geçersiz kılmasını temizleyip yapılandırılmış varsayılanı yeniden devralmak için `/usage reset` kullanın. ## Özel `/usage full` altbilgisi `/usage tokens` her zaman düz bir `Usage: X in / Y out` satırı (mevcut olduğunda önbellek ve tahmini maliyet son ekleriyle birlikte) oluşturur. Aşağıda açıklanan daha zengin altbilgiyi yalnızca `/usage full` oluşturur. `/usage full`, bu alanlar mevcut olduğunda model, akıl yürütme, hızlı/yavaş, bağlam penceresi ve maliyet bilgilerini içeren yerleşik, kompakt bir altbilgi gösterir. Yerleşik altbilgi için şablon dosyası gerekmez. `messages.usageTemplate` yalnızca gelişmiş özel düzenler içindir. Değer, bir JSON dosya yolu (`~` desteklenir) veya satır içi nesnedir ve geçerli olduğunda yerleşik altbilginin yerini alır. Dosya yolu izlenir ve değişiklik olduğunda canlı olarak yeniden yüklenir. ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Eksik veya boş şablonlar sessizce yerleşik altbilgiye geri döner. Okunamayan veya geçersiz yapılandırılmış şablonlar (bozuk JSON ya da oluşturulabilir çıktı parçası bulunmayan bir şekil) da yerleşik altbilgiye geri döner ve operatör uyarısı verir. Özel şablonlara yerleşik şekille başlayın, ardından değiştirmek istediğiniz bölümleri düzenleyin: ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿", "block": "░▏▎▍▌▋▊▉█", "shade": "░▒▓█", "moon": "🌑🌘🌗🌖🌕", "level": "▁▂▃▄▅▆▇█", "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"], "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"], "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"], }, "aliases": { "models": { "claude-opus-4-6": "opus46", "claude-opus-4-8": "opus48", "claude-sonnet-4-6": "sonnet46", "claude-haiku-4-5": "haiku45", "gpt-5.5": "gpt5.5", }, "reasoning": { "off": "🌑", "minimal": "🌚", "low": "🌘", "medium": "🌗", "high": "🌕", "xhigh": "🌝", }, }, "output": { "sep": "", "default": [ { "text": "{model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": "🔄" } }, { "map": "model.is_override", "cases": { "true": "📌" } }, { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } }, { "when": "context.max_tokens", "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], "surfaces": { "discord": [ { "text": "-# -\n" }, { "text": "-# {model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": "🔄" } }, { "map": "model.is_override", "cases": { "true": "📌" } }, { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } }, { "when": "context.max_tokens", "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Şekil ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "