Uso y costes de la API

Este documento lista las características que pueden invocar claves de API y dónde aparecen sus costes. Se centra en las características de OpenClaw que pueden generar uso del proveedor o llamadas a APIs de pago.

Dónde aparecen los costes (chat + CLI)

Instantánea de costes por sesión

/status muestra el modelo de la sesión actual, el uso del contexto y los tokens de la última respuesta.
Si el modelo usa autenticación por clave de API, /status también muestra el coste estimado de la última respuesta.

Pie de página de costes por mensaje

/usage full añade un pie de página de uso a cada respuesta, incluyendo el coste estimado (solo clave de API).
/usage tokens muestra solo tokens; los flujos de OAuth ocultan el coste en dólares.

Ventanas de uso de la CLI (cuotas del proveedor)

openclaw status --usage y openclaw channels list muestran las ventanas de uso del proveedor (instantáneas de cuota, no costes por mensaje).

Consulte Uso y costes de tokens para obtener detalles y ejemplos.

Cómo se descubren las claves

OpenClaw puede obtener las credenciales de:

Perfiles de autenticación (por agente, almacenados en auth-profiles.json).
Variables de entorno (por ej. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
Configuración (models.providers.*.apiKey, tools.web.search.*, tools.web.fetch.firecrawl.*, memorySearch.*, talk.apiKey).
Habilidades (skills.entries.<name>.apiKey) que pueden exportar claves al entorno de proceso de la habilidad.

Características que pueden gastar claves

1) Respuestas del modelo principal (chat + herramientas)

Cada respuesta o llamada a herramienta utiliza el proveedor de modelo actual (OpenAI, Anthropic, etc.). Esta es la fuente principal de uso y coste.

Consulte Modelos para la configuración de precios y Uso y costes de tokens para su visualización.

2) Comprensión de medios (audio/imagen/vídeo)

Los medios entrantes pueden resumirse/transcribirse antes de que se ejecute la respuesta. Esto utiliza las APIs del modelo/proveedor.

Audio: OpenAI / Groq / Deepgram (ahora habilitado automáticamente cuando existen claves).
Imagen: OpenAI / Anthropic / Google.
Video: Google.

Consulte Comprensión de medios.

3) Incrustaciones de memoria + búsqueda semántica

La búsqueda de memoria semántica utiliza API de incrustación cuando se configura para proveedores remotos:

memorySearch.provider = "openai" → incrustaciones de OpenAI
memorySearch.provider = "gemini" → incrustaciones de Gemini
memorySearch.provider = "voyage" → incrustaciones de Voyage
memorySearch.provider = "mistral" → incrustaciones de Mistral
memorySearch.provider = "ollama" → incrustaciones de Ollama (local/autohospedado; generalmente sin facturación de API alojada)
Retorno opcional a un proveedor remoto si las incrustaciones locales fallan

Puede mantenerlo localmente con memorySearch.provider = "local" (sin uso de API).

Consulte Memoria.

4) Herramienta de búsqueda web

web_search utiliza claves de API y puede incurrir en cargos de uso dependiendo de su proveedor:

API de Brave Search: BRAVE_API_KEY o plugins.entries.brave.config.webSearch.apiKey
Gemini (Google Search): GEMINI_API_KEY o plugins.entries.google.config.webSearch.apiKey
Grok (xAI): XAI_API_KEY o plugins.entries.xai.config.webSearch.apiKey
Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY o plugins.entries.moonshot.config.webSearch.apiKey
API de Perplexity Search: PERPLEXITY_API_KEY, OPENROUTER_API_KEY o plugins.entries.perplexity.config.webSearch.apiKey

Las rutas de proveedor tools.web.search.* heredadas todavía se cargan a través del shim de compatibilidad temporal, pero ya no son la superficie de configuración recomendada.

Crédito gratuito de Brave Search: Cada plan de Brave incluye 5 $/mes en crédito gratuito renovable. El plan de Search cuesta 5 $ por cada 1000 solicitudes, por lo que el crédito cubre 1000 solicitudes/mes sin coste. Establezca su límite de uso en el panel de control de Brave para evitar cargos inesperados.

Consulte Herramientas web.

5) Herramienta de obtención web (Firecrawl)

web_fetch puede llamar a Firecrawl cuando hay una clave API presente:

FIRECRAWL_API_KEY o tools.web.fetch.firecrawl.apiKey

Si Firecrawl no está configurado, la herramienta recurre a la obtención directa + legibilidad (sin API de pago).

Consulte Herramientas web.

6) Instantáneas de uso del proveedor (estado/salud)

Algunos comandos de estado llaman a endpoint de uso del proveedor para mostrar ventanas de cuota o el estado de autenticación. Estas son típicamente llamadas de bajo volumen pero que aún así llegan a las API de los proveedores:

openclaw status --usage
openclaw models status --json

Consulte CLI de modelos.

7) Resumen de salvaguarda de compactación

La salvaguarda de compactación puede resumir el historial de la sesión usando el modelo actual, lo que invoca las API del proveedor cuando se ejecuta.

Consulte Gestión de sesiones + compactación.

8) Escaneo / sondeo de modelo

openclaw models scan puede sondear modelos de OpenRouter y usa OPENROUTER_API_KEY cuando el sondeo está habilitado.

Vea Modelos CLI.

9) Hablar (voz)

El modo de hablar puede invocar ElevenLabs cuando está configurado:

ELEVENLABS_API_KEY o talk.apiKey

Vea Modo de hablar.

10) Habilidades (APIs de terceros)

Las habilidades pueden almacenar apiKey en skills.entries.<name>.apiKey. Si una habilidad usa esa clave para APIs externas, puede incurrir en costos según el proveedor de la habilidad.

Vea Habilidades.