Uso y costes de la API

Mapa de las funciones de OpenClaw que pueden llamar a API de proveedores de pago, dónde lee cada una sus credenciales y dónde aparece el coste resultante.

Dónde aparecen los costes

/status (instantánea por sesión)

• Muestra el modelo de la sesión actual, el uso del contexto y los tokens de la última respuesta.
• Añade un coste estimado para la última respuesta cuando OpenClaw dispone de metadatos de uso y precios locales del modelo activo, incluidos proveedores sin clave de API con precios explícitos, como los modelos Bedrock aws-sdk.
• Si la instantánea de la sesión en curso contiene pocos datos, /status recupera los contadores de tokens/caché y la etiqueta del modelo activo de la entrada de uso más reciente de la transcripción. Los valores existentes distintos de cero de la sesión en curso prevalecen sobre los datos de la transcripción; un total de la transcripción del tamaño del prompt puede seguir prevaleciendo cuando falta el total almacenado o este es menor.

/usage (pie de página por mensaje)

• /usage full añade un pie de uso a cada respuesta, incluido el coste estimado cuando se han configurado precios locales y hay metadatos de uso disponibles.
• /usage tokens muestra solo los tokens. Los entornos de ejecución de CLI y OAuth/token de tipo suscripción muestran solo los tokens, salvo que proporcionen metadatos de uso compatibles y un precio local explícito.
• /usage cost imprime un resumen de costes local; /usage off desactiva el pie de página.
• Nota sobre Gemini CLI: tanto la salida de stream-json como la heredada de json incluyen el uso en stats. OpenClaw normaliza stats.cached como cacheRead y obtiene los tokens de entrada a partir de stats.input_tokens - stats.cached cuando es necesario.

Interfaz de control → Uso (análisis entre sesiones)

• Muestra los totales de tokens y costes estimados derivados de las transcripciones para el intervalo de fechas seleccionado, con desgloses por proveedor, modelo, agente, canal y tipo de token.
• Compara ventanas de calendario más cortas que terminan en la fecha final del intervalo seleccionado. Las fechas sin datos cuentan como días naturales con uso cero; no se omiten para crear una ventana más densa.
• Etiqueta directamente la escala del gráfico diario. Una insignia √ indica que la compresión por raíz cuadrada mantiene visibles los días de poco uso.
• Estos totales describen el historial de sesiones local disponible, no una factura del proveedor ni un registro de facturación acumulado. La interfaz advierte cuando faltan precios para algunas entradas.

Ventanas de uso de la CLI (cuotas del proveedor, no coste por mensaje)

• openclaw status --usage y openclaw channels list muestran las ventanas de uso del proveedor como X% left.
• Proveedores actuales de ventanas de uso: Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (incluye la autenticación mediante OAuth/token de ChatGPT/Codex), Xiaomi y z.ai. Consulte la CLI de modelos y la CLI de canales para ver la lista completa de proveedores y marcas.
• Los campos sin procesar usage_percent / usagePercent de MiniMax indican la cuota restante, por lo que OpenClaw los invierte; los campos basados en recuentos prevalecen cuando están presentes. Si la respuesta incluye una matriz model_remains, OpenClaw selecciona la entrada del modelo de chat, obtiene la etiqueta de la ventana a partir de las marcas de tiempo cuando es necesario e incluye el nombre del modelo en la etiqueta del plan.
• La autenticación de uso procede de enlaces específicos del proveedor cuando están disponibles; de lo contrario, OpenClaw recurre a credenciales OAuth/de clave de API coincidentes de los perfiles de autenticación, el entorno o la configuración.

Consulte Uso de tokens y costes para ver ejemplos detallados.

Cómo se detectan las claves

• Perfiles de autenticación: por agente, almacenados en auth-profiles.json.
• Variables de entorno: por ejemplo, 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, memory.search.*, talk.providers.*.apiKey.
• Skills: skills.entries.<name>.apiKey, que puede exportar la clave al entorno del proceso de la Skill.

Funciones que pueden consumir claves

Respuestas del modelo principal (chat + herramientas)

Cada respuesta o llamada a una herramienta se ejecuta en el proveedor del modelo actual. Esta es la principal fuente de uso y coste, incluidos los planes alojados de tipo suscripción cuya facturación se realiza fuera de la interfaz local de OpenClaw: OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan y la vía de inicio de sesión de Claude de Anthropic con Extra Usage activado.

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

Comprensión multimedia (audio/imagen/vídeo)

Los archivos multimedia entrantes pueden resumirse o transcribirse mediante la API de un proveedor antes de que se ejecute el pipeline de respuestas. La compatibilidad con los proveedores se registra por Plugin y cambia a medida que se añaden plugins; consulte Comprensión multimedia para ver la lista y la configuración actuales.

Generación de imágenes y vídeos

image_generate y video_generate se dirigen al proveedor autenticado que esté disponible. Ambos pueden inferir un proveedor predeterminado respaldado por autenticación cuando su entrada agents.defaults.mediaModels no está definida.

Consulte Generación de imágenes y Generación de vídeos para ver la lista actual de proveedores.

Incrustaciones de memoria y búsqueda semántica

La búsqueda semántica en memoria utiliza API de incrustaciones cuando memory.search.provider especifica un adaptador remoto (por ejemplo, openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). memory.search.provider = "lmstudio" o "ollama" se ejecutan en un servidor local o autoalojado y normalmente no tienen facturación de alojamiento. memory.search.provider = "local" mantiene todo en el dispositivo sin usar ninguna API. Un proveedor opcional memory.search.fallback puede cubrir los fallos de las incrustaciones locales.

Consulte Memoria.

Herramienta de búsqueda web

web_search puede generar cargos por uso en función del proveedor seleccionado. Cada proveedor lee primero su clave de una variable de entorno y, a continuación, de plugins.entries.<id>.config.webSearch.apiKey:

Las rutas de configuración heredadas tools.web.search.* siguen cargándose mediante una capa de compatibilidad, pero ya no son la opción recomendada.

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

Consulte Herramientas web.

Herramienta de obtención web (Firecrawl)

web_fetch puede llamar a Firecrawl con acceso inicial sin clave; añada FIRECRAWL_API_KEY (o plugins.entries.firecrawl.config.webFetch.apiKey) para obtener límites superiores. Si Firecrawl no está configurado, la herramienta recurre a la obtención directa junto con el Plugin web-readability incluido (sin API de pago). Desactive plugins.entries.web-readability.enabled para omitir la extracción local mediante Readability.

Consulte Herramientas web.

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

openclaw status --usage y openclaw models status --json llaman a los endpoints de uso del proveedor para mostrar las ventanas de cuota o el estado de autenticación. Las llamadas son poco frecuentes, pero aun así acceden a las API del proveedor.

Consulte CLI de modelos.

Resumen preventivo de Compaction

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

Consulte Gestión de sesiones y Compaction.

Análisis / sondeo de modelos

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

Consulte CLI de modelos.

Conversación (voz)

El modo de conversación puede invocar ElevenLabs cuando está configurado: ELEVENLABS_API_KEY o talk.providers.elevenlabs.apiKey.

Consulte Modo de conversación.

Skills (API de terceros)

Las Skills pueden almacenar apiKey en skills.entries.<name>.apiKey. Si una Skill utiliza esa clave con una API externa, el coste corresponde al proveedor de la Skill.

Consulte Skills.

Relacionado

• Uso de tokens y costes
• Almacenamiento en caché de prompts
• Seguimiento del uso