> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Seguimiento de uso ## Qué es * Extrae el uso/la cuota del proveedor directamente del endpoint de uso de cada proveedor. No hay facturación estimada del proveedor; solo nombres de planes, ventanas de cuota, saldos, gasto, presupuestos, historial de coste diario, atribución por token/modelo o resúmenes de estado de cuenta informados por el proveedor. * La salida legible por humanos de la ventana de cuota se normaliza como `X% left`, incluso cuando un proveedor informa cuota consumida, cuota restante o solo recuentos sin procesar. Los proveedores sin ventanas de cuota reiniciables muestran en su lugar texto de resumen del proveedor (por ejemplo, un saldo). * `/status` a nivel de sesión y la herramienta `session_status` recurren al registro de transcripción de la sesión cuando la instantánea de sesión en vivo no tiene datos de tokens/modelo. Ese recurso completa contadores faltantes de tokens/caché, puede recuperar la etiqueta del modelo de ejecución activo y prefiere el total más grande orientado al prompt cuando faltan los metadatos de la sesión o son menores (`totalTokensFresh !== true`, cero o por debajo del valor derivado de la transcripción). Los valores en vivo distintos de cero siempre tienen prioridad sobre el recurso. ## Dónde aparece * `/status` en chats: tarjeta de estado con tokens de sesión y coste estimado (solo modelos con clave de API). El uso del proveedor se muestra para el **proveedor del modelo actual** cuando está disponible, como una ventana normalizada `X% left` o texto de resumen del proveedor. * `/usage off|tokens|full` en chats: pie de uso por respuesta. * `/usage cost` en chats: resumen de coste local agregado a partir de los registros de sesión de OpenClaw. * CLI: `openclaw status --usage` imprime un desglose completo de uso/cuota por proveedor. * CLI: `openclaw models status` lista perfiles de autenticación OAuth/token y muestra un resumen de ventana de uso junto a cada proveedor que tenga uno. * Interfaz de control: **Uso** muestra tarjetas de plan y facturación del proveedor sobre el análisis de tokens y coste estimado derivado de la sesión de OpenClaw. Las credenciales de Anthropic y de la API de administración de OpenAI añaden gasto informado por el proveedor de hoy, 7 días y 30 días, tendencias diarias, totales de tokens, modelos principales y categorías de coste. * Barra de menús de macOS: aparece una sección raíz "Uso" debajo de Contexto cuando hay instantáneas de uso del proveedor disponibles. Consulta [Barra de menús](/es/platforms/mac/menu-bar). `openclaw channels list` ya no imprime el uso del proveedor; en su lugar dirige a los usuarios a `openclaw status` o `openclaw models list`. ## Historial de costes de Anthropic y OpenAI La cuota de suscripción y la facturación de API son superficies de proveedor diferentes: * Las credenciales de suscripción/configuración de Anthropic siguen mostrando ventanas de cuota de Claude y presupuestos opcionales de uso adicional. Configura `ANTHROPIC_ADMIN_KEY` o `ANTHROPIC_ADMIN_API_KEY` para mostrar en su lugar el historial de las API de uso y coste de la organización. Una credencial de proveedor de Anthropic que empieza por `sk-ant-admin` se detecta automáticamente. * OAuth de OpenAI ChatGPT/Codex sigue mostrando plan, ventanas de cuota y saldo de crédito. Configura `OPENAI_ADMIN_KEY` para mostrar en su lugar el historial de coste de organización y uso de completions; opcionalmente, configura `OPENAI_PROJECT_ID` para limitarlo a un proyecto. OpenClaw nunca envía credenciales de inferencia desde `OPENAI_API_KEY`, la configuración del proveedor o los perfiles de autenticación a las API de organización porque esas claves pueden pertenecer a endpoints personalizados. Las credenciales de administración tienen prioridad porque proporcionan la facturación real de la organización. OpenClaw no combina estos totales informados por el proveedor con sus estimaciones de sesión locales; las dos secciones responden intencionalmente a preguntas diferentes. ## Modo predeterminado del pie de uso `/usage off|tokens|full` establece el pie para una sesión y se recuerda para esa sesión. `messages.responseUsage` inicializa ese modo para sesiones que aún no han elegido uno, de modo que el pie pueda estar activado de forma predeterminada sin escribir `/usage` cada vez. Configura un modo para cada canal, o un mapa por canal con un respaldo `default`: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` Valores aceptados: `"off"`, `"tokens"`, `"full"` y el alias heredado `"on"` (tratado como `"tokens"`). ### Tres estados de sesión distintos El campo `responseUsage` de una sesión tiene tres estados representables, cada uno con semánticas diferentes: | Estado | Valor almacenado | Modo efectivo | | ------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------- | | **Sin definir / heredar** | `undefined` (ausente) | Pasa al valor predeterminado de configuración `messages.responseUsage`, luego `off`. | | **Apagado explícito** | `"off"` (almacenado) | Siempre apagado; un valor predeterminado de configuración distinto de off no puede reactivar el pie. | | **Encendido explícito** | `"tokens"` o `"full"` (almacenado) | Ese modo, independientemente del valor predeterminado de configuración. | ### Precedencia Modo efectivo = anulación de sesión → entrada de configuración del canal → `default` → `off`. Un `/usage off` explícito se **persiste** como el valor literal `"off"` en la sesión, no es lo mismo que "sin definir". Un valor predeterminado de `messages.responseUsage` distinto de off no puede volver a activar el pie una vez que el usuario lo ha deshabilitado explícitamente. ### Restablecer frente a apagar * `/usage off` fuerza el pie a apagarse y persiste esa elección. Un valor predeterminado configurado distinto de off no puede anularlo. * `/usage reset` (alias: `default`, `inherit`, `inherited`, `clear`, `unpin`) borra la anulación de sesión. La sesión entonces **hereda** el valor predeterminado efectivo de configuración (`messages.responseUsage`). Si no hay un valor predeterminado configurado, el pie permanece apagado. * Un restablecimiento completo de sesión (`/reset` o `/new`) o una rotación de sesión **preserva** la preferencia explícita de modo de uso para que la elección de visualización del usuario sobreviva a las rotaciones de sesión. Solo `/usage reset` (y sus alias) borra la anulación. ### Comportamiento de alternancia `/usage` sin argumentos alterna: off → tokens → full → off. El punto de partida del ciclo es el modo actual **efectivo** (la anulación de sesión pasa al valor predeterminado de configuración cuando no está definida), por lo que el ciclo siempre coincide con lo que el usuario ve actualmente en el pie. ### Configuración Sin configuración, se mantiene el comportamiento anterior (pie apagado hasta `/usage`). Usa `/usage reset` para borrar una anulación de sesión y volver a heredar el valor predeterminado configurado. ## Pie personalizado de `/usage full` `/usage tokens` siempre renderiza una línea simple `Usage: X in / Y out` (más sufijos de caché y coste estimado cuando están disponibles). Solo `/usage full` renderiza el pie más completo descrito abajo. `/usage full` muestra un pie compacto integrado con modelo, razonamiento, rápido/lento, ventana de contexto y coste cuando esos campos están disponibles. No se requiere ningún archivo de plantilla para el pie integrado. `messages.usageTemplate` es solo para diseños personalizados avanzados. El valor es una ruta de archivo JSON (compatible con `~`) o un objeto en línea, y reemplaza el pie integrado cuando es válido. Una ruta de archivo se observa y se recarga en vivo al cambiar. ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Las plantillas faltantes o vacías recurren silenciosamente al pie integrado. Las plantillas configuradas ilegibles o inválidas (JSON incorrecto, o una forma sin piezas de salida renderizables) también recurren al pie integrado y emiten una advertencia para el operador. Empieza las plantillas personalizadas desde la forma integrada y luego edita las partes que quieras cambiar: ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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": "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": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Forma ```jsonc theme={"theme":{"light":"min-light","dark":"min-dark"}} { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "