--- read_when: - Necesita una referencia de configuración de modelos para cada proveedor. - Quiere configuraciones de ejemplo o comandos de incorporación de la CLI para proveedores de modelos sidebarTitle: Model providers summary: Descripción general de los proveedores de modelos con configuraciones de ejemplo y flujos de la CLI title: Proveedores de modelos x-i18n: generated_at: "2026-07-14T13:34:12Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 25 provider: openai source_hash: 76af1a1ce55ffc7ecc9c9d580a7826acd3ea7f2591c8cdf683722bb3ff3e2166 source_path: concepts/model-providers.md workflow: 16 --- Referencia para **proveedores de LLM/modelos** (no canales de chat como WhatsApp/Telegram). Para consultar las reglas de selección de modelos, véase [Modelos](/es/concepts/models). ## Reglas rápidas - Las referencias de modelos usan `provider/model` (ejemplo: `opencode/claude-opus-4-6`). - `agents.defaults.models` actúa como lista de permitidos cuando se establece. - Auxiliares de la CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set `. - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` establecen los valores predeterminados a nivel de proveedor; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` los reemplazan para cada modelo. - Reglas de respaldo, sondeos durante el tiempo de espera y persistencia de reemplazos de sesión: [Conmutación por error de modelos](/es/concepts/model-failover). `openclaw configure` conserva un `agents.defaults.model.primary` existente al añadir o volver a autenticar un proveedor. `openclaw models auth login` hace lo mismo, salvo que se proporcione `--set-default`. Los plugins de proveedores aún pueden devolver un modelo predeterminado recomendado en su parche de configuración de autenticación, pero OpenClaw lo interpreta como «hacer que este modelo esté disponible» cuando ya existe un modelo principal, no como «reemplazar el modelo principal actual». Para cambiar intencionadamente el modelo predeterminado, use `openclaw models set ` o `openclaw models auth login --provider --set-default`. Las referencias de modelos de OpenAI y los entornos de ejecución de agentes están separados: - `openai/` selecciona el proveedor y el modelo canónicos de OpenAI. El prefijo por sí solo nunca selecciona Codex. - Cuando la política del entorno de ejecución del proveedor/modelo no está establecida o es `auto`, OpenAI puede seleccionar Codex implícitamente solo para una ruta oficial HTTPS exacta de Platform Responses o ChatGPT Responses sin ningún reemplazo de solicitud definido. - Los adaptadores de Completions definidos, los endpoints personalizados y las rutas con comportamiento de solicitud definido permanecen en OpenClaw. Los endpoints HTTP oficiales sin cifrar se rechazan. - Las referencias heredadas de modelos de Codex son configuración heredada que doctor reescribe como `openai/`. - El `agentRuntime.id: "openclaw"` de proveedor/modelo mantiene explícitamente en OpenClaw una ruta que, de otro modo, sería apta. `agentRuntime.id: "codex"` requiere Codex y produce un fallo cerrado cuando la ruta efectiva no es compatible con Codex. Véanse [Entorno de ejecución implícito de agentes de OpenAI](/es/providers/openai#implicit-agent-runtime) y [Arnés de Codex](/es/plugins/codex-harness). Si la separación entre proveedor y entorno de ejecución resulta confusa, consulte primero [Entornos de ejecución de agentes](/es/concepts/agent-runtimes). La activación automática de plugins sigue el mismo límite: una ruta efectiva implícitamente compatible con Codex puede activar el plugin de Codex, mientras que el `agentRuntime.id: "codex"` explícito de proveedor/modelo o las referencias heredadas `codex/` lo requieren. Un prefijo `openai/*` por sí solo no lo hace. La configuración nueva de OpenAI usa una referencia de GPT-5.6 específica de la ruta: la configuración con clave de API selecciona `openai/gpt-5.6` (el identificador básico de la API directa se resuelve como Sol), mientras que OAuth de ChatGPT/Codex selecciona exactamente `openai/gpt-5.6-sol` para el catálogo nativo de Codex. Los modelos principales explícitos existentes, incluido `openai/gpt-5.5`, se conservan al añadir o actualizar la autenticación de OpenAI. GPT-5.5 continúa disponible mediante cualquiera de los entornos de ejecución como opción explícita de recuperación para cuentas sin acceso a GPT-5.6. Los entornos de ejecución de la CLI usan la misma separación: elija referencias canónicas de modelos como `anthropic/claude-*` o `google/gemini-*` y, después, establezca la política del entorno de ejecución del proveedor/modelo en `claude-cli` o `google-gemini-cli` cuando desee un backend de CLI local. Las referencias heredadas `claude-cli/*` y `google-gemini-cli/*` migran de nuevo a referencias canónicas de proveedores, con el entorno de ejecución registrado por separado. Las referencias heredadas `codex-cli/*` migran a `openai/*` y usan la ruta del servidor de aplicaciones de Codex; OpenClaw ya no mantiene un backend de CLI de Codex incluido. ## Configurar proveedores en la interfaz de control Abra **Configuración → Proveedores de modelos** en la interfaz de control para añadir, reemplazar o eliminar las claves de API de proveedores almacenadas en `models.providers..apiKey`. La página identifica si cada clave de API procede de la configuración de OpenClaw o de una variable de entorno sin mostrar la credencial. Las claves proporcionadas mediante el entorno siguen gestionándose mediante el entorno del proceso del Gateway. Use **Probar conexión** para ejecutar un sondeo activo del proveedor y consultar la latencia o un error categorizado de autenticación, límite de frecuencia, facturación, tiempo de espera o respuesta. Un sondeo realiza una solicitud real al proveedor y puede consumir una pequeña cantidad de tokens. También se puede cerrar la sesión de los perfiles de OAuth y de tokens desde la tarjeta del proveedor. La tarjeta **Modelos predeterminados** gestiona el modelo principal, los modelos de respaldo ordenados y el modelo de utilidad del catálogo de modelos configurado. Elija los modelos y, después, guárdelos juntos en las opciones existentes `agents.defaults.model` y `agents.defaults.utilityModel`. Para el modelo de utilidad, **Automático** deja la opción sin establecer y **Desactivado** almacena una cadena vacía para desactivar el enrutamiento de utilidad. ## Comportamiento de proveedores gestionado por plugins La mayor parte de la lógica específica de cada proveedor reside en los plugins de proveedores (`registerProvider(...)`), mientras que OpenClaw mantiene el bucle genérico de inferencia. Los plugins gestionan la incorporación, los catálogos de modelos, la asignación de variables de entorno de autenticación, la normalización del transporte y la configuración, la limpieza del esquema de herramientas, la clasificación de conmutación por error, la actualización de OAuth, los informes de uso, los perfiles de pensamiento/razonamiento y mucho más. La lista completa de hooks del SDK de proveedores y los ejemplos de plugins incluidos se encuentra en [Plugins de proveedores](/es/plugins/sdk-provider-plugins). Un proveedor que necesite un ejecutor de solicitudes totalmente personalizado constituye una superficie de extensión independiente y más profunda. El comportamiento del ejecutor gestionado por el proveedor reside en hooks explícitos del proveedor, como la política de reproducción, la normalización del esquema de herramientas, el encapsulado de flujos y los auxiliares de transporte/solicitud. El contenedor estático heredado `ProviderPlugin.capabilities` solo existe por compatibilidad y la lógica compartida del ejecutor ya no lo lee. ## Rotación de claves de API Configure varias claves mediante: - `OPENCLAW_LIVE__KEY` (reemplazo activo único, máxima prioridad) - `_API_KEYS` (lista separada por comas o puntos y comas) - `_API_KEY` (clave principal) - `_API_KEY_*` (lista numerada, p. ej., `_API_KEY_1`) Para los proveedores de Google, también se incluye `GOOGLE_API_KEY` como respaldo. El orden de selección de claves conserva la prioridad y elimina los valores duplicados. - Las solicitudes solo se vuelven a intentar con la siguiente clave ante respuestas de límite de frecuencia (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 sobre límites de uso). - Los fallos no relacionados con límites de frecuencia producen un fallo inmediato; no se intenta rotar las claves. - Cuando fallan todas las claves candidatas, se devuelve el error final del último intento. ## Plugins de proveedores oficiales Los plugins de proveedores oficiales publican sus propias filas del catálogo de modelos. Estos proveedores **no** requieren entradas de modelo `models.providers`; active el plugin del proveedor, configure la autenticación y elija un modelo. Use `models.providers` solo para proveedores personalizados explícitos u opciones específicas de solicitud, como los tiempos de espera. ### 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` (reemplazo único) - Valor predeterminado de una configuración nueva: `openai/gpt-5.6`; en la API directa, el identificador básico se resuelve como Sol. - Modelos de ejemplo: `openai/gpt-5.6`, `openai/gpt-5.6-terra`, `openai/gpt-5.6-luna`, `openai/gpt-5.5` - Verifique la disponibilidad de la cuenta o del modelo con `openclaw models list --provider openai` si una instalación o clave de API específica se comporta de manera diferente. - CLI: `openclaw onboard --auth-choice openai-api-key` - El transporte predeterminado es `auto`; OpenClaw pasa la opción de transporte al entorno de ejecución compartido del modelo. - Reemplácelo para cada modelo mediante `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"` o `"auto"`) - El procesamiento prioritario de OpenAI se puede activar mediante `agents.defaults.models["openai/"].params.serviceTier` - `/fast` y `params.fastMode` asignan las solicitudes directas de Responses de `openai/*` a `service_tier=priority` en `api.openai.com` - Use `params.serviceTier` cuando desee un nivel explícito en lugar del conmutador compartido `/fast` - Los encabezados ocultos de atribución de OpenClaw (`originator`, `version`, `User-Agent`) solo se aplican al tráfico nativo de OpenAI dirigido a `api.openai.com`, no a proxies genéricos compatibles con OpenAI - Las rutas nativas de OpenAI también conservan el `store` de Responses, las indicaciones de caché de prompts y la adaptación de la carga útil para la compatibilidad con el razonamiento de OpenAI; las rutas mediante proxy no lo hacen - `openai/gpt-5.3-codex-spark` solo está disponible mediante OAuth de ChatGPT/Codex; las rutas de claves de API directas de OpenAI y de claves de API de Azure lo rechazan ```json5 { agents: { defaults: { model: { primary: "openai/gpt-5.6" } } }, } ``` Si la organización de la API no ofrece GPT-5.6, establezca `openai/gpt-5.5` explícitamente. La incorporación y la reautenticación normales conservan un modelo principal explícito existente; `models auth login --set-default` y `models set` son las vías de reemplazo intencionado. ### Anthropic - 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` (reemplazo único) - Modelo de ejemplo: `anthropic/claude-opus-4-6` - CLI: `openclaw onboard --auth-choice apiKey` - Las solicitudes públicas directas de Anthropic admiten el conmutador compartido `/fast` y `params.fastMode`, incluido el tráfico autenticado mediante clave de API y OAuth enviado a `api.anthropic.com`; OpenClaw lo asigna a `service_tier` de Anthropic (`auto` frente a `standard_only`) - La configuración preferida de la CLI de Claude mantiene la referencia del modelo canónica y selecciona el backend de la CLI por separado: `anthropic/claude-opus-4-8` con `agentRuntime.id: "claude-cli"` específico del modelo. Las referencias heredadas `claude-cli/claude-opus-4-7` siguen funcionando por compatibilidad. La reutilización de la CLI de Claude (`claude -p`) es una vía de integración autorizada de OpenClaw. La autenticación mediante token de configuración de Anthropic sigue siendo compatible, pero OpenClaw prefiere reutilizar la CLI de Claude cuando está disponible. ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } ``` ### OAuth de OpenAI ChatGPT/Codex - Proveedor: `openai` - Autenticación: OAuth (ChatGPT) - Referencia nueva del arnés nativo del servidor de aplicaciones de Codex: `openai/gpt-5.6-sol` - Documentación del arnés nativo del servidor de aplicaciones de Codex: [arnés de Codex](/es/plugins/codex-harness) - Referencias de modelos heredadas: `codex/gpt-*` - Límite del Plugin: `openai/*` carga el Plugin de OpenAI; la política explícita del entorno de ejecución o la ruta efectiva propiedad del proveedor determina si se selecciona el Plugin nativo del servidor de aplicaciones de Codex. - CLI: `openclaw onboard --auth-choice openai` o `openclaw models auth login --provider openai` - El transporte de Responses de ChatGPT integrado en OpenClaw utiliza de forma predeterminada `auto` (primero WebSocket, con SSE como alternativa). - `agents.defaults.models["openai/"].params.transport`, `params.serviceTier` y `params.fastMode` son ajustes de solicitud integrada definidos explícitamente. Mantienen la selección implícita del entorno de ejecución en OpenClaw; Codex nativo controla el transporte de su servidor de aplicaciones y el nivel de servicio. - Los encabezados ocultos de atribución de OpenClaw (`originator`, `version`, `User-Agent`) solo se adjuntan al tráfico de Codex nativo dirigido a `chatgpt.com/backend-api`, no a proxies genéricos compatibles con OpenAI - El conmutador compartido `/fast` sigue disponible como control del entorno de ejecución; es distinto de los parámetros de modelo definidos explícitamente. - El catálogo nativo de Codex puede exponer las referencias exactas `openai/gpt-5.6-sol`, `openai/gpt-5.6-terra` y `openai/gpt-5.6-luna` según el acceso de la cuenta. No aplica en el cliente el alias simple `gpt-5.6` de la API directa. - `openai/gpt-5.5` utiliza el valor nativo `contextWindow = 400000` del catálogo de Codex y el entorno de ejecución predeterminado `contextTokens = 272000`; cambie el límite del entorno de ejecución con `models.providers.openai.models[].contextTokens` - Inicie sesión con la autenticación `openai` y utilice `openai/gpt-5.6-sol` para una configuración nueva respaldada por una suscripción. Seleccione `openai/gpt-5.5` explícitamente si ese espacio de trabajo de Codex no expone GPT-5.6. - Utilice el proveedor/modelo `agentRuntime.id: "openclaw"` para mantener una ruta que, de otro modo, sería apta en el entorno de ejecución integrado. Cuando el entorno de ejecución no esté definido o sea `auto`, solo una ruta oficial HTTPS exacta compatible con Responses/ChatGPT y sin modificaciones explícitas de la solicitud podrá seleccionar Codex implícitamente. - Las referencias GPT heredadas de Codex son estado heredado, no una ruta de proveedor activa. Utilice referencias canónicas `openai/*` para la configuración de agentes nuevos y ejecute `openclaw doctor --fix` para migrar referencias de modelos Codex heredadas sin actualizar una selección explícita existente de `openai/gpt-5.5`. ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, }, }, } ``` ```json5 { models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Otras opciones alojadas basadas en suscripción Acceso al plan de programación de MiniMax mediante OAuth o clave de API. Superficie del proveedor Qwen Cloud, además de la asignación de endpoints de Alibaba DashScope y del plan de programación. Plan de programación de Z.AI o endpoints generales de la API. ### OpenCode - Autenticación: `OPENCODE_API_KEY` (o `OPENCODE_ZEN_API_KEY`) - Proveedor del entorno de ejecución Zen: `opencode` - Proveedor del entorno de ejecución Go: `opencode-go` - Modelos de ejemplo: `opencode/claude-opus-4-6`, `opencode-go/kimi-k2.6` - CLI: `openclaw onboard --auth-choice opencode-zen` o `openclaw onboard --auth-choice opencode-go` ```json5 { agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } }, } ``` ### Google Gemini (clave de API) - Proveedor: `google` - Autenticación: `GEMINI_API_KEY` - Rotación opcional: `GEMINI_API_KEYS`, `GEMINI_API_KEY_1`, `GEMINI_API_KEY_2`, `GOOGLE_API_KEY` como alternativa y `OPENCLAW_LIVE_GEMINI_KEY` (sustitución única) - Modelos de ejemplo: `google/gemini-3.1-pro-preview`, `google/gemini-3.5-flash` - Compatibilidad: la configuración heredada de OpenClaw que utiliza `google/gemini-3.1-flash-preview` se normaliza a `google/gemini-3-flash-preview` - Alias: se acepta `google/gemini-3.1-pro` y se normaliza al identificador activo de la API Gemini de Google, `google/gemini-3.1-pro-preview` - CLI: `openclaw onboard --auth-choice gemini-api-key` - Razonamiento: `/think adaptive` utiliza el razonamiento dinámico de Google. Gemini 3/3.1 omite un `thinkingLevel` fijo; Gemini 2.5 envía `thinkingBudget: -1`. - Las ejecuciones directas de Gemini también aceptan `agents.defaults.models["google/"].params.cachedContent` (o el valor heredado `cached_content`) para reenviar un identificador `cachedContents/...` nativo del proveedor; los aciertos de caché de Gemini se presentan como `cacheRead` de OpenClaw ### Google Vertex y CLI de Gemini - Proveedores: `google-vertex`, `google-gemini-cli` - Autenticación: Vertex utiliza ADC de gcloud; la CLI de Gemini utiliza su flujo OAuth OAuth de la CLI de Gemini en OpenClaw es una integración no oficial. Algunos usuarios han informado de restricciones en sus cuentas de Google tras usar clientes de terceros. Revise las condiciones de Google y utilice una cuenta no crítica si decide continuar. OAuth de la CLI de Gemini se distribuye como parte del Plugin incluido `google`. ```bash brew install gemini-cli ``` ```bash npm install -g @google/gemini-cli ``` ```bash openclaw plugins enable google ``` ```bash openclaw models auth login --provider google-gemini-cli --set-default ``` Modelo predeterminado: `google-gemini-cli/gemini-3-flash-preview`. **No** se pega un identificador de cliente ni un secreto en `openclaw.json`. El flujo de inicio de sesión de la CLI almacena los tokens en perfiles de autenticación del host del Gateway. Si las solicitudes fallan después de iniciar sesión, establezca `GOOGLE_CLOUD_PROJECT` o `GOOGLE_CLOUD_PROJECT_ID` en el host del Gateway. La CLI de Gemini utiliza `stream-json` de forma predeterminada. OpenClaw lee los mensajes del flujo del asistente y normaliza `stats.cached` en `cacheRead`; las sustituciones heredadas de `--output-format json` siguen leyendo el texto de respuesta de `response`. ### Z.AI (GLM) - Proveedor: `zai` - Autenticación: `ZAI_API_KEY` - Modelo de ejemplo: `zai/glm-5.2` - CLI: `openclaw onboard --auth-choice zai-api-key` - Las referencias de modelos utilizan el identificador canónico de proveedor `zai/*`. - `zai-api-key` detecta automáticamente el endpoint correspondiente de Z.AI; `zai-coding-global`, `zai-coding-cn`, `zai-global` y `zai-cn` fuerzan una superficie específica ### Gateway de IA de Vercel - Proveedor: `vercel-ai-gateway` - Autenticación: `AI_GATEWAY_API_KEY` - Modelos de ejemplo: `vercel-ai-gateway/anthropic/claude-opus-4.6`, `vercel-ai-gateway/moonshotai/kimi-k2.6` - CLI: `openclaw onboard --auth-choice ai-gateway-api-key` ### Otros Plugins de proveedores incluidos | Proveedor | Id | Variable de entorno de autenticación | Modelo de ejemplo | | --------------------------------------- | -------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------- | | Arcee | `arcee` | `ARCEEAI_API_KEY` o `OPENROUTER_API_KEY` | `arcee/trinity-large-thinking` | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | Cerebras | `cerebras` | `CEREBRAS_API_KEY` | `cerebras/zai-glm-4.7` | | Chutes | `chutes` | `CHUTES_API_KEY` o `CHUTES_OAUTH_TOKEN` | `chutes/zai-org/GLM-4.7-TEE` | | ClawRouter | `clawrouter` | `CLAWROUTER_API_KEY` | `clawrouter/anthropic/claude-sonnet-4-6` | | Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-plus-05-2026` | | DeepInfra | `deepinfra` | `DEEPINFRA_API_KEY` | `deepinfra/deepseek-ai/DeepSeek-V4-Flash` | | DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | `deepseek/deepseek-v4-flash` | | Featherless AI | `featherless` | `FEATHERLESS_API_KEY` | `featherless/Qwen/Qwen3-32B` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | GMI Cloud | `gmi` | `GMI_API_KEY` | `gmi/google/gemini-3.1-flash-lite` | | Groq | `groq` | `GROQ_API_KEY` | `groq/llama-3.3-70b-versatile` | | Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` o `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` | | MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M3` | | Mistral | `mistral` | `MISTRAL_API_KEY` | `mistral/mistral-large-latest` | | Moonshot | `moonshot` | `MOONSHOT_API_KEY` | `moonshot/kimi-k2.6` | | NVIDIA | `nvidia` | `NVIDIA_API_KEY` | `nvidia/nvidia/nemotron-3-ultra-550b-a55b` | | NovitaAI | `novita` | `NOVITA_API_KEY` | `novita/deepseek/deepseek-v3-0324` | | [Ollama Cloud](/es/providers/ollama-cloud) | `ollama-cloud` | `OLLAMA_API_KEY` | `ollama-cloud/kimi-k2.6` | | OpenRouter | `openrouter` | OAuth de OpenRouter o `OPENROUTER_API_KEY` | `openrouter/auto` | | Qianfan | `qianfan` | `QIANFAN_API_KEY` | `qianfan/deepseek-v3.2` | | [OAuth de Qwen](/es/providers/qwen-oauth) | `qwen-oauth` | `QWEN_API_KEY` | `qwen-oauth/qwen3.5-plus` | | Tencent TokenHub | `tencent-tokenhub` | `TOKENHUB_API_KEY` | `tencent-tokenhub/hy3-preview` | | Together | `together` | `TOGETHER_API_KEY` | `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | | Venice | `venice` | `VENICE_API_KEY` | - | | Vercel AI Gateway | `vercel-ai-gateway` | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway/anthropic/claude-opus-4.6` | | Volcano Engine (Doubao) | `volcengine` / `volcengine-plan` | `VOLCANO_ENGINE_API_KEY` | `volcengine-plan/ark-code-latest` | | xAI | `xai` | OAuth de SuperGrok/X Premium o `XAI_API_KEY` | `xai/grok-4.3` | | Xiaomi | `xiaomi` / `xiaomi-token-plan` | `XIAOMI_API_KEY` / `XIAOMI_TOKEN_PLAN_API_KEY` | `xiaomi/mimo-v2-flash` / `xiaomi-token-plan/mimo-v2.5-pro` | #### Particularidades que conviene conocer Aplica sus encabezados de atribución de aplicaciones y los marcadores de Anthropic `cache_control` únicamente en rutas `openrouter.ai` verificadas. Las referencias de DeepSeek, Moonshot y ZAI son aptas para el TTL de caché del almacenamiento en caché de prompts gestionado por OpenRouter, pero no reciben marcadores de caché de Anthropic. Al ser una ruta compatible con OpenAI de tipo proxy, omite el procesamiento exclusivo de OpenAI nativo (`serviceTier`, `store` de Responses, indicaciones de caché de prompts y compatibilidad de razonamiento de OpenAI). Las referencias basadas en Gemini conservan únicamente el saneamiento de firmas de pensamiento del proxy de Gemini. Las referencias basadas en Gemini siguen la misma ruta de saneamiento del proxy de Gemini; `kilocode/kilo/auto` y otras referencias sin compatibilidad con el razonamiento mediante proxy omiten la inyección de razonamiento del proxy. La incorporación mediante clave de API escribe definiciones explícitas de los modelos de chat M3 y M2.7; la comprensión de imágenes permanece en el proveedor multimedia `MiniMax-VL-01`, propiedad del plugin. Los identificadores de modelos usan un espacio de nombres `nvidia//` (por ejemplo, `nvidia/nvidia/nemotron-...` junto con `nvidia/moonshotai/kimi-k2.5`); los selectores conservan la composición literal `/`, mientras que la clave canónica enviada a la API mantiene un único prefijo. Usa la ruta Responses de xAI. La ruta recomendada es OAuth de SuperGrok/X Premium; las claves de API siguen funcionando mediante `XAI_API_KEY` o la configuración del plugin, y `web_search` de Grok reutiliza el mismo perfil de autenticación antes de recurrir a la clave de API. Grok 4.5 puede seleccionarse para chat, programación y trabajo con agentes cuando esté disponible; `grok-4.3` sigue siendo el valor predeterminado incluido y seguro para todas las regiones. Las configuraciones antiguas `/fast` y `params.fastMode: true` siguen resolviéndose mediante las redirecciones de compatibilidad con Grok 4.3 de xAI, pero las configuraciones nuevas deben seleccionar directamente un modelo actual. `tool_stream` está activado de forma predeterminada; se puede desactivar mediante `agents.defaults.models["xai/"].params.tool_stream=false`. ## Proveedores mediante `models.providers` (URL personalizada/base) Use `models.providers` (o `models.json`) para añadir proveedores **personalizados** o proxies compatibles con OpenAI/Anthropic. Muchos de los plugins de proveedores incluidos que aparecen a continuación ya publican un catálogo predeterminado. Use entradas `models.providers.` explícitas únicamente cuando quiera sobrescribir la URL base, los encabezados o la lista de modelos predeterminados. Las comprobaciones de capacidades de modelos del Gateway también leen los metadatos `models.providers..models[]` explícitos. Si un modelo personalizado o de proxy acepta imágenes, establezca `input: ["text", "image"]` en ese modelo para que WebChat y las rutas de archivos adjuntos originadas en nodos pasen las imágenes como entradas nativas del modelo en lugar de referencias multimedia de solo texto. `agents.defaults.models["provider/model"]` solo controla la visibilidad de los modelos, los alias y los metadatos por modelo para los agentes. No registra por sí mismo un nuevo modelo de tiempo de ejecución. Para los modelos de proveedores personalizados, añada también `models.providers..models[]` con al menos el `id` correspondiente. ### Moonshot AI (Kimi) Instale `@openclaw/moonshot-provider` antes de la incorporación. Añada una entrada `models.providers.moonshot` explícita únicamente cuando necesite sobrescribir la URL base o los metadatos del modelo: - Proveedor: `moonshot` - Autenticación: `MOONSHOT_API_KEY` - Modelo de ejemplo: `moonshot/kimi-k2.6` - CLI: `openclaw onboard --auth-choice moonshot-api-key` o `openclaw onboard --auth-choice moonshot-api-key-cn` Identificadores de modelos Kimi K2: [//]: # "moonshot-kimi-k2-model-refs:start" - `moonshot/kimi-k2.6` - `moonshot/kimi-k2.7-code` - `moonshot/kimi-k2.5` - `moonshot/kimi-k2-thinking` - `moonshot/kimi-k2-thinking-turbo` - `moonshot/kimi-k2-turbo` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 { agents: { defaults: { model: { primary: "moonshot/kimi-k2.6" } }, }, models: { mode: "merge", providers: { moonshot: { baseUrl: "https://api.moonshot.ai/v1", apiKey: "${MOONSHOT_API_KEY}", api: "openai-completions", models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }], }, }, }, } ``` Consulte [Moonshot AI (Kimi + Kimi Coding)](/es/providers/moonshot) para ver la guía de configuración completa. ### Kimi Coding Kimi Coding usa el endpoint compatible con Anthropic de Moonshot AI: - Proveedor: `kimi` - Autenticación: `KIMI_API_KEY` - Modelo de ejemplo: `kimi/kimi-for-coding` ```json5 { env: { KIMI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "kimi/kimi-for-coding" } }, }, } ``` Los valores heredados `kimi/kimi-code` y `kimi/k2p5` siguen aceptándose como identificadores de modelos de compatibilidad y se normalizan al identificador de modelo estable de la API de Kimi. ### Volcano Engine (Doubao) Volcano Engine (火山引擎) proporciona acceso a Doubao y otros modelos en China. - Proveedor: `volcengine` (programación: `volcengine-plan`) - Autenticación: `VOLCANO_ENGINE_API_KEY` - Modelo de ejemplo: `volcengine-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice volcengine-api-key` ```json5 { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` La incorporación usa de forma predeterminada la superficie de programación, pero el catálogo general `volcengine/*` se registra al mismo tiempo. En los selectores de modelos de incorporación/configuración, la opción de autenticación de Volcengine da preferencia tanto a las filas `volcengine/*` como a las `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. - `volcengine/doubao-seed-1-8-251228` (Doubao Seed 1.8) - `volcengine/doubao-seed-code-preview-251028` - `volcengine/kimi-k2-5-260127` (Kimi K2.5) - `volcengine/glm-4-7-251222` (GLM 4.7) - `volcengine/deepseek-v3-2-251201` (DeepSeek V3.2) - `volcengine-plan/ark-code-latest` - `volcengine-plan/doubao-seed-code` - `volcengine-plan/kimi-k2.5` - `volcengine-plan/kimi-k2-thinking` - `volcengine-plan/glm-4.7` ### BytePlus (internacional) BytePlus ARK proporciona a los usuarios internacionales acceso a los mismos modelos que Volcano Engine. - Proveedor: `byteplus` (programación: `byteplus-plan`) - Autenticación: `BYTEPLUS_API_KEY` - Modelo de ejemplo: `byteplus-plan/ark-code-latest` - CLI: `openclaw onboard --auth-choice byteplus-api-key` ```json5 { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` La incorporación usa de forma predeterminada la interfaz de programación, pero el catálogo general `byteplus/*` se registra al mismo tiempo. En los selectores de modelos de incorporación/configuración, la opción de autenticación de BytePlus da preferencia a las filas `byteplus/*` y `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. - `byteplus/seed-1-8-251228` (Seed 1.8) - `byteplus/kimi-k2-5-260127` (Kimi K2.5) - `byteplus/glm-4-7-251222` (GLM 4.7) - `byteplus-plan/ark-code-latest` - `byteplus-plan/doubao-seed-code` - `byteplus-plan/kimi-k2.5` - `byteplus-plan/kimi-k2-thinking` - `byteplus-plan/glm-4.7` ### Synthetic Synthetic proporciona modelos compatibles con Anthropic mediante el proveedor `synthetic`: - Proveedor: `synthetic` - Autenticación: `SYNTHETIC_API_KEY` - Modelo de ejemplo: `synthetic/hf:MiniMaxAI/MiniMax-M2.5` - CLI: `openclaw onboard --auth-choice synthetic-api-key` ```json5 { agents: { defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } }, }, models: { mode: "merge", providers: { synthetic: { baseUrl: "https://api.synthetic.new/anthropic", apiKey: "${SYNTHETIC_API_KEY}", api: "anthropic-messages", models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }], }, }, }, } ``` ### MiniMax MiniMax se configura mediante `models.providers` porque utiliza endpoints personalizados: - OAuth de MiniMax (global): `--auth-choice minimax-global-oauth` - OAuth de MiniMax (China): `--auth-choice minimax-cn-oauth` - Clave de API de MiniMax (global): `--auth-choice minimax-global-api` - Clave de API de MiniMax (China): `--auth-choice minimax-cn-api` - Autenticación: `MINIMAX_API_KEY` para `minimax`; `MINIMAX_OAUTH_TOKEN` o `MINIMAX_API_KEY` para `minimax-portal` Consulte [/providers/minimax](/es/providers/minimax) para obtener información sobre la configuración, las opciones de modelos y fragmentos de configuración. En la ruta de streaming compatible con Anthropic de MiniMax, OpenClaw desactiva de forma predeterminada el razonamiento para la familia M2.x, salvo que se establezca explícitamente; MiniMax-M3 (y M3.x) mantiene de forma predeterminada la ruta de razonamiento omitido/adaptativo del proveedor. `/fast on` transforma `MiniMax-M2.7` en `MiniMax-M2.7-highspeed`. División de capacidades propiedad del Plugin: - Los valores predeterminados de texto/chat permanecen en `minimax/MiniMax-M3` - La generación de imágenes es `minimax/image-01` o `minimax-portal/image-01` - La comprensión de imágenes corresponde a `MiniMax-VL-01`, propiedad del Plugin, en ambas rutas de autenticación de MiniMax - La búsqueda web permanece en el identificador de proveedor `minimax` ### LM Studio LM Studio se distribuye como un Plugin de proveedor incluido que utiliza la API nativa: - Proveedor: `lmstudio` - Autenticación: `LM_API_TOKEN` - URL base de inferencia predeterminada: `http://localhost:1234/v1` A continuación, establezca un modelo (sustitúyalo por uno de los identificadores devueltos por `http://localhost:1234/api/v1/models`): ```json5 { agents: { defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } }, }, } ``` OpenClaw utiliza los endpoints nativos `/api/v1/models` y `/api/v1/models/load` de LM Studio para la detección y la carga automática, con `/v1/chat/completions` para la inferencia de forma predeterminada. Si se desea que la carga JIT, el TTL y la expulsión automática de LM Studio gestionen el ciclo de vida del modelo, establezca `models.providers.lmstudio.params.preload: false`. Consulte [/providers/lmstudio](/es/providers/lmstudio) para obtener información sobre la configuración y la solución de problemas. ### Ollama Ollama se distribuye como un Plugin de proveedor incluido y utiliza la API nativa de Ollama: - Proveedor: `ollama` - Autenticación: no es necesaria (servidor local) - Modelo de ejemplo: `ollama/llama3.3` - Instalación: [https://ollama.com/download](https://ollama.com/download) ```bash # Instale Ollama y, a continuación, descargue un modelo: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama se detecta localmente en `http://127.0.0.1:11434` al habilitarlo mediante `OLLAMA_API_KEY`, y el Plugin de proveedor incluido añade Ollama directamente a `openclaw onboard` y al selector de modelos. Consulte [/providers/ollama](/es/providers/ollama) para obtener información sobre la incorporación, el modo local/en la nube y la configuración personalizada. ### vLLM vLLM se distribuye como un Plugin de proveedor incluido para servidores locales o autoalojados compatibles con OpenAI: - Proveedor: `vllm` - Autenticación: opcional (depende del servidor) - URL base predeterminada: `http://127.0.0.1:8000/v1` Para habilitar la detección automática localmente (cualquier valor funciona si el servidor no exige autenticación): ```bash export VLLM_API_KEY="vllm-local" ``` A continuación, establezca un modelo (sustitúyalo por uno de los identificadores devueltos por `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` Consulte [/providers/vllm](/es/providers/vllm) para obtener más información. ### SGLang SGLang se distribuye como un Plugin de proveedor incluido para servidores rápidos y autoalojados compatibles con OpenAI: - Proveedor: `sglang` - Autenticación: opcional (depende del servidor) - URL base predeterminada: `http://127.0.0.1:30000/v1` Para habilitar la detección automática localmente (cualquier valor funciona si el servidor no exige autenticación): ```bash export SGLANG_API_KEY="sglang-local" ``` A continuación, establezca un modelo (sustitúyalo por uno de los identificadores devueltos por `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` Consulte [/providers/sglang](/es/providers/sglang) para obtener más información. ### Proxies locales (LM Studio, vLLM, LiteLLM, etc.) Ejemplo (compatible con OpenAI): ```json5 { agents: { defaults: { model: { primary: "lmstudio/my-local-model" }, models: { "lmstudio/my-local-model": { alias: "Local" } }, }, }, models: { providers: { lmstudio: { baseUrl: "http://localhost:1234/v1", apiKey: "${LM_API_TOKEN}", api: "openai-completions", timeoutSeconds: 300, models: [ { id: "my-local-model", name: "Local Model", reasoning: false, input: ["text"], cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, contextWindow: 200000, maxTokens: 8192, }, ], }, }, }, } ``` Para los proveedores personalizados, `reasoning`, `input`, `cost`, `contextWindow` y `maxTokens` son opcionales. Cuando se omiten, OpenClaw utiliza de forma predeterminada: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `contextWindow: 200000` - `maxTokens: 8192` Recomendación: establezca valores explícitos que coincidan con los límites del 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 debido a roles `developer` no compatibles. - Las rutas de estilo proxy compatibles con OpenAI también omiten la conformación de solicitudes exclusiva de OpenAI nativo: sin `service_tier`, sin `store` de Responses, sin `store` de Completions, sin indicaciones de caché de prompts, sin conformación de cargas útiles de compatibilidad de razonamiento de OpenAI y sin encabezados ocultos de atribución de OpenClaw. - Para los proxies de Completions compatibles con OpenAI que necesiten campos específicos del proveedor, establezca `agents.defaults.models["provider/model"].params.extra_body` (o `extraBody`) para combinar JSON adicional con el cuerpo de la solicitud saliente. - Para los controles de plantilla de chat de vLLM, establezca `agents.defaults.models["provider/model"].params.chat_template_kwargs`. El Plugin de vLLM incluido envía automáticamente `enable_thinking: false` y `force_nonempty_content: true` para `vllm/nemotron-3-*` cuando el nivel de razonamiento de la sesión está desactivado. - Para modelos locales lentos o hosts remotos de LAN/tailnet, establezca `models.providers..timeoutSeconds`. Esto amplía la gestión de solicitudes HTTP de modelos del proveedor, incluida la conexión, los encabezados, el streaming del cuerpo y la cancelación total de la obtención protegida, sin aumentar el tiempo de espera de todo el entorno de ejecución del agente. Si `agents.defaults.timeoutSeconds` o un tiempo de espera específico de la ejecución es inferior, aumente también ese límite; los tiempos de espera del proveedor no pueden ampliar la ejecución completa. - Las llamadas HTTP al proveedor de modelos permiten respuestas DNS de IP falsa de Surge, Clash y sing-box en `198.18.0.0/15` y `fc00::/7` únicamente para el nombre de host `baseUrl` del proveedor configurado. Los endpoints de proveedores personalizados/locales también confían en ese origen `scheme://host:port` configurado exacto para las solicitudes de modelos protegidas, incluidos los hosts de bucle invertido, LAN y tailnet. Esta no es una nueva opción de configuración; el `baseUrl` configurado amplía la política de solicitudes únicamente para ese origen. La autorización de nombres de host con IP falsa y la confianza en el origen exacto son mecanismos independientes. Otros destinos privados, de bucle invertido, locales de enlace o de metadatos, así como puertos diferentes, siguen requiriendo una habilitación explícita mediante `models.providers..request.allowPrivateNetwork: true`. Establezca `models.providers..request.allowPrivateNetwork: false` para deshabilitar la confianza en el origen exacto. - Si `baseUrl` está vacío o se omite, OpenClaw conserva el comportamiento predeterminado de OpenAI (que se resuelve como `api.openai.com`). - Por seguridad, un `compat.supportsDeveloperRole: true` explícito se sigue sustituyendo en endpoints `openai-completions` no nativos. - Para `api: "anthropic-messages"` en endpoints no directos (cualquier proveedor distinto del `anthropic` canónico, o un `models.providers.anthropic.baseUrl` personalizado cuyo host no sea un endpoint `api.anthropic.com` público), OpenClaw suprime encabezados beta implícitos de Anthropic como `claude-code-20250219`, `interleaved-thinking-2025-05-14` y marcadores OAuth, para que los proxies personalizados compatibles con Anthropic no rechacen indicadores beta no compatibles. Establezca `models.providers..headers["anthropic-beta"]` explícitamente si el proxy necesita funciones beta específicas. ## Ejemplos de CLI ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` Consulte también: [Configuración](/es/gateway/configuration) para ver ejemplos completos de configuración. ## Contenido relacionado - [Referencia de configuración](/es/gateway/config-agents#agent-defaults) - claves de configuración de modelos - [Conmutación por error de modelos](/es/concepts/model-failover) - cadenas de reserva y comportamiento de reintentos - [Modelos](/es/concepts/models) - configuración y alias de modelos - [Proveedores](/es/providers) - guías de configuración por proveedor