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.
  • 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 із профілів автентифікації, змінних середовища або конфігурації.

Пов’язане