Gestión de costos y uso de API en OpenClaw

Configurar agentes de IA es genial hasta que llega la factura a fin de mes. A veces no está claro qué comando o qué herramienta está consumiendo tus créditos de forma silenciosa. Es frustrante ver cómo desaparece el presupuesto sin tener un desglose real de lo que está pasando bajo el capó mientras desarrollas.

Para evitar sorpresas, es mejor que configures la visibilidad de costos desde el primer minuto. Aquí tienes cómo OpenClaw gestiona tus API keys y dónde puedes rastrear cada centavo.

Requisitos previos

• OpenClaw instalado y configurado.
• API keys activas (OpenAI, Anthropic, Brave, etc.).
• Archivo auth-profiles.json o variables de entorno configuradas.

Inicio rápido

Sigue estos pasos para ver tu consumo actual en menos de 5 minutos:

1. Escribe /status en el chat para ver el modelo actual y el costo estimado de la última respuesta.
2. Activa el desglose automático con /usage full para que cada mensaje incluya un pie de página con el costo.
3. Ejecuta openclaw status --usage en tu terminal para ver las ventanas de cuota de tus providers.
4. Usa openclaw channels list para verificar el estado de salud de tus conexiones.

Cómo se descubren las keys

OpenClaw busca credenciales en varios lugares automáticamente:

• Auth profiles: Perfiles por agente guardados en auth-profiles.json.
• Environment variables: Variables como OPENAI_API_KEY, BRAVE_API_KEY o FIRECRAWL_API_KEY.
• Config: Ajustes en models.providers.*.apiKey, tools.web.search.* o memorySearch.*.
• Skills: Keys almacenadas en skills.entries.<name>.apiKey que se exportan al proceso de la skill.

Funciones que consumen créditos

1. Respuestas del modelo core

Cada interacción en el chat o llamada a herramientas usa el provider actual. Es la fuente principal de gasto.

2. Procesamiento de media

Si envías archivos, OpenClaw los procesa antes de responder:

• Audio: OpenAI, Groq o Deepgram (se activa solo si detecta las keys).
• Imagen: OpenAI, Anthropic o Google.
• Video: Google.

3. Memoria y embeddings

La búsqueda semántica usa APIs de embeddings si no usas la opción local:

• memorySearch.provider = "openai"
• memorySearch.provider = "gemini"
• memorySearch.provider = "voyage"

4. Herramientas de búsqueda web

web_search utiliza API keys externas:

• Brave Search API: Requiere BRAVE_API_KEY. El tier gratuito ofrece 2,000 requests/mes y 1 request/segundo (pide tarjeta para verificar).
• Perplexity: A través de OpenRouter usando PERPLEXITY_API_KEY.

5. Firecrawl para lectura web

La herramienta web_fetch usa Firecrawl si configuras FIRECRAWL_API_KEY. Si no hay key, hace un fetch directo sin costo de API.

6. Snapshots de uso y salud

Comandos como openclaw status --usage o openclaw models status --json hacen llamadas ligeras a los endpoints de los providers para mostrarte tus cuotas.

7. Resúmenes de compactación

Cuando la sesión es muy larga, el sistema resume el historial usando el modelo actual para ahorrar contexto, lo que genera un gasto pequeño de tokens.

8. Escaneo de modelos

El comando openclaw models scan puede sondear modelos en OpenRouter y consume créditos si el probing está activo.

9. Modo Talk (Voz)

Si usas el modo de voz con ElevenLabs (ELEVENLABS_API_KEY), cada respuesta generará costos de síntesis de voz.

10. Skills de terceros

Las skills pueden usar sus propias keys en skills.entries.<name>.apiKey para conectar con servicios externos.

Solución de problemas

• No veo el costo en dólares: Si usas flujos de OAuth, el costo monetario se oculta. Usa /usage tokens para ver al menos el conteo de datos.
• Brave Search falla: Verifica que hayas registrado una tarjeta en su Gateway. Aunque no te cobren el tier gratuito, la verificación es obligatoria.
• Gasto inesperado en memoria: Revisa si memorySearch.provider está en "local". Si usas "openai", cada fragmento guardado consumirá tokens de embedding.

¿Necesitas ayuda para configurar un provider específico? Prueba el AI Setup Assistant.

Próximos pasos

• Token use & costs
• Configuración de Models
• Uso de Memory
• Web tools