---
read_when:
    - Ви підключаєте інтерфейси використання/квот провайдера
    - Потрібно пояснити поведінку відстеження використання або вимоги до автентифікації
summary: Інтерфейси відстеження використання та вимоги до облікових даних
title: Відстеження використання
x-i18n:
    generated_at: "2026-05-06T05:09:23Z"
    model: gpt-5.5
    provider: openai
    source_hash: 14210813bf3c078a1323b1560a1a3da586f55880e05a9b310e1b6a2d5490f956
    source_path: concepts/usage-tracking.md
    workflow: 16
---

## Що це таке

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

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

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

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

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

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

## Пов’язане

- [Використання токенів і витрати](/uk/reference/token-use)
- [Використання API та витрати](/uk/reference/api-usage-costs)
- [Кешування prompt](/uk/reference/prompt-caching)