Seguimiento de uso

# Qué es

• Extrae el uso/cuota del proveedor directamente desde sus endpoints de uso.
• Sin costos estimados; solo las ventanas reportadas por el proveedor.
• La salida de estado legible para humanos se normaliza a X% left, incluso cuando una API upstream reporta cuota consumida, cuota restante o solo conteos sin procesar.
• /status y session_status a nivel de sesión pueden recurrir a la entrada de uso más reciente de la transcripción cuando la instantánea de sesión en vivo es escasa. Ese respaldo rellena contadores faltantes de tokens/caché, puede recuperar la etiqueta del modelo de runtime activo y prefiere el total orientado al prompt más grande cuando faltan metadatos de sesión o son menores. Los valores en vivo existentes distintos de cero siguen teniendo prioridad.

# Dónde aparece

• /status en chats: tarjeta de estado rica en emoji con tokens de sesión + costo estimado (solo clave de API). El uso del proveedor se muestra para el proveedor del modelo actual cuando está disponible como una ventana normalizada X% left.
• /usage off|tokens|full en chats: pie de uso por respuesta (OAuth muestra solo tokens).
• /usage cost en chats: resumen de costo local agregado desde los registros de sesión de OpenClaw.
• CLI: openclaw status --usage imprime un desglose completo por proveedor.
• CLI: openclaw channels list imprime la misma instantánea de uso junto con la configuración del proveedor (usa --no-usage para omitirla).
• barra de menú de macOS: sección "Uso" bajo Contexto (solo si está disponible).

# Proveedores + credenciales

• Anthropic (Claude): tokens OAuth en perfiles de autenticación.
• GitHub Copilot: tokens OAuth en perfiles de autenticación.
• Gemini CLI: tokens OAuth en perfiles de autenticación.
  • El uso JSON recurre a stats; stats.cached se normaliza en cacheRead.
• OpenAI Codex: tokens OAuth en perfiles de autenticación (accountId se usa cuando está presente).
• 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, de lo contrario, recurre a MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY o MINIMAX_API_KEY. El sondeo de uso deriva el host del Coding Plan desde models.providers.minimax-portal.baseUrl o models.providers.minimax.baseUrl cuando está configurado y, de lo contrario, usa el host CN de MiniMax. Los campos sin procesar usage_percent / usagePercent de MiniMax significan cuota restante, por lo que OpenClaw los invierte antes de mostrarlos; los campos basados en conteo tienen prioridad cuando están presentes.
  • Las etiquetas de ventana del plan de codificación provienen de los campos de horas/minutos del proveedor cuando están presentes y luego recurren al intervalo start_time / end_time.
  • Si el endpoint del plan de codificación devuelve model_remains, OpenClaw prefiere la entrada del modelo de chat, deriva la etiqueta de ventana de las 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.
• Xiaomi MiMo: clave de API mediante env/config/almacén de autenticación (XIAOMI_API_KEY).
• z.ai: clave de API mediante env/config/almacén de autenticación.

El uso se oculta cuando no se puede resolver ninguna autenticación de uso de proveedor utilizable. Los proveedores pueden suministrar lógica de autenticación de uso específica de plugin; de lo contrario, OpenClaw recurre a credenciales OAuth/clave de API coincidentes desde perfiles de autenticación, variables de entorno o configuración.

# Relacionado

• Uso de tokens y costos
• Uso y costos de API
• Caché de prompts