--- read_when: - Вы подключаете поверхности использования и квот провайдера - Вам нужно объяснить поведение отслеживания использования или требования к аутентификации summary: Поверхности отслеживания использования и требования к учетным данным title: Отслеживание использования x-i18n: generated_at: "2026-06-28T22:54:18Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 953f9671093c26f874b19fc0e6f8aee0ebf3379d4a6698bc8548abf942e37a59 source_path: concepts/usage-tracking.md workflow: 16 --- ## Что это - Получает данные об использовании/квоте провайдера напрямую из его 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 (только если доступно). ## Режим футера использования по умолчанию `/usage off|tokens|full` задает футер для сессии и запоминается для этой сессии. `messages.responseUsage` задает начальное значение этого режима для сессий, которые еще не выбрали его, поэтому футер может быть включен по умолчанию без ввода `/usage` каждый раз. Задайте один режим для каждого канала или карту по каналам с fallback `default`: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### Три различных состояния сессии Поле `responseUsage` у сессии имеет три представимых состояния, каждое с разной семантикой: | Состояние | Сохраненное значение | Эффективный режим | | ----------------------------- | -------------------------------- | -------------------------------------------------------------------- | | **Не задано / наследовать** | `undefined` (отсутствует) | Переходит к значению по умолчанию `messages.responseUsage`, затем к `off`. | | **Явно выключено** | `"off"` (сохранено) | Всегда выключено — значение конфигурации не `off` не может снова включить футер. | | **Явно включено** | `"tokens"` или `"full"` (сохранено) | Этот режим, независимо от значения конфигурации по умолчанию. | ### Приоритет Эффективный режим = переопределение сессии → запись конфигурации канала → `default` → `off`. Явный `/usage off` **сохраняется** как буквальное значение `"off"` в сессии, а не как "не задано". Это означает, что значение `messages.responseUsage` по умолчанию, отличное от `off`, не может снова включить футер после того, как пользователь явно отключил его. ### Сброс и выключение - `/usage off` — принудительно выключает футер и сохраняет этот выбор. Настроенное значение по умолчанию, отличное от `off`, не может переопределить это. - `/usage reset` (алиасы: `inherit`, `clear`, `default`) — очищает сессионное переопределение. Затем сессия **наследует** эффективное значение конфигурации по умолчанию (`messages.responseUsage`). Если значение по умолчанию не настроено, футер выключен (как и раньше). Используйте это, чтобы "вернуться к значению по умолчанию", не включая футер явно. - Полный сброс сессии (`/reset` или `/new`) или rollover сессии **сохраняет** явное предпочтение режима использования, чтобы выбор отображения пользователя переживал rollover сессии. Только `/usage reset` (и его алиасы) действительно очищает переопределение. ### Поведение переключателя `/usage` без аргументов циклически переключает: off → tokens → full → off. Начальная точка цикла — **эффективный** текущий режим (переопределение сессии с переходом к значению конфигурации по умолчанию, если оно не задано), поэтому цикл всегда согласуется с тем, что пользователь видит в футере. ### Конфигурация Без конфигурации сохраняется прежнее поведение (футер выключен до `/usage`). Используйте `/usage reset`, чтобы очистить сессионное переопределение и снова унаследовать настроенное значение по умолчанию. ## Пользовательский футер `/usage full` `/usage full` показывает встроенный компактный футер с моделью, reasoning, fast/slow, окном контекста, токенами хода, кэшем и стоимостью, когда эти поля доступны. Файл шаблона не требуется. `messages.usageTemplate` предназначен только для расширенных пользовательских макетов. Значение — это путь к JSON-файлу (поддерживает `~`) или inline-объект, и при валидности оно заменяет встроенный футер: ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Отсутствующие или пустые шаблоны тихо откатываются к встроенному футеру. Нечитаемые или недействительные настроенные шаблоны также откатываются к встроенному футеру и выводят предупреждение оператору. Начните пользовательские шаблоны со встроенной формы, затем измените нужные части: ```jsonc { "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}" }, ], }, }, } ``` ### Форма ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "