---
read_when:
    - Ви налаштовуєте поверхні використання/квот провайдера
    - Вам потрібно пояснити поведінку відстеження використання або вимоги до автентифікації
summary: Поверхні відстеження використання та вимоги до облікових даних
title: Відстеження використання
x-i18n:
    generated_at: "2026-04-05T18:02:26Z"
    model: gpt-5.4
    provider: openai
    source_hash: 62164492c61a8d602e3b73879c13ce3e14ce35964b7f2ffd389a4e6a7ec7e9c0
    source_path: concepts/usage-tracking.md
    workflow: 15
---

# Відстеження використання

## Що це таке

- Отримує дані про використання/квоти провайдера безпосередньо з їхніх endpoint використання.
- Жодних оцінених витрат; лише вікна, повідомлені провайдером.
- Зрозумілий для людини вивід статусу нормалізується до `X% left`, навіть коли
  API вище за потоком повідомляє про використану квоту, залишок квоти або лише сирі лічильники.
- `/status` і `session_status` на рівні сесії можуть використовувати резервний варіант з останнього
  запису використання в транскрипті, коли поточний знімок сесії містить мало даних. Цей
  резервний варіант заповнює відсутні лічильники токенів/кешу, може відновити мітку активної
  runtime-моделі та надає перевагу більшому загальному значенню, орієнтованому на prompt, коли метадані
  сесії відсутні або менші. Наявні ненульові поточні значення все одно мають пріоритет.

## Де це відображається

- `/status` у чатах: картка статусу з emoji із токенами сесії + оціненою вартістю (лише для ключа API). Використання провайдера показується для **поточного провайдера моделі**, коли доступне, як нормалізоване вікно `X% left`.
- `/usage off|tokens|full` у чатах: нижній колонтитул використання для кожної відповіді (OAuth показує лише токени).
- `/usage cost` у чатах: локальний підсумок вартості, агрегований із журналів сесій OpenClaw.
- CLI: `openclaw status --usage` виводить повну розбивку по провайдерах.
- CLI: `openclaw channels list` виводить той самий знімок використання поруч із конфігурацією провайдера (використовуйте `--no-usage`, щоб пропустити).
- Рядок меню macOS: розділ “Usage” у Context (лише якщо доступно).

## Провайдери та облікові дані

- **Anthropic (Claude)**: OAuth-токени в профілях автентифікації.
- **GitHub Copilot**: OAuth-токени в профілях автентифікації.
- **Gemini CLI**: OAuth-токени в профілях автентифікації.
  - JSON використання резервно бере дані зі `stats`; `stats.cached` нормалізується до
    `cacheRead`.
- **OpenAI Codex**: OAuth-токени в профілях автентифікації (коли доступно, використовується accountId).
- **MiniMax**: ключ API або профіль автентифікації MiniMax OAuth. OpenClaw вважає
  `minimax`, `minimax-cn` і `minimax-portal` однією й тією самою поверхнею квот MiniMax,
  надає перевагу збереженому MiniMax OAuth, коли він доступний, а в іншому разі резервно використовує
  `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY` або `MINIMAX_API_KEY`.
  Сирі поля MiniMax `usage_percent` / `usagePercent` означають **залишкову**
  квоту, тому OpenClaw інвертує їх перед відображенням; поля на основі лічильників мають пріоритет, коли
  доступні.
  - Мітки вікон coding-plan беруться з полів годин/хвилин провайдера, коли
    вони доступні, а потім резервно — з діапазону `start_time` / `end_time`.
  - Якщо endpoint coding-plan повертає `model_remains`, OpenClaw надає перевагу
    запису chat-model, виводить мітку вікна з часових позначок, коли явні
    поля `window_hours` / `window_minutes` відсутні, і включає назву моделі
    до мітки плану.
- **Xiaomi MiMo**: ключ API через env/config/auth store (`XIAOMI_API_KEY`).
- **z.ai**: ключ API через env/config/auth store.

Використання приховується, коли не вдається визначити придатну автентифікацію для використання провайдера. Провайдери
можуть надавати логіку автентифікації використання, специфічну для плагіна; інакше OpenClaw резервно використовує
відповідні облікові дані OAuth/ключа API з профілів автентифікації, змінних середовища
або конфігурації.
