Перейти до основного вмісту

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

Що це таке

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