From e25d2d56df3f440ce76c61f2e4d950d2904a3c67 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 13 Apr 2026 08:52:28 +0000 Subject: [PATCH] chore(i18n): refresh es translations --- docs/es/concepts/model-providers.md | 444 +++++++++++++-------------- docs/es/gateway/local-models.md | 80 +++-- docs/es/providers/index.md | 23 +- docs/es/providers/lmstudio.md | 163 ++++++++++ docs/es/reference/api-usage-costs.md | 111 +++---- 5 files changed, 481 insertions(+), 340 deletions(-) create mode 100644 docs/es/providers/lmstudio.md diff --git a/docs/es/concepts/model-providers.md b/docs/es/concepts/model-providers.md index b9ccc45a3..d8c4e82d8 100644 --- a/docs/es/concepts/model-providers.md +++ b/docs/es/concepts/model-providers.md @@ -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 `. -- 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.` 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.` 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__KEY` (anulación única en vivo, máxima prioridad) + - `OPENCLAW_LIVE__KEY` (una sola anulación live, máxima prioridad) - `_API_KEYS` (lista separada por comas o punto y coma) - `_API_KEY` (clave principal) - `_API_KEY_*` (lista numerada, por ejemplo `_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 pi‑ai. 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/"].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/"].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/"].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/"].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 pi‑ai. 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 pi‑ai. 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/"].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/"].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 pi‑ai. 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 pi‑ai. 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 pi‑ai. 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 pi‑ai. 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 pi‑ai. 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.` 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 diff --git a/docs/es/gateway/local-models.md b/docs/es/gateway/local-models.md index 99248ef09..645fdf0b2 100644 --- a/docs/es/gateway/local-models.md +++ b/docs/es/gateway/local-models.md @@ -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 truncarán el contexto y debilitarán 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..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..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. diff --git a/docs/es/providers/index.md b/docs/es/providers/index.md index 01ca0d7d8..da39aaea3 100644 --- a/docs/es/providers/index.md +++ b/docs/es/providers/index.md @@ -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). diff --git a/docs/es/providers/lmstudio.md b/docs/es/providers/lmstudio.md new file mode 100644 index 000000000..1d9a642c9 --- /dev/null +++ b/docs/es/providers/lmstudio.md @@ -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/` 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'. diff --git a/docs/es/reference/api-usage-costs.md b/docs/es/reference/api-usage-costs.md index 275821ecf..a723dde55 100644 --- a/docs/es/reference/api-usage-costs.md +++ b/docs/es/reference/api-usage-costs.md @@ -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..apiKey`), que pueden exportar claves al entorno del proceso de la skill. +- **Skills** (`skills.entries..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..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..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).