--- 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 gerekiyor summary: Kullanım izleme yüzeyleri ve kimlik bilgisi gereksinimleri title: Kullanım takibi x-i18n: generated_at: "2026-07-01T18:19:01Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: fa9b2b0b19ca0b4beeea40bfd50b07a92155178d5ec0e1877013843e0caba4fb source_path: concepts/usage-tracking.md workflow: 16 --- ## Nedir? - Sağlayıcı kullanımını/kotasını doğrudan kullanım uç noktalarından çeker. - Tahmini maliyet yoktur; yalnızca sağlayıcının bildirdiği kota aralıkları veya hesap durumu özetleri vardır. - İnsan tarafından okunabilir kota aralığı durumu çıktısı, üst API tüketilen kota, kalan kota veya yalnızca ham sayılar bildirse bile `X% left` biçimine normalize edilir. Sıfırlanabilir kota aralıkları olmayan sağlayıcılar bunun yerine bakiye gibi sağlayıcı özeti metni gösterebilir. - Oturum düzeyi `/status` ve `session_status`, canlı oturum anlık görüntüsü seyrek olduğunda en son transcript kullanım girdisine geri dönebilir. Bu geri dönüş eksik token/cache sayaçlarını doldurur, etkin çalışma zamanı model etiketini kurtarabilir ve oturum metaverisi eksik veya daha küçük olduğunda daha büyük prompt odaklı toplamı tercih eder. Mevcut sıfır olmayan canlı değerler yine önceliklidir. ## Nerede görünür? - Sohbetlerde `/status`: oturum token'ları + tahmini maliyet içeren emoji ağırlıklı durum kartı (yalnızca API anahtarı). Sağlayıcı kullanımı, mevcut olduğunda **geçerli model sağlayıcısı** için normalize edilmiş `X% left` aralığı veya sağlayıcı özeti metni olarak gösterilir. - Sohbetlerde `/usage off|tokens|full`: yanıt başına kullanım alt bilgisi. - Sohbetlerde `/usage cost`: OpenClaw oturum günlüklerinden toplanan yerel maliyet özeti. - CLI: `openclaw status --usage` sağlayıcı başına tam döküm yazdırır. - CLI: `openclaw channels list` aynı kullanım anlık görüntüsünü sağlayıcı yapılandırmasıyla birlikte yazdırır (atlamak için `--no-usage` kullanın). - macOS menü çubuğu: Context altında "Usage" bölümü (yalnızca mevcutsa). ## Varsayılan kullanım alt bilgisi modu `/usage off|tokens|full`, bir oturum için alt bilgiyi ayarlar ve bu oturum için hatırlanır. `messages.responseUsage`, henüz seçim yapılmamış oturumlar için bu modu başlatır; böylece alt bilgi her seferinde `/usage` yazmadan varsayılan olarak açık olabilir. Her kanal için tek bir mod veya `default` geri dönüşü olan kanal başına bir eşleme ayarlayın: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Üç ayrı 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, sonra `off` değerine düşer. | | **Açıkça kapalı** | `"off"` (saklanır) | Her zaman kapalı — `off` olmayan yapılandırma varsayılanı alt bilgiyi yeniden etkinleştiremez. | | **Açıkça açık** | `"tokens"` veya `"full"` (saklanır) | Yapılandırma varsayılanından bağımsız olarak o mod. | ### Öncelik Etkin mod = oturum geçersiz kılması → kanal yapılandırma girdisi → `default` → `off`. Açık bir `/usage off`, oturumda gerçek `"off"` değeri olarak **kalıcılaştırılır**; "ayarlanmamış" ile aynı değildir. Bu, `off` olmayan bir `messages.responseUsage` varsayılanının, kullanıcı açıkça devre dışı bıraktıktan sonra alt bilgiyi yeniden açamayacağı anlamına gelir. ### Sıfırlama ve kapatma - `/usage off` — alt bilgiyi kapalı olmaya zorlar ve bu seçimi kalıcılaştırır. Yapılandırılmış `off` olmayan bir varsayılan bunu geçersiz kılamaz. - `/usage reset` (takma adlar: `inherit`, `clear`, `default`) — oturum geçersiz kılmasını temizler. Oturum daha sonra etkin yapılandırma varsayılanını (`messages.responseUsage`) **devralır**. Hiç varsayılan yapılandırılmamışsa alt bilgi kapalıdır (önceki durumdan değişmez). Alt bilgiyi açıkça açmadan "varsayılana geri dönmek" için bunu kullanın. - Tam oturum sıfırlaması (`/reset` veya `/new`) ya da oturum devri, kullanıcının görüntüleme seçiminin oturum devirlerinden sağ çıkması için açık kullanım modu tercihini **korur**. Yalnızca `/usage reset` (ve takma adları) geçersiz kılmayı gerçekten temizler. ### Geçiş davranışı Argümansız `/usage` şu döngüyü izler: off → tokens → full → off. Döngünün başlangıç noktası **etkin** geçerli moddur (ayarlanmamışsa yapılandırma varsayılanına düşen oturum geçersiz kılması), bu nedenle döngü kullanıcının alt bilgide gördüğüyle her zaman tutarlıdır. ### Yapılandırma Yapılandırma yoksa önceki davranış korunur (alt bilgi `/usage` yazılana kadar kapalı). Bir oturum geçersiz kılmasını temizleyip yapılandırılmış varsayılanı yeniden devralmak için `/usage reset` kullanın. ## Özel `/usage full` alt bilgisi `/usage full`, model, reasoning, hızlı/yavaş, context aralığı ve bu alanlar mevcut olduğunda maliyet içeren yerleşik kompakt bir alt bilgi gösterir. Token ve cache alanları özel şablonlar için kullanılabilir kalır. Ş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 bir nesnedir ve geçerli olduğunda yerleşik alt bilginin yerini alır: ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Eksik veya boş şablonlar sessizce yerleşik alt bilgiye geri döner. Okunamayan veya geçersiz yapılandırılmış şablonlar da yerleşik alt bilgiye geri döner ve bir operatör uyarısı üretir. Özel şablonlara yerleşik şekilden başlayın, ardından değiştirmek istediğiniz parçaları 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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": "\u00A0💰{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": "\u00A0| 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": "\u00A0💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Şekil ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "