chore(i18n): refresh es translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-13 08:52:28 +00:00
parent 1fe7968032
commit e25d2d56df
5 changed files with 481 additions and 340 deletions

View File

@ -1,41 +1,41 @@
---
read_when:
- Necesitas una referencia de configuración de modelos por proveedor
- Necesitas una referencia de configuración de modelos proveedor por proveedor
- Quieres configuraciones de ejemplo o comandos de incorporación de CLI para proveedores de modelos
summary: Descripción general de los proveedores de modelos con configuraciones de ejemplo + flujos de CLI
title: Proveedores de modelos
x-i18n:
generated_at: "2026-04-11T02:44:17Z"
generated_at: "2026-04-13T08:50:32Z"
model: gpt-5.4
provider: openai
source_hash: 910ea7895e74c03910757d9d3e02825754b779b204eca7275b28422647ed0151
source_hash: 66ba688c4b4366eec07667571e835d4cfeee684896e2ffae11d601b5fa0a4b98
source_path: concepts/model-providers.md
workflow: 15
---
# Proveedores de modelos
Esta página cubre los **proveedores de LLM/modelos** (no los canales de chat como WhatsApp/Telegram).
Esta página cubre los **proveedores de LLM/modelos** (no canales de chat como WhatsApp/Telegram).
Para las reglas de selección de modelos, consulta [/concepts/models](/es/concepts/models).
## Reglas rápidas
- Las referencias de modelo usan `provider/model` (ejemplo: `opencode/claude-opus-4-6`).
- Las referencias de modelos usan `provider/model` (ejemplo: `opencode/claude-opus-4-6`).
- Si configuras `agents.defaults.models`, se convierte en la lista de permitidos.
- Ayudantes de CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set <provider/model>`.
- Las reglas de runtime de respaldo, las sondas de enfriamiento y la persistencia de anulación de sesión
- Las reglas de runtime de respaldo, las sondas de enfriamiento y la persistencia de las anulaciones de sesión
están documentadas en [/concepts/model-failover](/es/concepts/model-failover).
- `models.providers.*.models[].contextWindow` son metadatos nativos del modelo;
`models.providers.*.models[].contextTokens` es el límite efectivo de runtime.
- Los plugins de proveedor pueden inyectar catálogos de modelos mediante `registerProvider({ catalog })`;
`models.providers.*.models[].contextTokens` es el límite efectivo del runtime.
- Los plugins de proveedores pueden inyectar catálogos de modelos mediante `registerProvider({ catalog })`;
OpenClaw fusiona esa salida en `models.providers` antes de escribir
`models.json`.
- Los manifiestos de proveedor pueden declarar `providerAuthEnvVars` y
- Los manifiestos de proveedores pueden declarar `providerAuthEnvVars` y
`providerAuthAliases` para que las sondas genéricas de autenticación basadas en variables de entorno y las variantes de proveedor
no necesiten cargar el runtime del plugin. El mapa restante de variables de entorno del núcleo ahora
es solo para proveedores no basados en plugins/del núcleo y algunos casos genéricos de precedencia, como
la incorporación de Anthropic con prioridad en la clave de API.
- Los plugins de proveedor también pueden encargarse del comportamiento de runtime del proveedor mediante
es solo para proveedores no basados en plugins/del núcleo y algunos casos de precedencia genérica tales
como la incorporación con prioridad de clave de API de Anthropic.
- Los plugins de proveedores también pueden encargarse del comportamiento de runtime del proveedor mediante
`normalizeModelId`, `normalizeTransport`, `normalizeConfig`,
`applyNativeStreamingUsageCompat`, `resolveConfigApiKey`,
`resolveSyntheticAuth`, `shouldDeferSyntheticProfileAuth`,
@ -53,224 +53,182 @@ Para las reglas de selección de modelos, consulta [/concepts/models](/es/concep
`resolveDefaultThinkingLevel`, `applyConfigDefaults`, `isModernModelRef`,
`prepareRuntimeAuth`, `resolveUsageAuth`, `fetchUsageSnapshot`, y
`onModelSelected`.
- Nota: las `capabilities` de runtime del proveedor son metadatos compartidos del ejecutor (familia del proveedor, peculiaridades de transcripción/herramientas, pistas de transporte/caché). No es lo
- Nota: `capabilities` del runtime del proveedor son metadatos compartidos del ejecutor (familia del proveedor,
peculiaridades de transcripción/herramientas, pistas de transporte/caché). No es lo
mismo que el [modelo de capacidades públicas](/es/plugins/architecture#public-capability-model)
que describe lo que registra un plugin (inferencia de texto, voz, etc.).
- El proveedor `codex` incluido está emparejado con el arnés de agente Codex incluido.
Usa `codex/gpt-*` cuando quieras inicio de sesión gestionado por Codex, detección de modelos,
- El proveedor `codex` incluido se empareja con el arnés de agente Codex incluido.
Usa `codex/gpt-*` cuando quieras inicio de sesión administrado por Codex, descubrimiento de modelos,
reanudación nativa de hilos y ejecución en servidor de aplicaciones. Las referencias simples `openai/gpt-*` siguen
usando el proveedor OpenAI y el transporte normal de proveedor de OpenClaw.
Los despliegues solo con Codex pueden desactivar el respaldo automático a PI con
Las implementaciones solo de Codex pueden desactivar el respaldo automático a PI con
`agents.defaults.embeddedHarness.fallback: "none"`; consulta
[Codex Harness](/es/plugins/codex-harness).
## Comportamiento de proveedor gestionado por plugins
## Comportamiento del proveedor administrado por plugins
Los plugins de proveedor ahora pueden encargarse de la mayor parte de la lógica específica del proveedor, mientras OpenClaw mantiene
Los plugins de proveedores ahora pueden encargarse de la mayor parte de la lógica específica del proveedor, mientras que OpenClaw mantiene
el bucle genérico de inferencia.
División típica:
Separación típica:
- `auth[].run` / `auth[].runNonInteractive`: el proveedor se encarga de los flujos de incorporación/inicio de sesión
para `openclaw onboard`, `openclaw models auth` y la configuración sin interacción
- `wizard.setup` / `wizard.modelPicker`: el proveedor se encarga de las etiquetas de elección de autenticación,
alias heredados, sugerencias de lista de permitidos para la incorporación y entradas de configuración en los selectores de incorporación/modelo
alias heredados, sugerencias de lista de permitidos para la incorporación y entradas de configuración en los selectores de incorporación/modelos
- `catalog`: el proveedor aparece en `models.providers`
- `normalizeModelId`: el proveedor normaliza los ID de modelo heredados/de vista previa antes de la
búsqueda o canonicalización
- `normalizeModelId`: el proveedor normaliza ids de modelos heredados/de vista previa antes de la
búsqueda o la canonicalización
- `normalizeTransport`: el proveedor normaliza `api` / `baseUrl` de la familia de transporte
antes del ensamblado genérico del modelo; OpenClaw verifica primero el proveedor coincidente,
luego otros plugins de proveedor con capacidad de hooks hasta que uno realmente cambie el
antes del ensamblado genérico del modelo; OpenClaw comprueba primero el proveedor coincidente,
luego otros plugins de proveedores con capacidad de hook hasta que uno realmente cambie el
transporte
- `normalizeConfig`: el proveedor normaliza la configuración de `models.providers.<id>` antes de que
el runtime la use; OpenClaw verifica primero el proveedor coincidente, luego otros
plugins de proveedor con capacidad de hooks hasta que uno realmente cambie la configuración. Si ningún
hook de proveedor reescribe la configuración, los ayudantes incluidos de la familia Google igualmente
normalizan las entradas compatibles de proveedores de Google.
- `applyNativeStreamingUsageCompat`: el proveedor aplica reescrituras de compatibilidad de uso de streaming nativo basadas en endpoints para proveedores de configuración
- `resolveConfigApiKey`: el proveedor resuelve autenticación con marcador de entorno para proveedores de configuración
- `normalizeConfig`: el proveedor normaliza la configuración `models.providers.<id>` antes de que
el runtime la use; OpenClaw comprueba primero el proveedor coincidente, luego otros
plugins de proveedores con capacidad de hook hasta que uno realmente cambie la configuración. Si ningún
hook de proveedor reescribe la configuración, los ayudantes incluidos de la familia Google siguen
normalizando las entradas compatibles de proveedores de Google.
- `applyNativeStreamingUsageCompat`: el proveedor aplica reescrituras de compatibilidad de uso de streaming nativo impulsadas por el endpoint para proveedores de configuración
- `resolveConfigApiKey`: el proveedor resuelve la autenticación con marcador de entorno para proveedores de configuración
sin forzar la carga completa de la autenticación de runtime. `amazon-bedrock` también tiene aquí un
resolvedor integrado de marcadores de entorno de AWS, aunque la autenticación de runtime de Bedrock usa
resolvedor integrado de marcadores de entorno de AWS, aunque la autenticación de runtime de Bedrock use
la cadena predeterminada del SDK de AWS.
- `resolveSyntheticAuth`: el proveedor puede exponer disponibilidad de autenticación local/autohospedada u otra
autenticación basada en configuración sin persistir secretos en texto plano
- `shouldDeferSyntheticProfileAuth`: el proveedor puede marcar los marcadores de posición sintéticos almacenados del perfil
como de menor precedencia que la autenticación basada en entorno/configuración
- `resolveDynamicModel`: el proveedor acepta ID de modelo que todavía no están presentes en el
autenticación respaldada por configuración sin persistir secretos en texto plano
- `shouldDeferSyntheticProfileAuth`: el proveedor puede marcar marcadores almacenados de perfiles sintéticos
como de menor precedencia que la autenticación respaldada por entorno/configuración
- `resolveDynamicModel`: el proveedor acepta ids de modelos que todavía no están presentes en el
catálogo estático local
- `prepareDynamicModel`: el proveedor necesita una actualización de metadatos antes de reintentar
la resolución dinámica
- `prepareDynamicModel`: el proveedor necesita una actualización de metadatos antes de reintentar la
resolución dinámica
- `normalizeResolvedModel`: el proveedor necesita reescrituras de transporte o URL base
- `contributeResolvedModelCompat`: el proveedor aporta indicadores de compatibilidad para sus
modelos del proveedor incluso cuando llegan mediante otro transporte compatible
modelos del proveedor incluso cuando llegan a través de otro transporte compatible
- `capabilities`: el proveedor publica peculiaridades de transcripción/herramientas/familia de proveedor
- `normalizeToolSchemas`: el proveedor limpia los esquemas de herramientas antes de que el
ejecutor integrado los vea
- `inspectToolSchemas`: el proveedor muestra advertencias de esquema específicas del transporte
- `inspectToolSchemas`: el proveedor muestra advertencias de esquemas específicas del transporte
después de la normalización
- `resolveReasoningOutputMode`: el proveedor elige contratos de salida de razonamiento
nativos frente a etiquetados
- `prepareExtraParams`: el proveedor establece valores predeterminados o normaliza parámetros de solicitud por modelo
- `createStreamFn`: el proveedor reemplaza la ruta normal de streaming por un
transporte completamente personalizado
- `wrapStreamFn`: el proveedor aplica envoltorios de compatibilidad de encabezados/cuerpo/modelo de solicitud
- `resolveTransportTurnState`: el proveedor suministra encabezados o metadatos nativos de transporte
por turno
- `prepareExtraParams`: el proveedor establece por defecto o normaliza parámetros de solicitud por modelo
- `createStreamFn`: el proveedor reemplaza la ruta de streaming normal por un
transporte totalmente personalizado
- `wrapStreamFn`: el proveedor aplica envolturas de compatibilidad para encabezados/cuerpo/modelo de la solicitud
- `resolveTransportTurnState`: el proveedor suministra encabezados o metadatos
nativos de transporte por turno
- `resolveWebSocketSessionPolicy`: el proveedor suministra encabezados nativos de sesión WebSocket
o una política de enfriamiento de sesión
- `createEmbeddingProvider`: el proveedor se encarga del comportamiento de embeddings de memoria cuando
pertenece al plugin del proveedor en lugar de al conmutador central de embeddings del núcleo
- `formatApiKey`: el proveedor formatea perfiles de autenticación almacenados en la cadena
de `apiKey` de runtime esperada por el transporte
- `refreshOAuth`: el proveedor se encarga de la actualización de OAuth cuando los actualizadores compartidos de `pi-ai`
corresponde al plugin del proveedor en lugar del switchboard central de embeddings
- `formatApiKey`: el proveedor da formato a los perfiles de autenticación almacenados en la cadena
`apiKey` de runtime que espera el transporte
- `refreshOAuth`: el proveedor se encarga de la actualización de OAuth cuando los actualizadores compartidos `pi-ai`
no son suficientes
- `buildAuthDoctorHint`: el proveedor agrega guía de reparación cuando falla la
actualización de OAuth
- `buildAuthDoctorHint`: el proveedor agrega orientación de reparación cuando la actualización de OAuth
falla
- `matchesContextOverflowError`: el proveedor reconoce errores de desbordamiento de ventana de contexto
específicos del proveedor que las heurísticas genéricas no detectarían
- `classifyFailoverReason`: el proveedor asigna errores brutos específicos del proveedor de transporte/API
a motivos de conmutación por error, como límite de tasa o sobrecarga
- `isCacheTtlEligible`: el proveedor decide qué ID de modelo ascendentes admiten TTL de caché de prompts
- `classifyFailoverReason`: el proveedor asigna errores sin procesar de transporte/API específicos del proveedor
a motivos de failover como límite de tasa o sobrecarga
- `isCacheTtlEligible`: el proveedor decide qué ids de modelos upstream admiten TTL de caché de prompts
- `buildMissingAuthMessage`: el proveedor reemplaza el error genérico del almacén de autenticación
por una sugerencia de recuperación específica del proveedor
- `suppressBuiltInModel`: el proveedor oculta filas ascendentes obsoletas y puede devolver un
error gestionado por el proveedor para fallos de resolución directa
- `suppressBuiltInModel`: el proveedor oculta filas upstream obsoletas y puede devolver un
error administrado por el proveedor para fallos de resolución directa
- `augmentModelCatalog`: el proveedor agrega filas sintéticas/finales del catálogo después del
descubrimiento y la fusión de configuración
- `isBinaryThinking`: el proveedor se encarga de la UX de pensamiento binario activado/desactivado
- `isBinaryThinking`: el proveedor se encarga de la UX binaria de thinking activado/desactivado
- `supportsXHighThinking`: el proveedor habilita `xhigh` para modelos seleccionados
- `resolveDefaultThinkingLevel`: el proveedor se encarga de la política predeterminada de `/think` para una
familia de modelos
- `applyConfigDefaults`: el proveedor aplica valores predeterminados globales específicos del proveedor
durante la materialización de la configuración según el modo de autenticación, el entorno o la familia del modelo
- `isModernModelRef`: el proveedor se encarga de la coincidencia de modelos preferidos para pruebas en vivo/smoke
durante la materialización de configuración según el modo de autenticación, el entorno o la familia de modelos
- `isModernModelRef`: el proveedor se encarga de la coincidencia de modelos preferidos en pruebas live/smoke
- `prepareRuntimeAuth`: el proveedor convierte una credencial configurada en un token de runtime
de corta duración
- `resolveUsageAuth`: el proveedor resuelve credenciales de uso/cuota para `/usage`
y superficies relacionadas de estado/informes
- `fetchUsageSnapshot`: el proveedor se encarga de la obtención/análisis del endpoint de uso, mientras
- `fetchUsageSnapshot`: el proveedor se encarga de la obtención/análisis del endpoint de uso, mientras que
el núcleo sigue encargándose del contenedor de resumen y del formato
- `onModelSelected`: el proveedor ejecuta efectos secundarios posteriores a la selección, como
telemetría o gestión de sesión propia del proveedor
telemetría o contabilidad de sesión administrada por el proveedor
Ejemplos incluidos actualmente:
Ejemplos actuales incluidos:
- `anthropic`: respaldo de compatibilidad futura para Claude 4.6, sugerencias de reparación de autenticación, obtención de endpoints
de uso, metadatos de TTL de caché/familia de proveedor y valores globales predeterminados de configuración
conscientes de la autenticación
- `amazon-bedrock`: coincidencia de desbordamiento de contexto gestionada por el proveedor y clasificación
de motivos de conmutación por error para errores específicos de Bedrock de limitación/no listo, además de
la familia compartida de reproducción `anthropic-by-model` para protecciones de política de reproducción exclusivas de Claude
en tráfico de Anthropic
- `anthropic-vertex`: protecciones de política de reproducción exclusivas de Claude en tráfico
de mensajes de Anthropic
- `openrouter`: ID de modelo de paso directo, envoltorios de solicitudes, sugerencias de capacidad del proveedor,
saneamiento de firmas de pensamiento de Gemini en tráfico Gemini a través de proxy, inyección
de razonamiento del proxy mediante la familia de stream `openrouter-thinking`, reenvío de
metadatos de enrutamiento y política de TTL de caché
- `github-copilot`: incorporación/inicio de sesión en dispositivo, respaldo de modelos de compatibilidad futura,
sugerencias de transcripción de pensamiento de Claude, intercambio de tokens de runtime y obtención de endpoints
de uso
- `openai`: respaldo de compatibilidad futura para GPT-5.4, normalización directa del transporte OpenAI,
sugerencias de autenticación faltante conscientes de Codex, supresión de Spark, filas sintéticas
de catálogo OpenAI/Codex, política de pensamiento/modelo en vivo, normalización de alias de tokens
de uso (familias `input` / `output` y `prompt` / `completion`), la familia compartida de stream
`openai-responses-defaults` para envoltorios nativos OpenAI/Codex, metadatos de familia del proveedor,
registro incluido de proveedor de generación de imágenes para `gpt-image-1` y registro
incluido de proveedor de generación de video para `sora-2`
- `google` y `google-gemini-cli`: respaldo de compatibilidad futura para Gemini 3.1,
validación nativa de reproducción de Gemini, saneamiento de reproducción de bootstrap, modo etiquetado
de salida de razonamiento, coincidencia de modelos modernos, registro incluido de proveedor
de generación de imágenes para modelos Gemini image-preview y registro incluido
de proveedor de generación de video para modelos Veo; Gemini CLI OAuth también
se encarga del formateo de tokens de perfil de autenticación, del análisis de tokens de uso y de la obtención
de endpoints de cuota para superficies de uso
- `moonshot`: transporte compartido, normalización de carga de pensamiento gestionada por el plugin
- `kilocode`: transporte compartido, encabezados de solicitud gestionados por el plugin, normalización
de carga de razonamiento, saneamiento de firmas de pensamiento de Gemini a través de proxy y política
de TTL de caché
- `zai`: respaldo de compatibilidad futura para GLM-5, valores predeterminados de `tool_stream`, política de TTL de caché,
política de pensamiento binario/modelo en vivo y autenticación de uso + obtención de cuotas;
los ID desconocidos `glm-5*` se sintetizan a partir de la plantilla incluida `glm-4.7`
- `xai`: normalización nativa del transporte Responses, reescrituras de alias `/fast` para
variantes rápidas de Grok, `tool_stream` predeterminado, limpieza específica de xAI de esquemas
de herramientas/carga de razonamiento y registro incluido de proveedor de generación de video
para `grok-imagine-video`
- `mistral`: metadatos de capacidades gestionados por el plugin
- `opencode` y `opencode-go`: metadatos de capacidades gestionados por el plugin más
saneamiento de firmas de pensamiento de Gemini a través de proxy
- `alibaba`: catálogo de generación de video gestionado por el plugin para referencias directas de modelos Wan
como `alibaba/wan2.6-t2v`
- `byteplus`: catálogos gestionados por el plugin más registro incluido de proveedor de generación de video
para modelos Seedance de texto a video/imagen a video
- `fal`: registro incluido de proveedor de generación de video para proveedores alojados de terceros
y registro incluido de proveedor de generación de imágenes para modelos de imagen FLUX, además de registro incluido
de proveedor de generación de video para modelos de video alojados de terceros
- `anthropic`: compatibilidad futura de Claude 4.6 con fallback, sugerencias de reparación de autenticación, obtención del endpoint de uso, metadatos de TTL de caché/familia de proveedor y valores predeterminados globales de configuración con reconocimiento de autenticación
- `amazon-bedrock`: coincidencia de desbordamiento de contexto administrada por el proveedor y clasificación del motivo de failover para errores específicos de Bedrock de limitación/no listo, además de la familia compartida de reproducción `anthropic-by-model` para protecciones de política de reproducción solo de Claude sobre tráfico de Anthropic
- `anthropic-vertex`: protecciones de política de reproducción solo de Claude sobre tráfico de mensajes de Anthropic
- `openrouter`: ids de modelos de paso directo, envolturas de solicitudes, sugerencias de capacidades del proveedor, saneamiento de firmas de pensamiento de Gemini en tráfico Gemini a través de proxy, inyección de razonamiento del proxy mediante la familia de streams `openrouter-thinking`, reenvío de metadatos de enrutamiento y política de TTL de caché
- `github-copilot`: incorporación/inicio de sesión en dispositivo, fallback de modelo con compatibilidad futura, sugerencias de transcripción de pensamiento de Claude, intercambio de tokens de runtime y obtención del endpoint de uso
- `openai`: fallback con compatibilidad futura de GPT-5.4, normalización directa del transporte de OpenAI, sugerencias de autenticación faltante con reconocimiento de Codex, supresión de Spark, filas sintéticas de catálogo de OpenAI/Codex, política de thinking/modelo live, normalización de alias de tokens de uso (`input` / `output` y familias `prompt` / `completion`), la familia compartida de streams `openai-responses-defaults` para envolturas nativas de OpenAI/Codex, metadatos de familia de proveedor, registro incluido del proveedor de generación de imágenes para `gpt-image-1` y registro incluido del proveedor de generación de video para `sora-2`
- `google` y `google-gemini-cli`: fallback con compatibilidad futura de Gemini 3.1, validación nativa de reproducción de Gemini, saneamiento de reproducción de bootstrap, modo de salida de razonamiento etiquetado, coincidencia de modelos modernos, registro incluido del proveedor de generación de imágenes para modelos Gemini image-preview y registro incluido del proveedor de generación de video para modelos Veo; Gemini CLI OAuth también se encarga del formato de tokens del perfil de autenticación, del análisis de tokens de uso y de la obtención del endpoint de cuota para superficies de uso
- `moonshot`: transporte compartido, normalización de payload de thinking administrada por el plugin
- `kilocode`: transporte compartido, encabezados de solicitud administrados por el plugin, normalización de payload de razonamiento, saneamiento de firmas de pensamiento de Gemini a través de proxy y política de TTL de caché
- `zai`: fallback con compatibilidad futura de GLM-5, valores predeterminados de `tool_stream`, política de TTL de caché, política de thinking binario/modelo live y autenticación de uso + obtención de cuota; los ids desconocidos `glm-5*` se sintetizan a partir de la plantilla incluida `glm-4.7`
- `xai`: normalización nativa del transporte Responses, reescrituras de alias `/fast` para variantes rápidas de Grok, `tool_stream` predeterminado, limpieza específica de xAI de esquemas de herramientas / payload de razonamiento y registro incluido del proveedor de generación de video para `grok-imagine-video`
- `mistral`: metadatos de capacidades administrados por el plugin
- `opencode` y `opencode-go`: metadatos de capacidades administrados por el plugin más saneamiento de firmas de pensamiento de Gemini a través de proxy
- `alibaba`: catálogo de generación de video administrado por el plugin para referencias directas de modelos Wan, como `alibaba/wan2.6-t2v`
- `byteplus`: catálogos administrados por el plugin más registro incluido del proveedor de generación de video para modelos Seedance de texto a video/imagen a video
- `fal`: registro incluido del proveedor de generación de video para modelos de terceros alojados y registro incluido del proveedor de generación de imágenes para modelos de imagen FLUX, además de registro incluido del proveedor de generación de video para modelos de video de terceros alojados
- `cloudflare-ai-gateway`, `huggingface`, `kimi`, `nvidia`, `qianfan`,
`stepfun`, `synthetic`, `venice`, `vercel-ai-gateway` y `volcengine`:
solo catálogos gestionados por el plugin
- `qwen`: catálogos gestionados por el plugin para modelos de texto más registros compartidos
de proveedores de comprensión multimedia y generación de video para sus superficies multimodales;
la generación de video de Qwen usa los endpoints de video Standard DashScope con
modelos Wan incluidos como `wan2.6-t2v` y `wan2.7-r2v`
- `runway`: registro de proveedor de generación de video gestionado por el plugin para modelos nativos
basados en tareas de Runway como `gen4.5`
- `minimax`: catálogos gestionados por el plugin, registro incluido de proveedor de generación de video
para modelos de video Hailuo, registro incluido de proveedor de generación de imágenes
para `image-01`, selección híbrida de política de reproducción Anthropic/OpenAI y lógica
de autenticación/instantánea de uso
- `together`: catálogos gestionados por el plugin más registro incluido de proveedor de generación de video
para modelos de video Wan
- `xiaomi`: catálogos gestionados por el plugin más lógica de autenticación/instantánea de uso
solo catálogos administrados por plugins
- `qwen`: catálogos administrados por plugins para modelos de texto más registros compartidos de proveedores de comprensión multimedia y generación de video para sus superficies multimodales; la generación de video de Qwen usa los endpoints de video estándar de DashScope con modelos Wan incluidos como `wan2.6-t2v` y `wan2.7-r2v`
- `runway`: registro de proveedor de generación de video administrado por el plugin para modelos nativos basados en tareas de Runway como `gen4.5`
- `minimax`: catálogos administrados por plugins, registro incluido del proveedor de generación de video para modelos de video Hailuo, registro incluido del proveedor de generación de imágenes para `image-01`, selección híbrida de política de reproducción Anthropic/OpenAI y lógica de autenticación/snapshot de uso
- `together`: catálogos administrados por plugins más registro incluido del proveedor de generación de video para modelos de video Wan
- `xiaomi`: catálogos administrados por plugins más lógica de autenticación/snapshot de uso
El plugin `openai` incluido ahora se encarga de ambos ID de proveedor: `openai` y
El plugin `openai` incluido ahora administra ambos ids de proveedor: `openai` y
`openai-codex`.
Eso cubre los proveedores que aún encajan en los transportes normales de OpenClaw. Un proveedor
Eso cubre los proveedores que todavía encajan en los transportes normales de OpenClaw. Un proveedor
que necesite un ejecutor de solicitudes totalmente personalizado es una superficie de extensión
separada y más profunda.
distinta y más profunda.
## Rotación de claves de API
- Admite rotación genérica de proveedor para proveedores seleccionados.
- Admite rotación genérica de proveedores para proveedores seleccionados.
- Configura varias claves mediante:
- `OPENCLAW_LIVE_<PROVIDER>_KEY` (anulación única en vivo, máxima prioridad)
- `OPENCLAW_LIVE_<PROVIDER>_KEY` (una sola anulación live, máxima prioridad)
- `<PROVIDER>_API_KEYS` (lista separada por comas o punto y coma)
- `<PROVIDER>_API_KEY` (clave principal)
- `<PROVIDER>_API_KEY_*` (lista numerada, por ejemplo `<PROVIDER>_API_KEY_1`)
- Para los proveedores de Google, `GOOGLE_API_KEY` también se incluye como respaldo.
- Para los proveedores de Google, `GOOGLE_API_KEY` también se incluye como fallback.
- El orden de selección de claves preserva la prioridad y elimina valores duplicados.
- Las solicitudes se reintentan con la siguiente clave solo ante respuestas de límite de tasa (por
- Las solicitudes se reintentan con la siguiente clave solo en respuestas de límite de tasa (por
ejemplo `429`, `rate_limit`, `quota`, `resource exhausted`, `Too many
concurrent requests`, `ThrottlingException`, `concurrency limit reached`,
`workers_ai ... quota limit exceeded` o mensajes periódicos de límite de uso).
- Los fallos que no son por límite de tasa fallan de inmediato; no se intenta rotación de claves.
- Cuando todas las claves candidatas fallan, se devuelve el error final del último intento.
- Los fallos que no son por límite de tasa fallan inmediatamente; no se intenta rotación de claves.
- Cuando fallan todas las claves candidatas, se devuelve el error final del último intento.
## Proveedores integrados (catálogo pi-ai)
OpenClaw incluye el catálogo piai. Estos proveedores no requieren configuración
`models.providers`; solo configura la autenticación + elige un modelo.
OpenClaw incluye el catálogo pi-ai. Estos proveedores no requieren
configuración de `models.providers`; solo configura la autenticación y elige un modelo.
### OpenAI
- Proveedor: `openai`
- Autenticación: `OPENAI_API_KEY`
- Rotación opcional: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, además de `OPENCLAW_LIVE_OPENAI_KEY` (anulación única)
- Rotación opcional: `OPENAI_API_KEYS`, `OPENAI_API_KEY_1`, `OPENAI_API_KEY_2`, más `OPENCLAW_LIVE_OPENAI_KEY` (una sola anulación)
- Modelos de ejemplo: `openai/gpt-5.4`, `openai/gpt-5.4-pro`
- CLI: `openclaw onboard --auth-choice openai-api-key`
- El transporte predeterminado es `auto` (WebSocket primero, SSE como respaldo)
- Anúlalo por modelo mediante `agents.defaults.models["openai/<model>"].params.transport` (`"sse"`, `"websocket"` o `"auto"`)
- El calentamiento de WebSocket de OpenAI Responses está activado de forma predeterminada mediante `params.openaiWsWarmup` (`true`/`false`)
- El procesamiento prioritario de OpenAI puede activarse mediante `agents.defaults.models["openai/<model>"].params.serviceTier`
- `/fast` y `params.fastMode` asignan las solicitudes directas de Responses `openai/*` a `service_tier=priority` en `api.openai.com`
- Usa `params.serviceTier` cuando quieras un nivel explícito en lugar del conmutador compartido `/fast`
- El transporte predeterminado es `auto` (WebSocket primero, fallback a SSE)
- Anula por modelo mediante `agents.defaults.models["openai/<model>"].params.transport` (`"sse"`, `"websocket"` o `"auto"`)
- El calentamiento de WebSocket de OpenAI Responses está habilitado de forma predeterminada mediante `params.openaiWsWarmup` (`true`/`false`)
- El procesamiento prioritario de OpenAI puede habilitarse mediante `agents.defaults.models["openai/<model>"].params.serviceTier`
- `/fast` y `params.fastMode` asignan solicitudes Responses directas `openai/*` a `service_tier=priority` en `api.openai.com`
- Usa `params.serviceTier` cuando quieras un nivel explícito en lugar del interruptor compartido `/fast`
- Los encabezados ocultos de atribución de OpenClaw (`originator`, `version`,
`User-Agent`) se aplican solo en tráfico nativo de OpenAI a `api.openai.com`, no
en proxies genéricos compatibles con OpenAI
`User-Agent`) se aplican solo al tráfico nativo de OpenAI hacia `api.openai.com`, no a
proxies genéricos compatibles con OpenAI
- Las rutas nativas de OpenAI también conservan `store` de Responses, sugerencias de caché de prompts y
conformación de carga útil de compatibilidad de razonamiento de OpenAI; las rutas proxy no
- `openai/gpt-5.3-codex-spark` está suprimido intencionalmente en OpenClaw porque la API en vivo de OpenAI lo rechaza; Spark se trata como exclusivo de Codex
modelado de payload de compatibilidad de razonamiento de OpenAI; las rutas proxy no
- `openai/gpt-5.3-codex-spark` se suprime intencionalmente en OpenClaw porque la API live de OpenAI lo rechaza; Spark se trata como exclusivo de Codex
```json5
{
@ -282,11 +240,11 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
- Proveedor: `anthropic`
- Autenticación: `ANTHROPIC_API_KEY`
- Rotación opcional: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, además de `OPENCLAW_LIVE_ANTHROPIC_KEY` (anulación única)
- Rotación opcional: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, más `OPENCLAW_LIVE_ANTHROPIC_KEY` (una sola anulación)
- Modelo de ejemplo: `anthropic/claude-opus-4-6`
- CLI: `openclaw onboard --auth-choice apiKey`
- Las solicitudes directas públicas a Anthropic también admiten el conmutador compartido `/fast` y `params.fastMode`, incluidas las solicitudes autenticadas con clave de API y OAuth enviadas a `api.anthropic.com`; OpenClaw lo asigna a Anthropic `service_tier` (`auto` frente a `standard_only`)
- Nota sobre Anthropic: el personal de Anthropic nos dijo que el uso estilo Claude CLI de OpenClaw vuelve a estar permitido, por lo que OpenClaw trata la reutilización de Claude CLI y el uso de `claude -p` como autorizados para esta integración, a menos que Anthropic publique una nueva política.
- Las solicitudes públicas directas a Anthropic también admiten el interruptor compartido `/fast` y `params.fastMode`, incluido el tráfico autenticado con clave de API y OAuth enviado a `api.anthropic.com`; OpenClaw lo asigna a `service_tier` de Anthropic (`auto` frente a `standard_only`)
- Nota de Anthropic: el personal de Anthropic nos dijo que el uso de Claude CLI al estilo OpenClaw vuelve a estar permitido, por lo que OpenClaw considera autorizados para esta integración tanto la reutilización de Claude CLI como el uso de `claude -p`, salvo que Anthropic publique una nueva política.
- El token de configuración de Anthropic sigue disponible como ruta de token compatible de OpenClaw, pero OpenClaw ahora prefiere la reutilización de Claude CLI y `claude -p` cuando están disponibles.
```json5
@ -301,16 +259,16 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
- Autenticación: OAuth (ChatGPT)
- Modelo de ejemplo: `openai-codex/gpt-5.4`
- CLI: `openclaw onboard --auth-choice openai-codex` o `openclaw models auth login --provider openai-codex`
- El transporte predeterminado es `auto` (WebSocket primero, SSE como respaldo)
- Anúlalo por modelo mediante `agents.defaults.models["openai-codex/<model>"].params.transport` (`"sse"`, `"websocket"` o `"auto"`)
- El transporte predeterminado es `auto` (WebSocket primero, fallback a SSE)
- Anula por modelo mediante `agents.defaults.models["openai-codex/<model>"].params.transport` (`"sse"`, `"websocket"` o `"auto"`)
- `params.serviceTier` también se reenvía en solicitudes nativas de Codex Responses (`chatgpt.com/backend-api`)
- Los encabezados ocultos de atribución de OpenClaw (`originator`, `version`,
`User-Agent`) solo se adjuntan en tráfico nativo de Codex hacia
`chatgpt.com/backend-api`, no en proxies genéricos compatibles con OpenAI
- Comparte el mismo conmutador `/fast` y la configuración `params.fastMode` que `openai/*` directo; OpenClaw lo asigna a `service_tier=priority`
`chatgpt.com/backend-api`, no a proxies genéricos compatibles con OpenAI
- Comparte el mismo interruptor `/fast` y la misma configuración `params.fastMode` que `openai/*` directo; OpenClaw lo asigna a `service_tier=priority`
- `openai-codex/gpt-5.3-codex-spark` sigue disponible cuando el catálogo OAuth de Codex lo expone; depende de los derechos
- `openai-codex/gpt-5.4` mantiene `contextWindow = 1050000` nativo y un `contextTokens = 272000` de runtime predeterminado; anula el límite de runtime con `models.providers.openai-codex.models[].contextTokens`
- Nota de política: OpenAI Codex OAuth es compatible explícitamente con herramientas/flujos de trabajo externos como OpenClaw.
- Nota de política: OpenAI Codex OAuth es compatible explícitamente para herramientas/flujos de trabajo externos como OpenClaw.
```json5
{
@ -332,8 +290,8 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
### Otras opciones alojadas de estilo suscripción
- [Qwen Cloud](/es/providers/qwen): superficie del proveedor Qwen Cloud más mapeo de endpoints de Alibaba DashScope y Coding Plan
- [MiniMax](/es/providers/minimax): acceso mediante OAuth o clave de API de MiniMax Coding Plan
- [Qwen Cloud](/es/providers/qwen): superficie de proveedor de Qwen Cloud más mapeo de endpoints de Alibaba DashScope y Coding Plan
- [MiniMax](/es/providers/minimax): acceso a MiniMax Coding Plan OAuth o clave de API
- [GLM Models](/es/providers/glm): Z.AI Coding Plan o endpoints generales de API
### OpenCode
@ -354,7 +312,7 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
- Proveedor: `google`
- Autenticación: `GEMINI_API_KEY`
- Rotación opcional: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, respaldo de `GOOGLE_API_KEY` y `OPENCLAW_LIVE_GEMINI_KEY` (anulación única)
- Rotación opcional: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, fallback de `GOOGLE_API_KEY` y `OPENCLAW_LIVE_GEMINI_KEY` (una sola anulación)
- Modelos de ejemplo: `google/gemini-3.1-pro-preview`, `google/gemini-3-flash-preview`
- Compatibilidad: la configuración heredada de OpenClaw que usa `google/gemini-3.1-flash-preview` se normaliza a `google/gemini-3-flash-preview`
- CLI: `openclaw onboard --auth-choice gemini-api-key`
@ -365,18 +323,18 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
### Google Vertex y Gemini CLI
- Proveedores: `google-vertex`, `google-gemini-cli`
- Autenticación: Vertex usa gcloud ADC; Gemini CLI usa su flujo OAuth
- Precaución: Gemini CLI OAuth en OpenClaw es una integración no oficial. Algunos usuarios han informado restricciones en cuentas de Google tras usar clientes de terceros. Revisa los términos de Google y usa una cuenta no crítica si decides continuar.
- Gemini CLI OAuth se incluye como parte del plugin `google` integrado.
- Instala Gemini CLI primero:
- Autenticación: Vertex usa ADC de gcloud; Gemini CLI usa su flujo OAuth
- Precaución: Gemini CLI OAuth en OpenClaw es una integración no oficial. Algunos usuarios han informado restricciones en cuentas de Google después de usar clientes de terceros. Revisa los términos de Google y usa una cuenta no crítica si decides continuar.
- Gemini CLI OAuth se distribuye como parte del plugin `google` incluido.
- Instala primero Gemini CLI:
- `brew install gemini-cli`
- o `npm install -g @google/gemini-cli`
- Habilita: `openclaw plugins enable google`
- Inicia sesión: `openclaw models auth login --provider google-gemini-cli --set-default`
- Modelo predeterminado: `google-gemini-cli/gemini-3-flash-preview`
- Nota: **no** pegas un client id ni un secret en `openclaw.json`. El flujo de inicio de sesión de CLI almacena
tokens en perfiles de autenticación en el host de la gateway.
- Si las solicitudes fallan después del inicio de sesión, configura `GOOGLE_CLOUD_PROJECT` o `GOOGLE_CLOUD_PROJECT_ID` en el host de la gateway.
- Nota: **no** pegas un id de cliente ni un secreto en `openclaw.json`. El flujo de inicio de sesión de CLI almacena
tokens en perfiles de autenticación en el host del gateway.
- Si las solicitudes fallan después de iniciar sesión, configura `GOOGLE_CLOUD_PROJECT` o `GOOGLE_CLOUD_PROJECT_ID` en el host del gateway.
- Las respuestas JSON de Gemini CLI se analizan desde `response`; el uso recurre a
`stats`, con `stats.cached` normalizado a `cacheRead` de OpenClaw.
@ -387,7 +345,7 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
- Modelo de ejemplo: `zai/glm-5.1`
- CLI: `openclaw onboard --auth-choice zai-api-key`
- Alias: `z.ai/*` y `z-ai/*` se normalizan a `zai/*`
- `zai-api-key` detecta automáticamente el endpoint coincidente de Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` y `zai-cn` fuerzan una superficie específica
- `zai-api-key` detecta automáticamente el endpoint Z.AI correspondiente; `zai-coding-global`, `zai-coding-cn`, `zai-global` y `zai-cn` fuerzan una superficie específica
### Vercel AI Gateway
@ -403,38 +361,36 @@ OpenClaw incluye el catálogo piai. Estos proveedores no requieren configurac
- Modelo de ejemplo: `kilocode/kilo/auto`
- CLI: `openclaw onboard --auth-choice kilocode-api-key`
- URL base: `https://api.kilo.ai/api/gateway/`
- El catálogo de respaldo estático incluye `kilocode/kilo/auto`; el descubrimiento en vivo de
`https://api.kilo.ai/api/gateway/models` puede ampliar aún más el catálogo
de runtime.
- El enrutamiento exacto ascendente detrás de `kilocode/kilo/auto` es responsabilidad de Kilo Gateway,
no está codificado de forma rígida en OpenClaw.
- El catálogo de fallback estático incluye `kilocode/kilo/auto`; el descubrimiento live de
`https://api.kilo.ai/api/gateway/models` puede ampliar aún más el catálogo de runtime.
- El enrutamiento exacto upstream detrás de `kilocode/kilo/auto` es responsabilidad de Kilo Gateway,
no está codificado de forma fija en OpenClaw.
Consulta [/providers/kilocode](/es/providers/kilocode) para ver detalles de configuración.
Consulta [/providers/kilocode](/es/providers/kilocode) para conocer los detalles de configuración.
### Otros plugins de proveedor integrados
### Otros plugins de proveedores incluidos
- OpenRouter: `openrouter` (`OPENROUTER_API_KEY`)
- Modelo de ejemplo: `openrouter/auto`
- OpenClaw aplica los encabezados documentados de atribución de aplicación de OpenRouter solo cuando
la solicitud realmente apunta a `openrouter.ai`
- Los marcadores `cache_control` específicos de Anthropic para OpenRouter también están restringidos a
rutas OpenRouter verificadas, no a URL de proxy arbitrarias
- OpenRouter permanece en la ruta compatible con OpenAI de estilo proxy, por lo que la
conformación de solicitudes exclusiva de OpenAI nativo (`serviceTier`, `store` de Responses,
sugerencias de caché de prompts, cargas útiles de compatibilidad de razonamiento de OpenAI) no se reenvía
- Las referencias OpenRouter respaldadas por Gemini solo conservan el saneamiento de firmas de pensamiento de Gemini a través de proxy;
- Los marcadores `cache_control` específicos de Anthropic para OpenRouter también se limitan a
rutas de OpenRouter verificadas, no a URLs proxy arbitrarias
- OpenRouter permanece en la ruta de estilo proxy compatible con OpenAI, por lo que el
modelado de solicitudes exclusivo de OpenAI nativo (`serviceTier`, `store` de Responses,
sugerencias de caché de prompts, payloads de compatibilidad de razonamiento de OpenAI) no se reenvía
- Las referencias de OpenRouter respaldadas por Gemini conservan solo el saneamiento de firmas de pensamiento de Gemini a través de proxy;
la validación nativa de reproducción de Gemini y las reescrituras de bootstrap permanecen desactivadas
- Kilo Gateway: `kilocode` (`KILOCODE_API_KEY`)
- Modelo de ejemplo: `kilocode/kilo/auto`
- Las referencias Kilo respaldadas por Gemini conservan la misma ruta de saneamiento de firmas de pensamiento de Gemini a través de proxy;
`kilocode/kilo/auto` y otras sugerencias incompatibles con razonamiento por proxy
omiten la inyección de razonamiento por proxy
- Las referencias de Kilo respaldadas por Gemini conservan la misma ruta de saneamiento de firmas de pensamiento de Gemini a través de proxy;
`kilocode/kilo/auto` y otras sugerencias sin compatibilidad con razonamiento por proxy omiten la inyección de razonamiento por proxy
- MiniMax: `minimax` (clave de API) y `minimax-portal` (OAuth)
- Autenticación: `MINIMAX_API_KEY` para `minimax`; `MINIMAX_OAUTH_TOKEN` o `MINIMAX_API_KEY` para `minimax-portal`
- Modelo de ejemplo: `minimax/MiniMax-M2.7` o `minimax-portal/MiniMax-M2.7`
- La incorporación/configuración con clave de API de MiniMax escribe definiciones explícitas del modelo M2.7 con
`input: ["text", "image"]`; el catálogo del proveedor integrado mantiene las referencias de chat
solo de texto hasta que se materializa esa configuración del proveedor
- La configuración de incorporación/clave de API de MiniMax escribe definiciones explícitas del modelo M2.7 con
`input: ["text", "image"]`; el catálogo de proveedor incluido mantiene las referencias de chat
como solo texto hasta que se materializa esa configuración del proveedor
- Moonshot: `moonshot` (`MOONSHOT_API_KEY`)
- Modelo de ejemplo: `moonshot/kimi-k2.5`
- Kimi Coding: `kimi` (`KIMI_API_KEY` o `KIMICODE_API_KEY`)
@ -471,7 +427,7 @@ Consulta [/providers/kilocode](/es/providers/kilocode) para ver detalles de conf
- CLI: `openclaw onboard --auth-choice mistral-api-key`
- Groq: `groq` (`GROQ_API_KEY`)
- Cerebras: `cerebras` (`CEREBRAS_API_KEY`)
- Los modelos GLM en Cerebras usan los ID `zai-glm-4.7` y `zai-glm-4.6`.
- Los modelos GLM en Cerebras usan los ids `zai-glm-4.7` y `zai-glm-4.6`.
- URL base compatible con OpenAI: `https://api.cerebras.ai/v1`.
- GitHub Copilot: `github-copilot` (`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`)
- Modelo de ejemplo de Hugging Face Inference: `huggingface/deepseek-ai/DeepSeek-R1`; CLI: `openclaw onboard --auth-choice huggingface-api-key`. Consulta [Hugging Face (Inference)](/es/providers/huggingface).
@ -481,14 +437,14 @@ Consulta [/providers/kilocode](/es/providers/kilocode) para ver detalles de conf
Usa `models.providers` (o `models.json`) para agregar proveedores **personalizados** o
proxies compatibles con OpenAI/Anthropic.
Muchos de los plugins de proveedor integrados a continuación ya publican un catálogo predeterminado.
Muchos de los plugins de proveedores incluidos a continuación ya publican un catálogo predeterminado.
Usa entradas explícitas `models.providers.<id>` solo cuando quieras anular la
URL base, los encabezados o la lista de modelos predeterminados.
### Moonshot AI (Kimi)
Moonshot se incluye como un plugin de proveedor integrado. Usa el proveedor incorporado de
forma predeterminada y agrega una entrada explícita `models.providers.moonshot` solo cuando
Moonshot se distribuye como un plugin de proveedor incluido. Usa el proveedor integrado de forma predeterminada,
y agrega una entrada explícita `models.providers.moonshot` solo cuando
necesites anular la URL base o los metadatos del modelo:
- Proveedor: `moonshot`
@ -496,7 +452,7 @@ necesites anular la URL base o los metadatos del modelo:
- Modelo de ejemplo: `moonshot/kimi-k2.5`
- CLI: `openclaw onboard --auth-choice moonshot-api-key` o `openclaw onboard --auth-choice moonshot-api-key-cn`
ID de modelos Kimi K2:
IDs de modelo Kimi K2:
[//]: # "moonshot-kimi-k2-model-refs:start"
@ -543,7 +499,7 @@ Kimi Coding usa el endpoint compatible con Anthropic de Moonshot AI:
}
```
El ID de modelo heredado `kimi/k2p5` sigue aceptándose como ID de modelo de compatibilidad.
El `kimi/k2p5` heredado sigue aceptándose como id de modelo de compatibilidad.
### Volcano Engine (Doubao)
@ -562,13 +518,13 @@ Volcano Engine (火山引擎) proporciona acceso a Doubao y otros modelos en Chi
}
```
La incorporación usa por defecto la superficie de coding, pero el catálogo general `volcengine/*`
se registra al mismo tiempo.
La incorporación usa de forma predeterminada la superficie de coding, pero el
catálogo general `volcengine/*` se registra al mismo tiempo.
En los selectores de modelo de incorporación/configuración, la opción de autenticación de Volcengine prioriza tanto
las filas `volcengine/*` como `volcengine-plan/*`. Si esos modelos aún no están cargados,
OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío
limitado al proveedor.
OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector
vacío con alcance del proveedor.
Modelos disponibles:
@ -603,13 +559,13 @@ BytePlus ARK proporciona acceso a los mismos modelos que Volcano Engine para usu
}
```
La incorporación usa por defecto la superficie de coding, pero el catálogo general `byteplus/*`
La incorporación usa de forma predeterminada la superficie de coding, pero el catálogo general `byteplus/*`
se registra al mismo tiempo.
En los selectores de modelo de incorporación/configuración, la opción de autenticación de BytePlus prioriza tanto
las filas `byteplus/*` como `byteplus-plan/*`. Si esos modelos aún no están cargados,
OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío
limitado al proveedor.
OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector
vacío con alcance del proveedor.
Modelos disponibles:
@ -657,29 +613,51 @@ Synthetic proporciona modelos compatibles con Anthropic detrás del proveedor `s
MiniMax se configura mediante `models.providers` porque usa endpoints personalizados:
- MiniMax OAuth (global): `--auth-choice minimax-global-oauth`
- MiniMax OAuth (CN): `--auth-choice minimax-cn-oauth`
- Clave de API de MiniMax (global): `--auth-choice minimax-global-api`
- OAuth de MiniMax (Global): `--auth-choice minimax-global-oauth`
- OAuth de MiniMax (CN): `--auth-choice minimax-cn-oauth`
- Clave de API de MiniMax (Global): `--auth-choice minimax-global-api`
- Clave de API de MiniMax (CN): `--auth-choice minimax-cn-api`
- Autenticación: `MINIMAX_API_KEY` para `minimax`; `MINIMAX_OAUTH_TOKEN` o
`MINIMAX_API_KEY` para `minimax-portal`
Consulta [/providers/minimax](/es/providers/minimax) para ver detalles de configuración, opciones de modelo y fragmentos de configuración.
Consulta [/providers/minimax](/es/providers/minimax) para conocer los detalles de configuración, opciones de modelos y fragmentos de configuración.
En la ruta de streaming compatible con Anthropic de MiniMax, OpenClaw desactiva el pensamiento de forma
predeterminada a menos que lo configures explícitamente, y `/fast on` reescribe
En la ruta de streaming compatible con Anthropic de MiniMax, OpenClaw desactiva thinking de forma predeterminada
a menos que lo configures explícitamente, y `/fast on` reescribe
`MiniMax-M2.7` a `MiniMax-M2.7-highspeed`.
División de capacidades gestionadas por el plugin:
División de capacidades administradas por el plugin:
- Los valores predeterminados de texto/chat permanecen en `minimax/MiniMax-M2.7`
- La generación de imágenes es `minimax/image-01` o `minimax-portal/image-01`
- La comprensión de imágenes es `MiniMax-VL-01` gestionado por el plugin en ambas rutas de autenticación de MiniMax
- La búsqueda web permanece en el ID de proveedor `minimax`
- La comprensión de imágenes es `MiniMax-VL-01`, administrada por plugin, en ambas rutas de autenticación de MiniMax
- La búsqueda web permanece en el id de proveedor `minimax`
### LM Studio
LM Studio se distribuye como un plugin de proveedor incluido que usa la API nativa:
- Proveedor: `lmstudio`
- Autenticación: `LM_API_TOKEN`
- URL base de inferencia predeterminada: `http://localhost:1234/v1`
Luego configura un modelo (reemplázalo por uno de los ids devueltos por `http://localhost:1234/api/v1/models`):
```json5
{
agents: {
defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
},
}
```
OpenClaw usa los endpoints nativos `/api/v1/models` y `/api/v1/models/load` de LM Studio
para descubrimiento + carga automática, con `/v1/chat/completions` para inferencia de forma predeterminada.
Consulta [/providers/lmstudio](/es/providers/lmstudio) para configuración y solución de problemas.
### Ollama
Ollama se incluye como un plugin de proveedor integrado y usa la API nativa de Ollama:
Ollama se distribuye como un plugin de proveedor incluido y usa la API nativa de Ollama:
- Proveedor: `ollama`
- Autenticación: no se requiere (servidor local)
@ -699,27 +677,27 @@ ollama pull llama3.3
}
```
Ollama se detecta localmente en `http://127.0.0.1:11434` cuando habilitas esta opción con
`OLLAMA_API_KEY`, y el plugin de proveedor integrado agrega Ollama directamente a
Ollama se detecta localmente en `http://127.0.0.1:11434` cuando optas por usarlo con
`OLLAMA_API_KEY`, y el plugin de proveedor incluido agrega Ollama directamente a
`openclaw onboard` y al selector de modelos. Consulta [/providers/ollama](/es/providers/ollama)
para ver incorporación, modo local/en la nube y configuración personalizada.
para incorporación, modo cloud/local y configuración personalizada.
### vLLM
vLLM se incluye como un plugin de proveedor integrado para servidores locales/autohospedados
compatibles con OpenAI:
vLLM se distribuye como un plugin de proveedor incluido para servidores
compatibles con OpenAI locales/autohospedados:
- Proveedor: `vllm`
- Autenticación: opcional (depende de tu servidor)
- URL base predeterminada: `http://127.0.0.1:8000/v1`
Para habilitar el descubrimiento automático localmente (cualquier valor funciona si tu servidor no exige autenticación):
Para optar por el autodescubrimiento local (cualquier valor funciona si tu servidor no exige autenticación):
```bash
export VLLM_API_KEY="vllm-local"
```
Luego configura un modelo (sustitúyelo por uno de los ID devueltos por `/v1/models`):
Luego configura un modelo (reemplázalo por uno de los ids devueltos por `/v1/models`):
```json5
{
@ -729,25 +707,25 @@ Luego configura un modelo (sustitúyelo por uno de los ID devueltos por `/v1/mod
}
```
Consulta [/providers/vllm](/es/providers/vllm) para ver más detalles.
Consulta [/providers/vllm](/es/providers/vllm) para más detalles.
### SGLang
SGLang se incluye como un plugin de proveedor integrado para servidores autohospedados rápidos
compatibles con OpenAI:
SGLang se distribuye como un plugin de proveedor incluido para servidores rápidos
compatibles con OpenAI autohospedados:
- Proveedor: `sglang`
- Autenticación: opcional (depende de tu servidor)
- URL base predeterminada: `http://127.0.0.1:30000/v1`
Para habilitar el descubrimiento automático localmente (cualquier valor funciona si tu servidor no
Para optar por el autodescubrimiento local (cualquier valor funciona si tu servidor no
exige autenticación):
```bash
export SGLANG_API_KEY="sglang-local"
```
Luego configura un modelo (sustitúyelo por uno de los ID devueltos por `/v1/models`):
Luego configura un modelo (reemplázalo por uno de los ids devueltos por `/v1/models`):
```json5
{
@ -757,7 +735,7 @@ Luego configura un modelo (sustitúyelo por uno de los ID devueltos por `/v1/mod
}
```
Consulta [/providers/sglang](/es/providers/sglang) para ver más detalles.
Consulta [/providers/sglang](/es/providers/sglang) para más detalles.
### Proxies locales (LM Studio, vLLM, LiteLLM, etc.)
@ -775,7 +753,7 @@ Ejemplo (compatible con OpenAI):
providers: {
lmstudio: {
baseUrl: "http://localhost:1234/v1",
apiKey: "LMSTUDIO_KEY",
apiKey: "${LM_API_TOKEN}",
api: "openai-completions",
models: [
{
@ -804,13 +782,13 @@ Notas:
- `contextWindow: 200000`
- `maxTokens: 8192`
- Recomendado: configura valores explícitos que coincidan con los límites de tu proxy/modelo.
- Para `api: "openai-completions"` en endpoints no nativos (cualquier `baseUrl` no vacío cuyo host no sea `api.openai.com`), OpenClaw fuerza `compat.supportsDeveloperRole: false` para evitar errores 400 del proveedor por roles `developer` no compatibles.
- Las rutas compatibles con OpenAI de estilo proxy también omiten la
conformación de solicitudes exclusiva de OpenAI nativo: sin `service_tier`, sin `store` de Responses, sin sugerencias de caché de prompts, sin
conformación de carga útil de compatibilidad de razonamiento de OpenAI y sin encabezados
- Para `api: "openai-completions"` en endpoints no nativos (cualquier `baseUrl` no vacío cuyo host no sea `api.openai.com`), OpenClaw fuerza `compat.supportsDeveloperRole: false` para evitar errores 400 del proveedor por roles `developer` no admitidos.
- Las rutas de estilo proxy compatibles con OpenAI también omiten el modelado de solicitudes exclusivo de OpenAI nativo:
no hay `service_tier`, no hay `store` de Responses, no hay sugerencias de caché de prompts, no hay
modelado de payload de compatibilidad de razonamiento de OpenAI y no hay encabezados
ocultos de atribución de OpenClaw.
- Si `baseUrl` está vacío o se omite, OpenClaw conserva el comportamiento predeterminado de OpenAI (que se resuelve en `api.openai.com`).
- Por seguridad, un `compat.supportsDeveloperRole: true` explícito sigue sobrescribiéndose en endpoints `openai-completions` no nativos.
- Si `baseUrl` está vacío o se omite, OpenClaw mantiene el comportamiento predeterminado de OpenAI (que resuelve a `api.openai.com`).
- Por seguridad, un `compat.supportsDeveloperRole: true` explícito sigue siendo reemplazado en endpoints no nativos `openai-completions`.
## Ejemplos de CLI
@ -820,11 +798,11 @@ openclaw models set opencode/claude-opus-4-6
openclaw models list
```
Consulta también: [/gateway/configuration](/es/gateway/configuration) para ver ejemplos completos de configuración.
Consulta también: [/gateway/configuration](/es/gateway/configuration) para ejemplos completos de configuración.
## Relacionado
- [Models](/es/concepts/models) — configuración de modelos y alias
- [Model Failover](/es/concepts/model-failover) — cadenas de respaldo y comportamiento de reintento
- [Model Failover](/es/concepts/model-failover) — cadenas de fallback y comportamiento de reintento
- [Configuration Reference](/es/gateway/configuration-reference#agent-defaults) — claves de configuración de modelos
- [Providers](/es/providers) — guías de configuración por proveedor

View File

@ -1,28 +1,28 @@
---
read_when:
- Quieres servir modelos desde tu propio equipo con GPU
- Quieres servir modelos desde tu propia máquina con GPU
- Estás configurando LM Studio o un proxy compatible con OpenAI
- Necesitas la guía más segura para modelos locales
summary: Ejecuta OpenClaw en LLM locales (LM Studio, vLLM, LiteLLM, endpoints OpenAI personalizados)
summary: Ejecuta OpenClaw en LLM locales (LM Studio, vLLM, LiteLLM, endpoints personalizados compatibles con OpenAI)
title: Modelos locales
x-i18n:
generated_at: "2026-04-08T02:14:57Z"
generated_at: "2026-04-13T08:50:34Z"
model: gpt-5.4
provider: openai
source_hash: d619d72b0e06914ebacb7e9f38b746caf1b9ce8908c9c6638c3acdddbaa025e8
source_hash: 3ecb61b3e6e34d3666f9b688cd694d92c5fb211cf8c420fa876f7ccf5789154a
source_path: gateway/local-models.md
workflow: 15
---
# Modelos locales
Lo local es viable, pero OpenClaw espera un contexto amplio y defensas sólidas contra la inyección de prompts. Las tarjetas pequeñas truncan el contexto y debilitan la seguridad. Apunta alto: **≥2 Mac Studio al máximo o un equipo GPU equivalente (~$30k+)**. Una sola GPU de **24 GB** funciona solo para prompts más ligeros y con mayor latencia. Usa la **variante de modelo más grande o completa que puedas ejecutar**; los checkpoints muy cuantizados o “small” aumentan el riesgo de inyección de prompts (consulta [Security](/es/gateway/security)).
Lo local es viable, pero OpenClaw espera un contexto amplio y defensas sólidas contra la inyección de prompts. Las tarjetas pequeñas truncan el contexto y debilitan la seguridad. Apunta alto: **≥2 Mac Studios al máximo o un equipo GPU equivalente (~30 mil USD o más)**. Una sola GPU de **24 GB** funciona solo con prompts más ligeros y mayor latencia. Usa la **variante de modelo más grande / de tamaño completo que puedas ejecutar**; los checkpoints cuantizados de forma agresiva o “small” aumentan el riesgo de inyección de prompts (consulta [Security](/es/gateway/security)).
Si quieres la configuración local con menos fricción, empieza con [Ollama](/es/providers/ollama) y `openclaw onboard`. Esta página es la guía con recomendaciones concretas para stacks locales de gama alta y servidores locales personalizados compatibles con OpenAI.
Si quieres la configuración local con menos fricción, empieza con [LM Studio](/es/providers/lmstudio) o [Ollama](/es/providers/ollama) y `openclaw onboard`. Esta página es la guía con criterio para stacks locales de gama alta y servidores locales personalizados compatibles con OpenAI.
## Recomendado: LM Studio + modelo local grande (Responses API)
## Recomendado: LM Studio + modelo local grande (API de Responses)
La mejor pila local actual. Carga un modelo grande en LM Studio (por ejemplo, una compilación completa de Qwen, DeepSeek o Llama), habilita el servidor local (valor predeterminado `http://127.0.0.1:1234`) y usa Responses API para mantener el razonamiento separado del texto final.
El mejor stack local actual. Carga un modelo grande en LM Studio (por ejemplo, una compilación de tamaño completo de Qwen, DeepSeek o Llama), habilita el servidor local (por defecto `http://127.0.0.1:1234`) y usa la API de Responses para mantener el razonamiento separado del texto final.
```json5
{
@ -59,18 +59,18 @@ La mejor pila local actual. Carga un modelo grande en LM Studio (por ejemplo, un
}
```
**Lista de verificación de configuración**
**Lista de configuración**
- Instala LM Studio: [https://lmstudio.ai](https://lmstudio.ai)
- En LM Studio, descarga la **compilación de modelo más grande disponible** (evita variantes “small” o muy cuantizadas), inicia el servidor y confirma que `http://127.0.0.1:1234/v1/models` la muestra.
- Sustituye `my-local-model` por el ID de modelo real que aparece en LM Studio.
- Mantén el modelo cargado; una carga en frío añade latencia de inicio.
- Ajusta `contextWindow`/`maxTokens` si tu compilación de LM Studio es distinta.
- Para WhatsApp, usa Responses API para que solo se envíe el texto final.
- En LM Studio, descarga la **compilación de modelo más grande disponible** (evita variantes “small” o muy cuantizadas), inicia el servidor y confirma que `http://127.0.0.1:1234/v1/models` lo muestre en la lista.
- Sustituye `my-local-model` por el ID real del modelo que muestra LM Studio.
- Mantén el modelo cargado; la carga en frío añade latencia de inicio.
- Ajusta `contextWindow`/`maxTokens` si tu compilación de LM Studio difiere.
- Para WhatsApp, mantente en la API de Responses para que solo se envíe el texto final.
Mantén los modelos alojados configurados incluso cuando ejecutes en local; usa `models.mode: "merge"` para que las alternativas sigan disponibles.
Mantén también configurados los modelos alojados incluso cuando ejecutes localmente; usa `models.mode: "merge"` para que los fallbacks sigan disponibles.
### Configuración híbrida: principal alojado, alternativa local
### Configuración híbrida: primario alojado, fallback local
```json5
{
@ -111,18 +111,18 @@ Mantén los modelos alojados configurados incluso cuando ejecutes en local; usa
}
```
### Prioridad local con red de seguridad alojada
### Primero local con red de seguridad alojada
Intercambia el orden de principal y alternativa; mantén el mismo bloque `providers` y `models.mode: "merge"` para poder recurrir a Sonnet o Opus cuando el equipo local no esté disponible.
Intercambia el orden del primario y los fallbacks; mantén el mismo bloque de proveedores y `models.mode: "merge"` para poder recurrir a Sonnet u Opus cuando la máquina local no esté disponible.
### Alojamiento regional / enrutamiento de datos
- Las variantes alojadas de MiniMax/Kimi/GLM también existen en OpenRouter con endpoints fijados por región (por ejemplo, alojados en EE. UU.). Elige allí la variante regional para mantener el tráfico dentro de la jurisdicción que prefieras mientras sigues usando `models.mode: "merge"` para las alternativas de Anthropic/OpenAI.
- Solo local sigue siendo la opción más sólida para la privacidad; el enrutamiento regional alojado es el punto intermedio cuando necesitas funciones del proveedor pero quieres controlar el flujo de datos.
- Las variantes alojadas de MiniMax/Kimi/GLM también existen en OpenRouter con endpoints fijados por región (por ejemplo, alojados en EE. UU.). Elige ahí la variante regional para mantener el tráfico dentro de tu jurisdicción elegida mientras sigues usando `models.mode: "merge"` para los fallbacks de Anthropic/OpenAI.
- Solo local sigue siendo la ruta de privacidad más sólida; el enrutamiento regional alojado es el punto medio cuando necesitas funciones del proveedor pero quieres controlar el flujo de datos.
## Otros proxies locales compatibles con OpenAI
vLLM, LiteLLM, OAI-proxy o puertas de enlace personalizadas funcionan si exponen un endpoint `/v1` de estilo OpenAI. Sustituye el bloque del proveedor anterior por tu endpoint y tu ID de modelo:
vLLM, LiteLLM, OAI-proxy o gateways personalizados funcionan si exponen un endpoint `/v1` de estilo OpenAI. Sustituye el bloque de proveedor anterior por tu endpoint y tu ID de modelo:
```json5
{
@ -150,42 +150,40 @@ vLLM, LiteLLM, OAI-proxy o puertas de enlace personalizadas funcionan si exponen
}
```
Mantén `models.mode: "merge"` para que los modelos alojados sigan disponibles como alternativas.
Mantén `models.mode: "merge"` para que los modelos alojados sigan disponibles como fallbacks.
Nota de comportamiento para backends `/v1` locales o con proxy:
Nota de comportamiento para backends locales/proxy `/v1`:
- OpenClaw los trata como rutas compatibles con OpenAI de estilo proxy, no como
endpoints nativos de OpenAI
- aquí no se aplica el moldeado de solicitudes exclusivo de OpenAI nativo: sin
`service_tier`, sin Responses `store`, sin moldeado de carga útil de compatibilidad de razonamiento de OpenAI
y sin sugerencias de caché de prompts
- los encabezados de atribución ocultos de OpenClaw (`originator`, `version`, `User-Agent`)
- OpenClaw los trata como rutas proxy compatibles con OpenAI, no como endpoints nativos de OpenAI
- aquí no se aplica el modelado de solicitudes exclusivo de OpenAI nativo: no hay
`service_tier`, no hay `store` de Responses, no hay modelado de payload de compatibilidad de razonamiento de OpenAI
ni sugerencias de caché de prompts
- los encabezados ocultos de atribución de OpenClaw (`originator`, `version`, `User-Agent`)
no se inyectan en estas URL de proxy personalizadas
Notas de compatibilidad para backends compatibles con OpenAI más estrictos:
- Algunos servidores aceptan solo `messages[].content` como cadena en Chat Completions, no
matrices estructuradas de partes de contenido. Configura
arrays estructurados de partes de contenido. Establece
`models.providers.<provider>.models[].compat.requiresStringContent: true` para
esos endpoints.
- Algunos backends locales más pequeños o más estrictos son inestables con la forma completa del prompt
del entorno de ejecución de agentes de OpenClaw, especialmente cuando se incluyen esquemas de herramientas. Si el
- Algunos backends locales más pequeños o más estrictos son inestables con la forma completa
del prompt del entorno de agentes de OpenClaw, especialmente cuando se incluyen schemas de herramientas. Si el
backend funciona para llamadas directas pequeñas a `/v1/chat/completions` pero falla en turnos normales
del agente de OpenClaw, prueba primero con
de agentes de OpenClaw, prueba primero con
`models.providers.<provider>.models[].compat.supportsTools: false`.
- Si el backend sigue fallando solo en ejecuciones más grandes de OpenClaw, el problema restante
suele ser la capacidad del modelo/servidor aguas arriba o un error del backend, no la
capa de transporte de OpenClaw.
normalmente es una limitación del modelo/servidor upstream o un error del backend, no de la capa de transporte de OpenClaw.
## Solución de problemas
- ¿La puerta de enlace puede alcanzar el proxy? `curl http://127.0.0.1:1234/v1/models`.
- ¿El modelo de LM Studio se descargó de memoria? Vuélvelo a cargar; el arranque en frío es una causa común de “bloqueo”.
- ¿Gateway puede alcanzar el proxy? `curl http://127.0.0.1:1234/v1/models`.
- ¿El modelo de LM Studio está descargado de memoria? Vuelve a cargarlo; el inicio en frío es una causa común de “bloqueo”.
- ¿Errores de contexto? Reduce `contextWindow` o aumenta el límite de tu servidor.
- ¿El servidor compatible con OpenAI devuelve `messages[].content ... expected a string`?
Añade `compat.requiresStringContent: true` en esa entrada de modelo.
Añade `compat.requiresStringContent: true` en esa entrada del modelo.
- ¿Las llamadas directas pequeñas a `/v1/chat/completions` funcionan, pero `openclaw infer model run`
falla en Gemma u otro modelo local? Primero desactiva los esquemas de herramientas con
falla con Gemma u otro modelo local? Desactiva primero los schemas de herramientas con
`compat.supportsTools: false` y vuelve a probar. Si el servidor sigue fallando solo
con prompts más grandes de OpenClaw, trátalo como una limitación del servidor/modelo aguas arriba.
- Seguridad: los modelos locales omiten los filtros del lado del proveedor; mantén los agentes limitados y la compactación activada para reducir el radio de impacto de la inyección de prompts.
con prompts más grandes de OpenClaw, trátalo como una limitación del servidor/modelo upstream.
- Seguridad: los modelos locales omiten los filtros del proveedor; mantén los agentes limitados y Compaction activado para limitar el radio de impacto de la inyección de prompts.

View File

@ -1,14 +1,14 @@
---
read_when:
- Quieres elegir un proveedor de modelos
- Necesitas una vista general rápida de los backends LLM compatibles
- Necesitas una visión general rápida de los backends de LLM compatibles
summary: Proveedores de modelos (LLMs) compatibles con OpenClaw
title: Directorio de proveedores
x-i18n:
generated_at: "2026-04-08T02:17:19Z"
generated_at: "2026-04-13T08:50:33Z"
model: gpt-5.4
provider: openai
source_hash: e7bee5528b7fc9a982b3d0eaa4930cb77f7bded19a47aec00572b6fcbd823a70
source_hash: 3bc682d008119719826f71f74959ab32bedf14214459f5e6ac9cb70371d3c540
source_path: providers/index.md
workflow: 15
---
@ -18,7 +18,7 @@ x-i18n:
OpenClaw puede usar muchos proveedores de LLM. Elige un proveedor, autentícate y luego establece el
modelo predeterminado como `provider/model`.
¿Buscas documentación de canales de chat (WhatsApp/Telegram/Discord/Slack/Mattermost (plugin)/etc.)? Consulta [Canales](/es/channels).
¿Buscas documentación de canales de chat (WhatsApp/Telegram/Discord/Slack/Mattermost (Plugin)/etc.)? Consulta [Canales](/es/channels).
## Inicio rápido
@ -45,13 +45,14 @@ modelo predeterminado como `provider/model`.
- [fal](/es/providers/fal)
- [Fireworks](/es/providers/fireworks)
- [GitHub Copilot](/es/providers/github-copilot)
- [Modelos GLM](/es/providers/glm)
- [modelos GLM](/es/providers/glm)
- [Google (Gemini)](/es/providers/google)
- [Groq (inferencia LPU)](/es/providers/groq)
- [Hugging Face (inferencia)](/es/providers/huggingface)
- [inferrs (modelos locales)](/es/providers/inferrs)
- [Kilocode](/es/providers/kilocode)
- [LiteLLM (gateway unificado)](/es/providers/litellm)
- [LiteLLM (Gateway unificado)](/es/providers/litellm)
- [LM Studio (modelos locales)](/es/providers/lmstudio)
- [MiniMax](/es/providers/minimax)
- [Mistral](/es/providers/mistral)
- [Moonshot AI (Kimi + Kimi Coding)](/es/providers/moonshot)
@ -80,10 +81,10 @@ modelo predeterminado como `provider/model`.
## Páginas generales compartidas
- [Variantes empaquetadas adicionales](/es/providers/models#additional-bundled-provider-variants) - Anthropic Vertex, Copilot Proxy y Gemini CLI OAuth
- [Generación de imágenes](/es/tools/image-generation) - Herramienta compartida `image_generate`, selección de proveedor y failover
- [Generación de música](/es/tools/music-generation) - Herramienta compartida `music_generate`, selección de proveedor y failover
- [Generación de video](/es/tools/video-generation) - Herramienta compartida `video_generate`, selección de proveedor y failover
- [Variantes adicionales incluidas](/es/providers/models#additional-bundled-provider-variants) - Anthropic Vertex, Copilot Proxy y Gemini CLI OAuth
- [Generación de imágenes](/es/tools/image-generation) - Herramienta compartida `image_generate`, selección de proveedor y conmutación por error
- [Generación de música](/es/tools/music-generation) - Herramienta compartida `music_generate`, selección de proveedor y conmutación por error
- [Generación de video](/es/tools/video-generation) - Herramienta compartida `video_generate`, selección de proveedor y conmutación por error
## Proveedores de transcripción
@ -93,5 +94,5 @@ modelo predeterminado como `provider/model`.
- [Claude Max API Proxy](/es/providers/claude-max-api-proxy) - Proxy de la comunidad para credenciales de suscripción de Claude (verifica la política/los términos de Anthropic antes de usarlo)
Para el catálogo completo de proveedores (xAI, Groq, Mistral, etc.) y la configuración avanzada,
Para ver el catálogo completo de proveedores (xAI, Groq, Mistral, etc.) y la configuración avanzada,
consulta [Proveedores de modelos](/es/concepts/model-providers).

View File

@ -0,0 +1,163 @@
---
read_when:
- Quieres ejecutar OpenClaw con modelos de código abierto mediante LM Studio
- Quieres configurar y ajustar LM Studio
summary: Ejecuta OpenClaw con LM Studio
title: LM Studio
x-i18n:
generated_at: "2026-04-13T08:50:35Z"
model: gpt-5.4
provider: openai
source_hash: 11264584e8277260d4215feb7c751329ce04f59e9228da1c58e147c21cd9ac2c
source_path: providers/lmstudio.md
workflow: 15
---
# LM Studio
LM Studio es una aplicación amigable pero potente para ejecutar modelos de pesos abiertos en tu propio hardware. Te permite ejecutar modelos llama.cpp (GGUF) o MLX (Apple Silicon). Viene en un paquete con GUI o como daemon sin interfaz (`llmster`). Para consultar la documentación del producto y la configuración, consulta [lmstudio.ai](https://lmstudio.ai/).
## Inicio rápido
1. Instala LM Studio (escritorio) o `llmster` (sin interfaz), luego inicia el servidor local:
```bash
curl -fsSL https://lmstudio.ai/install.sh | bash
```
2. Inicia el servidor
Asegúrate de iniciar la aplicación de escritorio o ejecutar el daemon con el siguiente comando:
```bash
lms daemon up
```
```bash
lms server start --port 1234
```
Si estás usando la aplicación, asegúrate de tener JIT habilitado para una experiencia fluida. Obtén más información en la [guía de JIT y TTL de LM Studio](https://lmstudio.ai/docs/developer/core/ttl-and-auto-evict).
3. OpenClaw requiere un valor de token de LM Studio. Establece `LM_API_TOKEN`:
```bash
export LM_API_TOKEN="your-lm-studio-api-token"
```
Si la autenticación de LM Studio está deshabilitada, usa cualquier valor de token no vacío:
```bash
export LM_API_TOKEN="placeholder-key"
```
Para obtener detalles sobre la configuración de autenticación de LM Studio, consulta [Autenticación de LM Studio](https://lmstudio.ai/docs/developer/core/authentication).
4. Ejecuta la incorporación y elige `LM Studio`:
```bash
openclaw onboard
```
5. En la incorporación, usa el prompt `Default model` para elegir tu modelo de LM Studio.
También puedes configurarlo o cambiarlo más tarde:
```bash
openclaw models set lmstudio/qwen/qwen3.5-9b
```
Las claves de modelo de LM Studio siguen el formato `author/model-name` (por ejemplo, `qwen/qwen3.5-9b`). Las referencias de modelo de OpenClaw anteponen el nombre del proveedor: `lmstudio/qwen/qwen3.5-9b`. Puedes encontrar la clave exacta de un modelo ejecutando `curl http://localhost:1234/api/v1/models` y buscando el campo `key`.
## Incorporación no interactiva
Usa la incorporación no interactiva cuando quieras automatizar la configuración (CI, aprovisionamiento, arranque remoto):
```bash
openclaw onboard \
--non-interactive \
--accept-risk \
--auth-choice lmstudio
```
O especifica la URL base o el modelo con la clave de API:
```bash
openclaw onboard \
--non-interactive \
--accept-risk \
--auth-choice lmstudio \
--custom-base-url http://localhost:1234/v1 \
--lmstudio-api-key "$LM_API_TOKEN" \
--custom-model-id qwen/qwen3.5-9b
```
`--custom-model-id` toma la clave del modelo tal como la devuelve LM Studio (por ejemplo, `qwen/qwen3.5-9b`), sin el prefijo del proveedor `lmstudio/`.
La incorporación no interactiva requiere `--lmstudio-api-key` (o `LM_API_TOKEN` en el entorno).
Para servidores de LM Studio sin autenticación, funciona cualquier valor de token no vacío.
`--custom-api-key` sigue siendo compatible por motivos de compatibilidad, pero se prefiere `--lmstudio-api-key` para LM Studio.
Esto escribe `models.providers.lmstudio`, establece el modelo predeterminado en
`lmstudio/<custom-model-id>` y escribe el perfil de autenticación `lmstudio:default`.
La configuración interactiva puede solicitar una longitud de contexto de carga preferida opcional y la aplica a los modelos de LM Studio detectados que guarda en la configuración.
## Configuración
### Configuración explícita
```json5
{
models: {
providers: {
lmstudio: {
baseUrl: "http://localhost:1234/v1",
apiKey: "${LM_API_TOKEN}",
api: "openai-completions",
models: [
{
id: "qwen/qwen3-coder-next",
name: "Qwen 3 Coder Next",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 128000,
maxTokens: 8192,
},
],
},
},
},
}
```
## Solución de problemas
### LM Studio no detectado
Asegúrate de que LM Studio esté en ejecución y de haber configurado `LM_API_TOKEN` (para servidores sin autenticación, funciona cualquier valor de token no vacío):
```bash
# Inicia mediante la aplicación de escritorio, o sin interfaz:
lms server start --port 1234
```
Verifica que la API sea accesible:
```bash
curl http://localhost:1234/api/v1/models
```
### Errores de autenticación (HTTP 401)
Si la configuración informa HTTP 401, verifica tu clave de API:
- Comprueba que `LM_API_TOKEN` coincida con la clave configurada en LM Studio.
- Para obtener detalles sobre la configuración de autenticación de LM Studio, consulta [Autenticación de LM Studio](https://lmstudio.ai/docs/developer/core/authentication).
- Si tu servidor no requiere autenticación, usa cualquier valor de token no vacío para `LM_API_TOKEN`.
### Carga de modelos justo a tiempo
LM Studio admite la carga de modelos justo a tiempo (JIT), donde los modelos se cargan en la primera solicitud. Asegúrate de tener esto habilitado para evitar errores de tipo 'Model not loaded'.

View File

@ -1,23 +1,23 @@
---
read_when:
- Quieres entender qué funciones pueden llamar a APIs de pago
- Necesitas auditar claves, costos y visibilidad de uso
- Estás explicando los informes de costos de /status o /usage
- Necesitas auditar las claves, los costos y la visibilidad del uso
- Estás explicando los informes de costos de `/status` o `/usage`
summary: Audita qué puede generar gastos, qué claves se usan y cómo ver el uso
title: Uso y costos de API
title: Uso y costos de la API
x-i18n:
generated_at: "2026-04-07T05:06:14Z"
generated_at: "2026-04-13T08:50:34Z"
model: gpt-5.4
provider: openai
source_hash: ab6eefcde9ac014df6cdda7aaa77ef48f16936ab12eaa883d9fe69425a31a2dd
source_hash: f5077e74d38ef781ac7a72603e9f9e3829a628b95c5a9967915ab0f321565429
source_path: reference/api-usage-costs.md
workflow: 15
---
# Uso y costos de API
# Uso y costos de la API
Este documento enumera las **funciones que pueden invocar claves de API** y dónde aparecen sus costos. Se centra en
las funciones de OpenClaw que pueden generar uso del proveedor o llamadas a APIs de pago.
Este documento enumera las **funciones que pueden invocar claves de API** y dónde aparecen sus costos. Se centra en las
funciones de OpenClaw que pueden generar uso del proveedor o llamadas a APIs de pago.
## Dónde aparecen los costos (chat + CLI)
@ -25,81 +25,81 @@ las funciones de OpenClaw que pueden generar uso del proveedor o llamadas a APIs
- `/status` muestra el modelo actual de la sesión, el uso de contexto y los tokens de la última respuesta.
- Si el modelo usa **autenticación con clave de API**, `/status` también muestra el **costo estimado** de la última respuesta.
- Si los metadatos de sesión en vivo son escasos, `/status` puede recuperar contadores
de tokens/caché y la etiqueta del modelo activo en tiempo de ejecución a partir de la última entrada de uso
de la transcripción. Los valores no nulos existentes en vivo siguen teniendo prioridad, y los totales
de transcripción de tamaño de prompt pueden imponerse cuando los totales almacenados faltan o son menores.
- Si los metadatos de la sesión en vivo son escasos, `/status` también puede recuperar los
contadores de tokens/caché y la etiqueta del modelo activo en tiempo de ejecución desde la entrada de uso
más reciente de la transcripción. Los valores en vivo distintos de cero existentes siguen teniendo prioridad, y los totales
de la transcripción ajustados al prompt pueden prevalecer cuando los totales almacenados faltan o son menores.
**Pie de costo por mensaje**
**Pie de costos por mensaje**
- `/usage full` agrega un pie de uso a cada respuesta, incluido el **costo estimado** (solo con clave de API).
- `/usage tokens` muestra solo los tokens; los flujos estilo suscripción con OAuth/token y los flujos CLI ocultan el costo en dólares.
- Nota sobre Gemini CLI: cuando la CLI devuelve 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.
- `/usage tokens` muestra solo tokens; los flujos de OAuth/token de estilo suscripción y CLI ocultan el costo en dólares.
- Nota de Gemini CLI: cuando la CLI devuelve salida JSON, OpenClaw lee el uso desde
`stats`, normaliza `stats.cached` a `cacheRead`, y deriva los tokens de entrada
de `stats.input_tokens - stats.cached` cuando es necesario.
Nota sobre Anthropic: el personal de Anthropic nos dijo que el uso de Claude CLI al estilo OpenClaw
Nota de Anthropic: el personal de Anthropic nos dijo que el uso estilo Claude CLI de OpenClaw
vuelve a estar permitido, por lo que OpenClaw trata la reutilización de Claude CLI y el uso de `claude -p` como
autorizados para esta integración, salvo que Anthropic publique una nueva política.
autorizados para esta integración, a menos que Anthropic publique una nueva política.
Anthropic sigue sin exponer una estimación en dólares por mensaje que OpenClaw pueda
mostrar en `/usage full`.
**Ventanas de uso de CLI (cuotas del proveedor)**
**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 legible se normaliza como `X% left` entre proveedores.
- Proveedores actuales de ventanas de uso: Anthropic, GitHub Copilot, Gemini CLI,
- La salida legible se normaliza a `X% left` entre proveedores.
- Proveedores actuales de ventana de uso: Anthropic, GitHub Copilot, Gemini CLI,
OpenAI Codex, MiniMax, Xiaomi y z.ai.
- Nota sobre MiniMax: sus campos sin procesar `usage_percent` / `usagePercent` significan cuota
restante, por lo que OpenClaw los invierte antes de mostrarlos. Los campos basados en conteo siguen teniendo 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 a partir de marcas de tiempo cuando es necesario e
- Nota de MiniMax: sus campos sin procesar `usage_percent` / `usagePercent` significan
cuota restante, así que OpenClaw los invierte antes de mostrarlos. Los campos basados en recuento siguen teniendo 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 a partir de 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 hooks específicos del proveedor cuando
están disponibles; de lo contrario, OpenClaw recurre a credenciales OAuth/con clave de API coincidentes
de perfiles de autenticación, entorno o configuración.
están disponibles; de lo contrario, OpenClaw recurre a credenciales OAuth/con clave de API
coincidentes desde perfiles de autenticación, variables de entorno o configuración.
Consulta [Uso y costos de tokens](/es/reference/token-use) para obtener detalles y ejemplos.
Consulta [Uso de tokens y costos](/es/reference/token-use) para ver detalles y ejemplos.
## Cómo se descubren las claves
OpenClaw puede recoger credenciales desde:
- **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`).
- **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`, `memorySearch.*`,
`talk.providers.*.apiKey`).
- **Skills** (`skills.entries.<name>.apiKey`), que pueden exportar claves al entorno del proceso de la skill.
- **Skills** (`skills.entries.<name>.apiKey`), que pueden exportar claves al entorno del proceso de la Skill.
## Funciones que pueden consumir claves
## Funciones que pueden gastar claves
### 1) Respuestas de modelo del núcleo (chat + herramientas)
### 1) Respuestas del modelo principal (chat + herramientas)
Cada respuesta o llamada de herramienta usa el **proveedor del modelo actual** (OpenAI, Anthropic, etc.). Esta es la
Cada respuesta o llamada a herramienta usa el **proveedor del modelo actual** (OpenAI, Anthropic, etc.). Esta es la
fuente principal de uso y costo.
Esto también incluye proveedores alojados de estilo suscripción que siguen facturando fuera de
la UI local de OpenClaw, como **OpenAI Codex**, **Alibaba Cloud Model Studio
la interfaz local de OpenClaw, como **OpenAI Codex**, **Alibaba Cloud Model Studio
Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan** y
la ruta de inicio de sesión Claude de OpenClaw de Anthropic con **Extra Usage** habilitado.
la ruta Claude con inicio de sesión de OpenClaw de Anthropic con **Extra Usage** activado.
Consulta [Modelos](/es/providers/models) para la configuración de precios y [Uso y costos de tokens](/es/reference/token-use) para la visualización.
Consulta [Modelos](/es/providers/models) para la configuración de precios y [Uso de tokens y costos](/es/reference/token-use) para la visualización.
### 2) Comprensión de medios (audio/imagen/video)
### 2) Comprensión multimedia (audio/imagen/video)
Los medios entrantes pueden resumirse/transcribirse antes de que se ejecute la respuesta. Esto usa APIs de modelos/proveedores.
Los medios entrantes pueden resumirse/transcribirse antes de que se ejecute la respuesta. Esto usa APIs de modelo/proveedor.
- Audio: OpenAI / Groq / Deepgram / Google / Mistral.
- Imagen: OpenAI / OpenRouter / Anthropic / Google / MiniMax / Moonshot / Qwen / Z.AI.
- Video: Google / Qwen / Moonshot.
Consulta [Comprensión de medios](/es/nodes/media-understanding).
Consulta [Comprensión multimedia](/es/nodes/media-understanding).
### 3) Generación de imágenes y video
Las capacidades compartidas de generación también pueden consumir claves del proveedor:
Las capacidades compartidas de generación también pueden gastar claves del proveedor:
- Generación de imágenes: OpenAI / Google / fal / MiniMax
- Generación de video: Qwen
@ -114,13 +114,14 @@ y [Modelos](/es/concepts/models).
### 4) Embeddings de memoria + búsqueda semántica
La búsqueda semántica en memoria usa **APIs de embeddings** cuando está configurada para proveedores remotos:
La búsqueda semántica de memoria usa **APIs de embeddings** cuando se configura para proveedores remotos:
- `memorySearch.provider = "openai"` → embeddings de OpenAI
- `memorySearch.provider = "gemini"` → embeddings de Gemini
- `memorySearch.provider = "voyage"` → embeddings de Voyage
- `memorySearch.provider = "mistral"` → embeddings de Mistral
- `memorySearch.provider = "ollama"` → embeddings de Ollama (local/autohospedado; normalmente sin facturación de API alojada)
- `memorySearch.provider = "lmstudio"` → embeddings de LM Studio (local/alojado por cuenta propia)
- `memorySearch.provider = "ollama"` → embeddings de Ollama (local/alojado por cuenta propia; normalmente sin facturación de API alojada)
- Respaldo opcional a un proveedor remoto si fallan los embeddings locales
Puedes mantenerlo local con `memorySearch.provider = "local"` (sin uso de API).
@ -142,12 +143,12 @@ Consulta [Memoria](/es/concepts/memory).
- **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**: respaldo 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)
- **SearXNG**: `SEARXNG_BASE_URL` o `plugins.entries.searxng.config.webSearch.baseUrl` (sin clave/alojado por cuenta propia; sin facturación de API alojada)
Las rutas heredadas de proveedor `tools.web.search.*` siguen cargándose mediante la capa temporal de compatibilidad, pero ya no son la superficie de configuración recomendada.
Las rutas heredadas `tools.web.search.*` del proveedor todavía se cargan mediante la capa 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 Search cuesta \$5 por cada 1.000 solicitudes, por lo que el crédito cubre
**Crédito gratuito de Brave Search:** cada plan de Brave incluye \$5/mes en crédito gratuito renovable.
El plan Search cuesta \$5 por cada 1.000 solicitudes, así que el crédito cubre
1.000 solicitudes/mes sin cargo. Configura tu límite de uso en el panel de Brave
para evitar cargos inesperados.
@ -159,26 +160,26 @@ Consulta [Herramientas web](/es/tools/web).
- `FIRECRAWL_API_KEY` o `plugins.entries.firecrawl.config.webFetch.apiKey`
Si Firecrawl no está configurado, la herramienta recurre a obtención directa + readability (sin API de pago).
Si Firecrawl no está configurado, la herramienta recurre a fetch directo + readability (sin API de pago).
Consulta [Herramientas web](/es/tools/web).
### 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.
Normalmente son llamadas de bajo volumen, pero aun así alcanzan APIs del proveedor:
Algunos comandos de estado llaman a **endpoints de uso del proveedor** para mostrar ventanas de cuota o salud de autenticación.
Normalmente son llamadas de bajo volumen, pero igualmente acceden a APIs del proveedor:
- `openclaw status --usage`
- `openclaw models status --json`
Consulta [CLI de modelos](/cli/models).
### 7) Resumen de protección de compactación
### 7) Resumen de protección de Compaction
La protección de compactación puede resumir el historial de la sesión usando el **modelo actual**, lo que
La protección de Compaction puede resumir el historial de la sesión usando el **modelo actual**, lo que
invoca APIs del proveedor cuando se ejecuta.
Consulta [Gestión de sesiones + compactación](/es/reference/session-management-compaction).
Consulta [Gestión de sesiones + compaction](/es/reference/session-management-compaction).
### 8) Escaneo / sondeo de modelos
@ -197,7 +198,7 @@ Consulta [Modo Talk](/es/nodes/talk).
### 10) Skills (APIs de terceros)
Las Skills pueden almacenar `apiKey` en `skills.entries.<name>.apiKey`. Si una skill usa esa clave para APIs externas,
puede generar costos según el proveedor de la skill.
Las Skills pueden almacenar `apiKey` en `skills.entries.<name>.apiKey`. Si una Skill usa esa clave para APIs externas,
puede generar costos según el proveedor de la Skill.
Consulta [Skills](/es/tools/skills).