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 costo resultante.

Dónde aparecen los costos

/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 costo estimado para la última respuesta cuando OpenClaw dispone de metadatos de uso y precios locales para el modelo activo, incluidos proveedores sin clave de API cuyo precio se haya configurado explícitamente, como los modelos aws-sdk de Bedrock.
• Si la instantánea de la sesión activa 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 activos existentes distintos de cero prevalecen sobre los datos de la transcripción; un total de transcripción del tamaño del prompt aún puede prevalecer si el total almacenado falta o es menor.

/usage (pie de cada mensaje)

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

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

• Muestra los totales de tokens y costos 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 de finalización 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 mediante 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 de por vida. La interfaz advierte cuando faltan precios para algunas entradas.

Ventanas de uso de la CLI (cuotas del proveedor, no costo 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. Consulta CLI de modelos y CLI de canales para ver la lista completa de proveedores y opciones.
• 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 las credenciales OAuth/clave de API coincidentes de los perfiles de autenticación, el entorno o la configuración.

Consulta Uso y costos de tokens para ver ejemplos detallados.

Cómo se descubren las claves

• Perfiles de autenticación: específicos de cada 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, agents.defaults.memorySearch.*, 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 costos, incluidos los planes alojados basados en 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 ruta de inicio de sesión de Claude de Anthropic con Extra Usage habilitado.

Consulta Modelos para la configuración de precios y Uso y costos de tokens para su visualización.

Comprensión de contenido multimedia (audio/imagen/video)

El contenido multimedia entrante puede resumirse o transcribirse mediante la API de un proveedor antes de ejecutar el flujo de respuestas. La compatibilidad con proveedores se registra por Plugin y cambia a medida que se añaden Plugins; consulta Comprensión de contenido multimedia para conocer la lista y la configuración actuales.

Generación de imágenes y videos

image_generate y video_generate dirigen las solicitudes al proveedor configurado que esté disponible. La generación de imágenes puede inferir un proveedor predeterminado respaldado por autenticación cuando agents.defaults.imageGenerationModel no está definido; la generación de videos requiere un agents.defaults.videoGenerationModel explícito (por ejemplo, qwen/wan2.6-t2v).

Consulta Generación de imágenes y Generación de videos para conocer 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 agents.defaults.memorySearch.provider especifica un adaptador remoto (por ejemplo, openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). memorySearch.provider = "lmstudio" o "ollama" se ejecuta en un servidor local o autoalojado y, normalmente, no genera facturación de alojamiento. memorySearch.provider = "local" mantiene todo en el dispositivo sin usar ninguna API. Un proveedor opcional memorySearch.fallback puede cubrir los fallos de las incrustaciones locales.

Consulta Memoria.

Herramienta de búsqueda web

web_search puede generar cargos por uso según el proveedor seleccionado. Cada proveedor lee primero su clave de una variable de entorno y después de plugins.entries.<id>.config.webSearch.apiKey:

Las rutas de configuración heredadas tools.web.search.* aún se cargan mediante una capa de compatibilidad, pero ya no son la interfaz recomendada.

Crédito gratuito de Brave Search: cada plan incluye un crédito gratuito renovable de 5 USD al mes. El plan Search cuesta 5 USD por cada 1000 solicitudes, por lo que el crédito cubre 1000 solicitudes al mes sin cargo. Configura un límite de uso en el panel de Brave para evitar cargos inesperados.

Consulta Herramientas web.

Herramienta de obtención web (Firecrawl)

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

Consulta Herramientas web.

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

openclaw status --usage y openclaw models status --json llaman a los puntos de conexión de uso del proveedor para mostrar las ventanas de cuota o el estado de la autenticación. El volumen de llamadas es bajo, pero siguen accediendo a las API del proveedor.

Consulta CLI de modelos.

Resumen de protección 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.

Consulta Gestión de sesiones y Compaction.

Exploración/prueba de modelos

openclaw models scan puede probar modelos de OpenRouter y usa OPENROUTER_API_KEY cuando las pruebas están habilitadas.

Consulta 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.

Consulta Modo de conversación.

Skills (API de terceros)

Las Skills pueden almacenar apiKey en skills.entries.<name>.apiKey. Si una Skill usa esa clave con una API externa, el costo depende del proveedor de la Skill.

Consulta Skills.

Contenido relacionado

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