Concept internals
Відстеження використання
Що це таке
- Отримує дані про використання/квоту провайдера безпосередньо з його 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.
- JSON-використання повертається до
- 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. Сирі поля MiniMaxusage_percent/usagePercentозначають залишкову квоту, тому OpenClaw інвертує їх перед відображенням; поля на основі лічильників мають пріоритет, коли наявні.- Мітки вікна coding-plan беруться з полів годин/хвилин провайдера, коли
наявні, а потім fallback до проміжку
start_time/end_time. - Якщо endpoint coding-plan повертає
model_remains, OpenClaw віддає перевагу запису chat-model, виводить мітку вікна з часових позначок, коли явні поляwindow_hours/window_minutesвідсутні, і включає назву моделі в мітку плану.
- Мітки вікна coding-plan беруться з полів годин/хвилин провайдера, коли
наявні, а потім fallback до проміжку
- 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 із профілів автентифікації, змінних середовища або конфігурації.