Cómo rastrear tu uso de API en OpenClaw

¿Alguna vez has terminado una sesión de trabajo con la duda de cuánto te va a costar la factura del mes? Es frustrante no saber si estás cerca de agotar tu cuota o si el modelo que elegiste está consumiendo más de lo previsto. No deberías perder tiempo saltando entre dashboards web para entender tu gasto actual.

OpenClaw soluciona esto obteniendo los datos directamente de los endpoints de uso de los proveedores. No verás estimaciones genéricas, sino las ventanas de tiempo y consumos reales que reporta cada API.

Requisitos previos

Para visualizar estos datos, necesitas tener configuradas las credenciales correspondientes en tus perfiles de autenticación:

• Anthropic (Claude), GitHub Copilot, Gemini CLI y Antigravity: Requieren OAuth tokens.
• OpenAI Codex: OAuth tokens (utiliza accountId si está presente).
• MiniMax: API key (MINIMAX_CODE_PLAN_KEY o MINIMAX_API_KEY) para el plan de 5 horas.
• z.ai: API key configurada mediante variables de entorno, config o el almacén de autenticación.

Inicio rápido

Puedes consultar tu consumo de dos formas principales: mediante comandos de chat o a través de la CLI.

1. Comandos en el chat

Dentro de cualquier sesión de chat, usa estos comandos para obtener información inmediata:

• /status: Muestra una tarjeta con los tokens de la sesión y el costo estimado. Si el proveedor lo permite, verás el uso reportado por su API.
• /usage off|tokens|full: Configura el pie de página de cada respuesta. La opción full da el detalle completo, mientras que OAuth solo muestra tokens.
• /usage cost: Genera un resumen de costos locales basado en los logs de sesión de OpenClaw.

2. Comandos en la CLI

Si prefieres la terminal, estos comandos te dan una visión global:

• openclaw status --usage: Imprime un desglose completo por cada proveedor configurado.
• openclaw channels list: Muestra el estado del uso junto a la configuración de tus canales. Si quieres omitir esta información, añade el flag --no-usage.

Solución de problemas

Si los datos de uso no aparecen, revisa estos puntos:

• Credenciales ausentes: El sistema oculta automáticamente la sección de uso si no detecta tokens OAuth o API keys válidas para ese proveedor específico.
• Limitaciones de OAuth: Recuerda que para proveedores bajo OAuth, como GitHub Copilot, es posible que solo veas el conteo de tokens y no el costo financiero detallado.

¿Necesitas ayuda para configurar tus proveedores? Prueba el AI Setup Assistant.

Próximos pasos

• Configuración de canales y perfiles
• Gestión de logs de sesión