--- read_when: - Estás conectando las interfaces de uso/cuota del proveedor - Debes explicar el comportamiento del seguimiento de uso o los requisitos de autenticación. summary: Superficies de seguimiento de uso y requisitos de credenciales title: Seguimiento del uso x-i18n: generated_at: "2026-07-11T23:04:47Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: c413dcbe838d94c57ba3f6ef9609331e139de6d0abbdb3860753a519bd490314 source_path: concepts/usage-tracking.md workflow: 16 --- ## Qué es - Obtiene el uso y la cuota del proveedor directamente desde el endpoint de uso de cada proveedor. No se realizan estimaciones de facturación del proveedor; solo se muestran los nombres de los planes, los períodos de cuota, los saldos, el gasto, los presupuestos, el historial de costes diarios, la atribución de tokens/modelos o los resúmenes del estado de la cuenta informados por el proveedor. - La salida legible de los períodos de cuota se normaliza como `X% restante`, incluso cuando un proveedor informa la cuota consumida, la cuota restante o solo recuentos sin procesar. Los proveedores sin períodos de cuota restablecibles muestran en su lugar el texto de resumen del proveedor (por ejemplo, un saldo). - El comando `/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 la sesión activa no contiene datos de tokens/modelos. Ese mecanismo alternativo completa los contadores de tokens/caché que faltan, puede recuperar la etiqueta del modelo activo en tiempo de ejecución y prefiere el total mayor orientado al prompt cuando faltan los metadatos de la sesión o su valor es menor (`totalTokensFresh !== true`, cero o inferior al valor derivado de la transcripción). Los valores activos distintos de cero siempre tienen prioridad sobre el mecanismo alternativo. ## Dónde aparece - `/status` en los chats: tarjeta de estado con los tokens de la sesión y el coste estimado (solo para modelos con clave de API). Cuando está disponible, se muestra el uso del **proveedor del modelo actual**, como un período normalizado con `X% restante` o como texto de resumen del proveedor. - `/usage off|tokens|full` en los chats: pie de uso por respuesta. - `/usage cost` en los chats: resumen de costes locales agregado a partir de los registros de sesión de OpenClaw. - CLI: `openclaw status --usage` imprime un desglose completo del uso y la cuota de cada proveedor. - CLI: `openclaw models status` enumera los perfiles de autenticación OAuth/token y muestra un resumen de los períodos de uso junto a cada proveedor que disponga de uno. - Interfaz de control: **Uso** muestra las tarjetas del plan y la facturación del proveedor sobre el análisis de tokens y costes estimados que OpenClaw deriva de las sesiones. Las credenciales de las API de administración de Anthropic y OpenAI añaden el gasto informado por el proveedor correspondiente al día actual, los últimos 7 días y los últimos 30 días, además de tendencias diarias, totales de tokens, modelos principales y categorías de costes. - Interfaz de control: la ventana emergente del anillo de contexto del editor de chat muestra el **uso del plan** para los proveedores de suscripción: barras por período (5 horas, semanal y específicas del modelo) con horas de restablecimiento, el plan del proveedor cuando se conoce (por ejemplo, `Max (20x)`) y créditos de uso adicional. Las sesiones facturadas mediante un plan ocultan las estimaciones monetarias por token; las sesiones facturadas mediante API mantienen `Coste est.` y el desglose de costes por tipo. Las configuraciones de la CLI de Claude Code (`claude-cli`) reutilizan el mismo uso de suscripción de Anthropic. - 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 distintas del proveedor: - Las credenciales de suscripción/configuración de Anthropic siguen mostrando los períodos de cuota de Claude y los presupuestos opcionales de uso adicional. Define `ANTHROPIC_ADMIN_KEY` o `ANTHROPIC_ADMIN_API_KEY` para mostrar en su lugar el historial de las API de uso y costes de la organización. Las credenciales de proveedor de Anthropic que comiencen por `sk-ant-admin` se detectan automáticamente. - OAuth de OpenAI ChatGPT/Codex sigue mostrando el plan, los períodos de cuota y el saldo de créditos. Define `OPENAI_ADMIN_KEY` para mostrar en su lugar el historial de costes y uso de finalizaciones de la organización; también puedes definir `OPENAI_PROJECT_ID` para limitarlo a un solo proyecto. OpenClaw nunca envía credenciales de inferencia de `OPENAI_API_KEY`, de la configuración del proveedor ni de los perfiles de autenticación a las API de la 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 locales de sesión; ambas secciones responden intencionadamente a preguntas distintas. ## Modo predeterminado del pie de uso `/usage off|tokens|full` establece el pie de una sesión y se recuerda para esa sesión. `messages.responseUsage` establece inicialmente ese modo para las sesiones que aún no hayan elegido uno, de modo que el pie pueda estar activado de forma predeterminada sin escribir `/usage` cada vez. Define un modo para todos los canales o un mapa por canal con un valor alternativo `default`: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` Valores aceptados: `"off"`, `"tokens"`, `"full"` y el alias heredado `"on"` (se trata como `"tokens"`). ### Tres estados distintos de sesión El campo `responseUsage` de una sesión tiene tres estados representables, cada uno con una semántica diferente: | Estado | Valor almacenado | Modo efectivo | | ------------------------------ | -------------------------------- | ----------------------------------------------------------------------------------- | | **Sin definir / heredado** | `undefined` (ausente) | Recurre al valor predeterminado de configuración `messages.responseUsage` y después a `off`. | | **Desactivado explícitamente** | `"off"` (almacenado) | Siempre desactivado; un valor predeterminado de configuración distinto de `off` no puede reactivar el pie. | | **Activado explícitamente** | `"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 **conserva** como el valor literal `"off"` en la sesión; no equivale a «sin definir». Un valor predeterminado de `messages.responseUsage` distinto de `off` no puede volver a activar el pie después de que el usuario lo haya desactivado explícitamente. ### Restablecer frente a desactivar - `/usage off` fuerza la desactivación del pie y conserva esa elección. Un valor predeterminado configurado distinto de `off` no puede anularla. - `/usage reset` (alias: `default`, `inherit`, `inherited`, `clear`, `unpin`) borra la anulación de la sesión. La sesión pasa entonces a **heredar** el valor predeterminado efectivo de la configuración (`messages.responseUsage`). Si no hay ningún valor predeterminado configurado, el pie permanece desactivado. - Un restablecimiento completo de la sesión (`/reset` o `/new`) o una rotación de sesión **conserva** la preferencia explícita del modo de uso, de modo que la elección de visualización del usuario persista tras las rotaciones de sesión. Solo `/usage reset` (y sus alias) borra la anulación. ### Comportamiento de alternancia `/usage` sin argumentos recorre: desactivado → tokens → completo → desactivado. El punto de partida del ciclo es el modo actual **efectivo** (la anulación de sesión recurre 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 desactivado hasta ejecutar `/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 representa una línea simple `Uso: X entrada / Y salida` (más los sufijos de caché y coste estimado cuando estén disponibles). Solo `/usage full` representa el pie más completo descrito a continuación. `/usage full` muestra un pie compacto integrado con el modelo, el razonamiento, el modo rápido/lento, la ventana de contexto y el coste cuando esos campos están disponibles. No se requiere ningún archivo de plantilla para el pie integrado. `messages.usageTemplate` se reserva para diseños personalizados avanzados. El valor es una ruta a un archivo JSON (admite `~`) o un objeto insertado, y sustituye el pie integrado cuando es válido. Las rutas de archivo se supervisan y se recargan en tiempo real cuando cambian. ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Las plantillas ausentes o vacías recurren silenciosamente al pie integrado. Las plantillas configuradas que no se puedan leer o no sean válidas (JSON incorrecto o una estructura sin elementos de salida representables) también recurren al pie integrado y emiten una advertencia para el operador. Parte de la estructura integrada para crear plantillas personalizadas y modifica después las partes que quieras cambiar: ```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": "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}" }, ], }, }, } ``` ### Estructura ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "