Uso de la API y costos

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

Dónde aparecen los costos (chat + CLI)

Instantánea de costos por sesión

/status muestra el modelo de la sesión actual, el uso del contexto y los tokens de la última respuesta.
Si OpenClaw tiene metadatos de uso y precios locales para el modelo activo, /status también muestra el costo estimado de la última respuesta. Esto puede incluir proveedores con precios explícitos que no son de clave de API, como los modelos aws-sdk de Bedrock.
Si los metadatos de la sesión en vivo son limitados, /status puede recuperar los contadores de tokens/caché y la etiqueta del modelo de tiempo de ejecución activo desde la entrada de uso más reciente de la transcripción. Los valores en vivo distintos de cero existentes aún tienen prioridad, y los totales de la transcripción del tamaño del prompt pueden predominar cuando los totales almacenados faltan o son menores.

Pie de página de costes por mensaje

/usage full añade un pie de página de uso a cada respuesta, incluyendo el costo estimado cuando se configura un precio local para el modelo activo y los metadatos de uso están disponibles.
/usage tokens muestra solo tokens; los flujos de OAuth/token de estilo suscripción y CLI siguen mostrando solo tokens a menos que ese tiempo de ejecución proporcione metadatos de uso compatibles y se configure un precio local explícito.
Nota de la CLI de Gemini: cuando la CLI devuelve una salida JSON, OpenClaw lee el uso desde stats, normaliza stats.cached en cacheRead, y deriva los tokens de entrada desde stats.input_tokens - stats.cached cuando es necesario.

Nota de Anthropic: el personal de Anthropic nos informó que el uso de la CLI de Claude al estilo OpenClaw está permitido de nuevo, por lo que OpenClaw trata el reuso de la CLI de Claude y el uso de claude -p como autorizados para esta integración, a menos que Anthropic publique una nueva política. Anthropic aún no expone una estimación en dólares por mensaje que OpenClaw pueda mostrar en /usage full.

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 costos por mensaje).
La salida humana se normaliza a X% left en todos los proveedores.
Proveedores de ventana de uso actuales: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi y z.ai.
Nota de MiniMax: sus campos usage_percent / usagePercent sin procesar significan la cuota restante, por lo que OpenClaw los invierte antes de mostrarlos. Los campos basados en recuento aún tienen prioridad cuando están presentes. Si el proveedor devuelve model_remains, OpenClaw prefiere la entrada del modelo de chat, deriva la etiqueta de la ventana de las marcas de tiempo cuando es necesario, e incluye el nombre del modelo en la etiqueta del plan.
La autenticación de uso para esas ventanas de cuota proviene de enlaces específicos del proveedor cuando están disponibles; de lo contrario, OpenClaw recurre a hacer coincidir las credenciales OAuth/API-key de los perfiles de autenticación, las variables de entorno o la configuración.

Consulte Uso de tokens y costes para ver 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 (p. ej. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
Configuración (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
Habilidades (skills.entries.<name>.apiKey) que pueden exportar claves al entorno del proceso de la habilidad.

Funciones que pueden consumir claves

1) Respuestas del modelo principal (chat + herramientas)

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

Esto también incluye proveedores alojados de estilo de suscripción que aún cobran fuera de la interfaz de usuario local de OpenClaw, como OpenAI Codex, Plan de codificación de Alibaba Cloud Model Studio, Plan de codificación de MiniMax, Plan de codificación de Z.AI / GLM, y la ruta de inicio de sesión de OpenClaw Claude de Anthropic con Uso adicional habilitado.

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

2) Comprensión de medios (audio/imagen/video)

Los medios entrantes se pueden resumir/transcribir antes de que se ejecute la respuesta. Esto utiliza las API del modelo/proveedor.

Audio: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
Imagen: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
Video: Google / Qwen / Moonshot.

Consulte Comprensión de medios.

3) Generación de imágenes y videos

Las capacidades de generación compartidas también pueden consumir claves de proveedores:

Generación de imágenes: OpenAI / Google / DeepInfra / fal / MiniMax
Generación de videos: DeepInfra / Qwen

La generación de imágenes puede inferir un proveedor predeterminado con autenticación cuando agents.defaults.imageGenerationModel no está configurado. La generación de vídeo actualmente requiere un agents.defaults.videoGenerationModel explícito, como qwen/wan2.6-t2v.

Consulte Generación de imágenes, Qwen Cloud y Modelos.

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

La búsqueda de memoria semántica utiliza API de incrustaciones 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 = "deepinfra" → incrustaciones de DeepInfra
memorySearch.provider = "lmstudio" → incrustaciones de LM Studio (local/autohospedado)
memorySearch.provider = "ollama" → incrustaciones de Ollama (local/autohospedado; típicamente 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.

5) Herramienta de búsqueda web

web_search puede incurrir en cargos de uso dependiendo de su proveedor:

API de Brave Search: BRAVE_API_KEY o plugins.entries.brave.config.webSearch.apiKey
Exa: EXA_API_KEY o plugins.entries.exa.config.webSearch.apiKey
Firecrawl: FIRECRAWL_API_KEY o plugins.entries.firecrawl.config.webSearch.apiKey
Gemini (Google Search): GEMINI_API_KEY o plugins.entries.google.config.webSearch.apiKey
Grok (xAI): perfil OAuth de 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
MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY, o plugins.entries.minimax.config.webSearch.apiKey
Ollama Web Search: sin clave para un host local de Ollama accesible y con sesión iniciada; la búsqueda https://ollama.com directa usa OLLAMA_API_KEY, y los hosts protegidos con autenticación pueden reutilizar la autenticación de portador (bearer auth) normal del proveedor Ollama
Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY, o plugins.entries.perplexity.config.webSearch.apiKey
Tavily: TAVILY_API_KEY o plugins.entries.tavily.config.webSearch.apiKey
DuckDuckGo: retorno sin clave (sin facturación de API, pero no oficial y basado en HTML)
SearXNG: SEARXNG_BASE_URL o plugins.entries.searxng.config.webSearch.baseUrl (sin clave/autohospedado; sin facturación de API alojada)

Las rutas del proveedor tools.web.search.* heredadas aún 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 búsqueda cuesta $5 por 1000 solicitudes, por lo que el crédito cubre 1000 solicitudes/mes sin costo. Establezca su límite de uso en el panel de Brave para evitar cargos inesperados.

Consulte Web tools.

5) Herramienta de recuperación web (Firecrawl)

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

FIRECRAWL_API_KEY o plugins.entries.firecrawl.config.webFetch.apiKey

Si Firecrawl no está configurado, la herramienta recurre a una obtención directa más el complemento web-readability incluido (sin API de pago). Desactive plugins.entries.web-readability.enabled para omitir la extracción local de Readability.

Consulte Web tools.

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

Algunos comandos de estado llaman a endpoints de uso del proveedor para mostrar ventanas de cuota o estado de autenticación. Por lo general, son llamadas de bajo volumen pero aún así golpean las API de los proveedores:

openclaw status --usage
openclaw models status --json

Consulte Models CLI.

7) Resumen de protección de compactación

El mecanismo de protección de compactación puede resumir el historial de la sesión utilizando el modelo actual, lo cual invoca las APIs del proveedor cuando se ejecuta.

Consulte Session management + compaction.

8) Escaneo / sondeo de modelo

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

Consulte Models CLI.

9) Talk (voz)

El modo Talk puede invocar ElevenLabs cuando está configurado:

ELEVENLABS_API_KEY o talk.providers.elevenlabs.apiKey

Consulte Talk mode.

10) Habilidades (APIs de terceros)

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

Consulte Skills.