Отслеживание использования

​

Что это

• Получает данные об использовании/квоте провайдера напрямую из его endpoints использования.
• Без расчетных затрат; только сообщаемые провайдером окна квот или сводки состояния аккаунта.
• Удобочитаемый вывод статуса окна квоты нормализуется до X% left, даже когда вышестоящий API сообщает использованную квоту, оставшуюся квоту или только сырые счетчики. Провайдеры без сбрасываемых окон квоты могут вместо этого показывать текст сводки провайдера, например баланс.
• Сессионные /status и session_status могут откатываться к последней записи использования в транскрипте, когда живой снимок сессии неполный. Этот fallback заполняет отсутствующие счетчики токенов/кэша, может восстановить метку активной runtime-модели и предпочитает больший prompt-ориентированный итог, когда метаданные сессии отсутствуют или меньше. Существующие ненулевые живые значения по-прежнему имеют приоритет.

​

Где это отображается

• /status в чатах: статусная карточка с эмодзи, токенами сессии и расчетной стоимостью (только API-ключ). Использование провайдера показывается для провайдера текущей модели, когда доступно, как нормализованное окно X% left или текст сводки провайдера.
• /usage off|tokens|full в чатах: футер использования для каждого ответа (OAuth показывает только токены).
• /usage cost в чатах: локальная сводка стоимости, агрегированная из журналов сессий OpenClaw.
• CLI: openclaw status --usage печатает полный разбор по провайдерам.
• CLI: openclaw channels list печатает тот же снимок использования рядом с конфигурацией провайдера (используйте --no-usage, чтобы пропустить).
• Строка меню macOS: раздел “Использование” в Context (только если доступно).

​

Режим футера использования по умолчанию

{
  "messages": {
    "responseUsage": "tokens",
    // or: { "default": "off", "discord": "full" }
  },
}

​

Три различных состояния сессии

​

Приоритет

​

Сброс и выключение

• /usage off — принудительно выключает футер и сохраняет этот выбор. Настроенное значение по умолчанию, отличное от off, не может переопределить это.
• /usage reset (алиасы: inherit, clear, default) — очищает сессионное переопределение. Затем сессия наследует эффективное значение конфигурации по умолчанию (messages.responseUsage). Если значение по умолчанию не настроено, футер выключен (как и раньше). Используйте это, чтобы “вернуться к значению по умолчанию”, не включая футер явно.
• Полный сброс сессии (/reset или /new) или rollover сессии сохраняет явное предпочтение режима использования, чтобы выбор отображения пользователя переживал rollover сессии. Только /usage reset (и его алиасы) действительно очищает переопределение.

​

Поведение переключателя

​

Конфигурация

​

Пользовательский футер /usage full

{
  "messages": {
    "usageTemplate": "~/.openclaw/usage-footer.json"
  }
}

{
  "schema": "openclaw.usageBar.v1",
  "scales": {
    "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿",
    "block": "░▏▎▍▌▋▊▉█",
    "shade": "░▒▓█",
    "moon": "🌑🌘🌗🌖🌕",
    "level": "▁▂▃▄▅▆▇█",
    "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"],
    "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"],
    "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"],
  },
  "aliases": {
    "models": {
      "claude-opus-4-6": "opus46",
      "claude-opus-4-8": "opus48",
      "claude-sonnet-4-6": "sonnet46",
      "claude-haiku-4-5": "haiku45",
      "gpt-5.5": "gpt5.5",
    },
    "reasoning": {
      "off": "🌑",
      "minimal": "🌚",
      "low": "🌘",
      "medium": "🌗",
      "high": "🌕",
      "xhigh": "🌝",
    },
  },
  "output": {
    "sep": "",
    "default": [
      { "text": "{model.provider}{identity.emoji|🤖} {model.display_name|alias:models}" },
      { "map": "model.is_fallback", "cases": { "true": " 🔄" } },
      { "map": "model.is_override", "cases": { "true": " 📌" } },
      { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
      { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } },
      {
        "when": "context.max_tokens",
        "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
      },
      {
        "when": "usage.has_split_tokens",
        "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}",
      },
      { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" },
      { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" },
      { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
    ],
    "surfaces": {
      "discord": [
        { "text": "-# -\n" },
        { "text": "-# {model.provider}{identity.emoji|🤖} {model.display_name|alias:models}" },
        { "map": "model.is_fallback", "cases": { "true": "🔄" } },
        { "map": "model.is_override", "cases": { "true": "📌" } },
        { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": " ⚡️", "false": " 🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
        {
          "when": "usage.has_split_tokens",
          "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}",
        },
        { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" },
        { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" },
        { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" },
      ],
    },
  },
}

​

Форма

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "<name>": "low-to-high glyphs" }, // string (1 glyph/char) or array
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // joins surviving pieces
    "default": [
      /* pieces */
    ], // fallback for any surface
    "surfaces": {
      "discord": [
        /* pieces */
      ],
      "telegram": [
        /* pieces */
      ],
    },
  },
}

​

Пути контракта

​

Глаголы

​

Формы фрагментов

• { "text": "📚 {context.max_tokens|num}" }: литерал + интерполяция.
• { "when": "<path>", "text": "..." }: рендерить только если путь truthy.
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }: значение в glyph.
• { "each": "limits.windows", "item": "{label}" }: итерация по массиву.

​

Пример

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿" },
  "aliases": { "reasoning": { "medium": "🌗", "high": "🌕" } },
  "output": {
    "surfaces": {
      "discord": [
        { "text": "{model.display_name}" },
        { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" },
        { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } },
        {
          "when": "context.max_tokens",
          "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}",
        },
      ],
    },
  },
}

​

Провайдеры + учетные данные

• 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. Опрос использования выводит хост Coding Plan из models.providers.minimax-portal.baseUrl или models.providers.minimax.baseUrl, когда они настроены, а в остальных случаях использует хост MiniMax CN. Необработанные поля MiniMax usage_percent / usagePercent означают оставшуюся квоту, поэтому OpenClaw инвертирует их перед отображением; поля на основе счетчиков имеют приоритет, когда присутствуют.
  • Метки окна Coding Plan берутся из полей часов/минут провайдера, когда присутствуют, затем откатываются к интервалу start_time / end_time.
  • Если конечная точка Coding Plan возвращает model_remains, OpenClaw предпочитает запись модели чата, выводит метку окна из временных меток, когда явные поля window_hours / window_minutes отсутствуют, и включает имя модели в метку плана.
• Xiaomi MiMo: ключ API через хранилище env/config/auth (XIAOMI_API_KEY).
• z.ai: ключ API через хранилище env/config/auth.
• DeepSeek: ключ API через хранилище env/config/auth (DEEPSEEK_API_KEY). OpenClaw вызывает конечную точку баланса DeepSeek и показывает сообщенный провайдером баланс как текст вместо окна квоты с оставшимся процентом.

​

Связанные материалы

• Использование токенов и затраты
• Использование API и затраты
• Кэширование промптов