Uso de API y costos
Este documento lista funcionalidades que pueden invocar claves API y dónde aparecen sus costos. Se enfoca en funcionalidades de OpenClaw que pueden generar uso de proveedores o llamadas API de pago.
Dónde aparecen los costos (chat + CLI)
Snapshot de costo por sesión
/statusmuestra el modelo de sesión actual, uso de contexto y tokens de la última respuesta.- Si el modelo usa autenticación por API key,
/statustambién muestra el costo estimado de la última respuesta.
Pie de costo por mensaje
/usage fullagrega un pie de uso a cada respuesta, incluyendo costo estimado (solo API key)./usage tokensmuestra solo tokens; los flujos OAuth ocultan el costo en dólares.
Consulta Uso de tokens y costos para detalles y ejemplos.
Cómo se descubren las claves
OpenClaw puede encontrar credenciales desde:
- Perfiles de autenticación (por agente, almacenados en
auth-profiles.json). - Variables de entorno (ej.
OPENAI_API_KEY,BRAVE_API_KEY,FIRECRAWL_API_KEY). - Configuración (
models.providers.*.apiKey,tools.web.search.*, etc.). - Habilidades (
skills.entries.<name>.apiKey).
Funcionalidades que pueden gastar claves
1) Respuestas del modelo core (chat + herramientas)
Cada respuesta o llamada de herramienta usa el proveedor de modelo actual. Esta es la fuente principal de uso y costo.
2) Comprensión de medios (audio/imagen/video)
Los medios entrantes pueden ser resumidos/transcritos antes de que se ejecute la respuesta.
3) Embeddings de memoria + búsqueda semántica
La búsqueda de memoria semántica usa APIs de embeddings cuando se configura para proveedores remotos.
4) Herramienta de búsqueda web
web_search usa claves API: Brave Search, Gemini, Grok, Kimi, Perplexity.
5) Herramienta de obtención web (Firecrawl)
web_fetch puede llamar a Firecrawl cuando hay una API key presente.
6) Snapshots de uso del proveedor (status/health)
Algunos comandos de estado llaman a endpoints de uso del proveedor.
7) Resumen de salvaguarda de compactación
La salvaguarda de compactación puede resumir el historial de sesión usando el modelo actual.
8) Escaneo/sondeo de modelos
openclaw models scan puede sondear modelos de OpenRouter.
9) Habla (speech)
El modo Talk puede invocar ElevenLabs cuando está configurado.
10) Habilidades (APIs de terceros)
Las habilidades pueden almacenar apiKey en skills.entries.<name>.apiKey.