--- read_when: - Ви підключаєте інтерфейси використання/квот провайдера - Потрібно пояснити поведінку відстеження використання або вимоги до автентифікації summary: Поверхні відстеження використання та вимоги до облікових даних title: Відстеження використання x-i18n: generated_at: "2026-07-01T18:20:24Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: fa9b2b0b19ca0b4beeea40bfd50b07a92155178d5ec0e1877013843e0caba4fb source_path: concepts/usage-tracking.md workflow: 16 --- ## Що це таке - Отримує дані про використання/квоту постачальника безпосередньо з його кінцевих точок використання. - Без оцінок вартості; лише вікна квот, повідомлені постачальником, або зведення стану облікового запису. - Людинозрозумілий вивід стану вікна квоти нормалізується до `X% left`, навіть коли upstream API повідомляє спожиту квоту, залишок квоти або лише сирі лічильники. Постачальники без скидних вікон квоти можуть натомість показувати текст зведення постачальника, наприклад баланс. - `/status` і `session_status` на рівні сесії можуть повертатися до останнього запису використання з транскрипту, коли живий знімок сесії розріджений. Цей fallback заповнює відсутні лічильники токенів/кешу, може відновити мітку активної runtime-моделі та віддає перевагу більшому prompt-орієнтованому підсумку, коли метадані сесії відсутні або менші. Наявні ненульові живі значення все одно мають пріоритет. ## Де це відображається - `/status` у чатах: статусна картка з багатьма emoji, токенами сесії та орієнтовною вартістю (лише API key). Використання постачальника показується для **поточного постачальника моделі**, коли доступне, як нормалізоване вікно `X% left` або текст зведення постачальника. - `/usage off|tokens|full` у чатах: футер використання для кожної відповіді. - `/usage cost` у чатах: локальне зведення вартості, агреговане з журналів сесій OpenClaw. - CLI: `openclaw status --usage` друкує повну деталізацію за постачальниками. - CLI: `openclaw channels list` друкує той самий знімок використання поруч із конфігурацією постачальника (використайте `--no-usage`, щоб пропустити). - Рядок меню macOS: розділ «Використання» під «Контекст» (лише якщо доступно). ## Стандартний режим футера використання `/usage off|tokens|full` задає футер для сесії та запам’ятовується для цієї сесії. `messages.responseUsage` задає початковий режим для сесій, які ще не вибрали його, тож футер може бути ввімкнений за замовчуванням без введення `/usage` щоразу. Задайте один режим для кожного каналу або мапу для окремих каналів із fallback `default`: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Три окремі стани сесії Поле `responseUsage` сесії має три представні стани, кожен із різною семантикою: | Стан | Збережене значення | Ефективний режим | | ---------------------------- | ------------------------------- | -------------------------------------------------------------------- | | **Не задано / успадкувати** | `undefined` (відсутнє) | Переходить до стандарту конфігурації `messages.responseUsage`, потім `off`. | | **Явно вимкнено** | `"off"` (збережено) | Завжди вимкнено — не-`off` стандарт конфігурації не може знову ввімкнути футер. | | **Явно ввімкнено** | `"tokens"` або `"full"` (збережено) | Цей режим незалежно від стандарту конфігурації. | ### Пріоритет Ефективний режим = перевизначення сесії → запис конфігурації каналу → `default` → `off`. Явний `/usage off` **зберігається** як буквальне значення `"off"` у сесії, а не як «не задано». Це означає, що не-`off` стандарт `messages.responseUsage` не може знову ввімкнути футер після того, як користувач явно вимкнув його. ### Скидання проти вимкнення - `/usage off` — примусово вимикає футер і зберігає цей вибір. Налаштований не-`off` стандарт не може перевизначити це. - `/usage reset` (псевдоніми: `inherit`, `clear`, `default`) — очищає перевизначення сесії. Після цього сесія **успадковує** ефективний стандарт конфігурації (`messages.responseUsage`). Якщо стандарт не налаштовано, футер вимкнений (без змін від попереднього стану). Використовуйте це, щоб «повернутися до стандарту» без явного ввімкнення футера. - Повне скидання сесії (`/reset` або `/new`) чи rollover сесії **зберігає** явну перевагу режиму використання, щоб вибір відображення користувача переживав rollover сесій. Лише `/usage reset` (та його псевдоніми) фактично очищає перевизначення. ### Поведінка перемикача `/usage` без аргументів циклічно перемикає: off → tokens → full → off. Початкова точка циклу — **ефективний** поточний режим (перевизначення сесії переходить до стандарту конфігурації, коли не задане), тож цикл завжди узгоджений із тим, що користувач бачить у футері. ### Конфігурація Без конфігурації попередня поведінка зберігається (футер вимкнений до `/usage`). Використайте `/usage reset`, щоб очистити перевизначення сесії та знову успадкувати налаштований стандарт. ## Власний футер `/usage full` `/usage full` показує вбудований компактний футер із моделлю, reasoning, fast/slow, context window і вартістю, коли ці поля доступні. Поля токенів і кешу залишаються доступними для власних шаблонів. Файл шаблону не потрібен. `messages.usageTemplate` призначений лише для розширених власних макетів. Значенням є шлях до JSON-файлу (підтримує `~`) або inline-об’єкт, і воно замінює вбудований футер, коли є валідним: ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Відсутні або порожні шаблони тихо повертаються до вбудованого футера. Нечитабельні або невалідні налаштовані шаблони також повертаються до вбудованого футера та виводять попередження оператору. Почніть власні шаблони з вбудованої форми, а потім змініть частини, які хочете налаштувати: ```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}" }, ], }, }, } ``` ### Форма ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "