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.

​

Historial de costes de Anthropic y OpenAI

• 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.

​

Modo predeterminado del pie de uso

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

​

Tres estados de sesión distintos

​

Precedencia

​

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

​

Configuración

​

Pie personalizado de /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": "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

{
  "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 */
      ],
    },
  },
}

​

Rutas de contrato

​

Verbos

​

Formas de pieza

• { "text": "📚 {context.max_tokens|num}" }: literal + interpolación.
• { "when": "<path>", "text": "..." }: renderiza solo si la ruta es verdadera.
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } }: valor a glifo (un caso _default cubre valores sin coincidencia).
• { "each": "<array-path>", "item": "{label}" }: itera una ruta con valor de array (ninguna ruta del contrato actual es un array).

​

Ejemplo

{
  "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}",
        },
      ],
    },
  },
}

​

Proveedores + credenciales

• Anthropic (Claude): tokens OAuth en perfiles de autenticación. Si al token OAuth le falta el scope user:profile, recurre a una sesión web de claude.ai (CLAUDE_AI_SESSION_KEY, CLAUDE_WEB_SESSION_KEY, o una cookie sessionKey= en CLAUDE_WEB_COOKIE) cuando está configurada. Los límites por modelo y los gastos/presupuestos mensuales de uso adicional habilitados se incluyen cuando Anthropic los informa. Una clave explícita de Anthropic Admin API, o un perfil de proveedor sk-ant-admin... detectado automáticamente, muestra en su lugar el coste de la organización de 30 días y el historial de Messages API.
• ClawRouter: clave de API (CLAWROUTER_API_KEY). Muestra una ventana de presupuesto mensual y un presupuesto en USD tipado cuando está configurado; de lo contrario, muestra el gasto agregado y un resumen de solicitudes/tokens/coste.
• DeepSeek: clave de API mediante env/config/almacén de autenticación (DEEPSEEK_API_KEY). Muestra cada saldo de moneda informado por el proveedor.
• GitHub Copilot: tokens OAuth en perfiles de autenticación.
• Gemini CLI: tokens OAuth en perfiles de autenticación.
• MiniMax: clave de API o perfil de autenticación OAuth de MiniMax. OpenClaw trata minimax, minimax-cn y minimax-portal como la misma superficie de cuota de MiniMax, prefiere OAuth de MiniMax almacenado cuando está presente y, si no, recurre a MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY o MINIMAX_API_KEY. El sondeo de uso deriva el host de Coding Plan de models.providers.minimax-portal.baseUrl o models.providers.minimax.baseUrl cuando están configurados; de lo contrario, usa el host CN de MiniMax. Los campos sin procesar usage_percent / usagePercent de MiniMax significan cuota restante, así que OpenClaw los invierte antes de mostrarlos; los campos basados en recuento ganan cuando están presentes.
  • Las etiquetas de ventana provienen de los campos de horas/minutos del proveedor cuando están presentes, luego recurren al intervalo start_time / end_time.
  • Si el endpoint de coding-plan devuelve model_remains, OpenClaw prefiere la entrada del modelo de chat, deriva la etiqueta de ventana a partir de marcas de tiempo cuando los campos explícitos window_hours / window_minutes están ausentes, e incluye el nombre del modelo en la etiqueta del plan.
• OpenAI (plan Codex/ChatGPT): tokens OAuth en perfiles de autenticación (cabecera ChatGPT-Account-Id enviada cuando hay un id de cuenta presente). Muestra el plan ChatGPT, ventanas Codex restablecibles y un saldo de créditos cuando se informa. Los créditos siguen siendo créditos del proveedor; OpenClaw no los etiqueta como dólares. OPENAI_ADMIN_KEY añade coste de organización de 30 días e historial de uso de completions cuando la clave tiene acceso a Usage Dashboard. Las credenciales de inferencia nunca se reenvían a las API de organización.
• OpenRouter: clave de API o clave de API respaldada por OAuth (OPENROUTER_API_KEY o un perfil de autenticación). Combina el endpoint de créditos de la cuenta con el endpoint de cuota de la clave, de modo que el saldo/gasto de la cuenta, el presupuesto de la clave y el uso diario/semanal/mensual aparecen cuando la credencial puede acceder a ellos. Cualquiera de los endpoints puede enriquecer la instantánea de forma independiente.
• Venice: clave de API mediante env/config/almacén de autenticación (VENICE_API_KEY). Muestra saldos en USD y DIEM más el uso de asignación de época DIEM cuando se informa.
• Xiaomi MiMo: dos superficies de uso separadas. El pago por uso usa una clave de API (XIAOMI_API_KEY); el Token Plan usa una clave separada (XIAOMI_TOKEN_PLAN_API_KEY). Ninguno informa actualmente ventanas de cuota.
• z.ai: clave de API mediante env/config/almacén de autenticación (ZAI_API_KEY o Z_AI_API_KEY).

​

Relacionado

• Uso y costes de tokens
• Uso y costes de API
• Caché de prompts
• Barra de menús