--- read_when: - Necesitas una referencia de configuración de modelos por proveedor - Quieres configuraciones de ejemplo o comandos de incorporación de la CLI para proveedores de modelos sidebarTitle: Model providers summary: Descripción general del proveedor de modelos con configuraciones de ejemplo y flujos de CLI title: Proveedores de modelos x-i18n: generated_at: "2026-07-04T03:35:22Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 410c92229de01cbb2be185e6cd1e2a07e554c7c5aacb356f4a9ffd1bce268de2 source_path: concepts/model-providers.md workflow: 16 --- Referencia para **proveedores de LLM/modelos** (no canales de chat como WhatsApp/Telegram). Para las reglas de selección de modelos, consulta [Modelos](/es/concepts/models). ## Reglas rápidas - Las referencias de modelo usan `provider/model` (ejemplo: `opencode/claude-opus-4-6`). - `agents.defaults.models` actúa como una lista de permitidos cuando está configurado. - Ayudantes de la CLI: `openclaw onboard`, `openclaw models list`, `openclaw models set `. - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` establecen valores predeterminados a nivel de proveedor; `models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` los anulan por modelo. - Reglas de respaldo, sondeos de enfriamiento y persistencia de anulaciones de sesión: [Conmutación por error de modelo](/es/concepts/model-failover). `openclaw configure` conserva un `agents.defaults.model.primary` existente cuando agregas o vuelves a autenticar un proveedor. `openclaw models auth login` hace lo mismo salvo que pases `--set-default`. Los Plugins de proveedor aún pueden devolver un modelo predeterminado recomendado en su parche de configuración de autenticación, pero OpenClaw lo trata como "hacer que este modelo esté disponible" cuando ya existe un modelo principal, no como "reemplazar el modelo principal actual". Para cambiar intencionalmente el modelo predeterminado, usa `openclaw models set ` o `openclaw models auth login --provider --set-default`. Las rutas de la familia OpenAI son específicas por prefijo: - `openai/` usa de forma predeterminada el arnés nativo de servidor de aplicación Codex para turnos de agente. Esta es la configuración habitual de suscripción de ChatGPT/Codex. - las referencias de modelo heredadas de Codex son configuración heredada que doctor reescribe a `openai/`. - `openai/` más `agentRuntime.id: "openclaw"` de proveedor/modelo usa el runtime integrado de OpenClaw para rutas explícitas de clave de API o compatibilidad. Consulta [OpenAI](/es/providers/openai) y [Arnés de Codex](/es/plugins/codex-harness). Si la separación entre proveedor y runtime resulta confusa, lee primero [Runtimes de agente](/es/concepts/agent-runtimes). La activación automática de Plugins sigue el mismo límite: las referencias de agente `openai/*` activan el Plugin de Codex para la ruta predeterminada, y `agentRuntime.id: "codex"` explícito de proveedor/modelo o las referencias heredadas `codex/` también lo requieren. GPT-5.5 está disponible a través del arnés nativo de servidor de aplicación Codex de forma predeterminada en `openai/gpt-5.5`, y a través del runtime de OpenClaw cuando la política de runtime de proveedor/modelo selecciona explícitamente `openclaw`. Los runtimes de CLI usan la misma separación: elige referencias de modelo canónicas como `anthropic/claude-*` o `google/gemini-*`, y luego establece la política de runtime de proveedor/modelo en `claude-cli` o `google-gemini-cli` cuando quieras un backend de CLI local. Las referencias heredadas `claude-cli/*` y `google-gemini-cli/*` migran de vuelta a referencias de proveedor canónicas con el runtime registrado por separado. Las referencias heredadas `codex-cli/*` migran a `openai/*` y usan la ruta de servidor de aplicación Codex; OpenClaw ya no mantiene un backend de CLI de Codex incluido. ## Comportamiento de proveedor propiedad del Plugin La mayor parte de la lógica específica de proveedor vive en los Plugins de proveedor (`registerProvider(...)`), mientras OpenClaw conserva el bucle de inferencia genérico. Los Plugins son responsables de la incorporación, los catálogos de modelos, la asignación de variables de entorno de autenticación, la normalización de transporte/configuración, la limpieza del esquema de herramientas, la clasificación de conmutación por error, la actualización OAuth, los informes de uso, los perfiles de pensamiento/razonamiento y más. La lista completa de hooks del SDK de proveedor y ejemplos de Plugins incluidos está en [Plugins de proveedor](/es/plugins/sdk-provider-plugins). Un proveedor que necesita un ejecutor de solicitudes totalmente personalizado es una superficie de extensión separada y más profunda. El comportamiento de runner propiedad del proveedor vive en hooks explícitos del proveedor, como la política de repetición, la normalización del esquema de herramientas, el envoltorio de streams y los ayudantes de transporte/solicitud. La bolsa estática heredada `ProviderPlugin.capabilities` es solo de compatibilidad y la lógica compartida del runner ya no la lee. ## Rotación de claves de API Configura varias claves mediante: - `OPENCLAW_LIVE__KEY` (anulación live única, 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 proveedores de Google, `GOOGLE_API_KEY` también se incluye como respaldo. El orden de selección de claves conserva la prioridad y elimina valores duplicados. - Las solicitudes se reintentan con la siguiente clave solo 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 de límite de uso). - Los fallos que no son de límite de frecuencia fallan de inmediato; no se intenta rotación de claves. - Cuando todas las claves candidatas fallan, se devuelve el error final del último intento. ## Plugins de proveedor oficiales Los Plugins de proveedor oficiales publican sus propias filas de catálogo de modelos. Estos proveedores **no** requieren entradas de modelo en `models.providers`; activa el Plugin de proveedor, configura la autenticación y elige un modelo. Usa `models.providers` solo para proveedores personalizados explícitos o ajustes estrechos de solicitudes, como 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`, más `OPENCLAW_LIVE_OPENAI_KEY` (anulación única) - Modelos de ejemplo: `openai/gpt-5.5`, `openai/gpt-5.4-mini` - Verifica la disponibilidad de cuenta/modelo con `openclaw models list --provider openai` si una instalación o clave de API específica se comporta de forma diferente. - CLI: `openclaw onboard --auth-choice openai-api-key` - El transporte predeterminado es `auto`; OpenClaw pasa la elección de transporte al runtime de modelo compartido. - Anula por 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 `openai/*` a `service_tier=priority` en `api.openai.com` - Usa `params.serviceTier` cuando quieras un nivel explícito en lugar del conmutador compartido `/fast` - Los encabezados ocultos de atribución de OpenClaw (`originator`, `version`, `User-Agent`) se aplican solo en tráfico nativo de OpenAI hacia `api.openai.com`, no en proxies genéricos compatibles con OpenAI - Las rutas nativas de OpenAI también conservan `store` de Responses, sugerencias de caché de prompts y la conformación de carga útil compatible con razonamiento de OpenAI; las rutas proxy no - `openai/gpt-5.3-codex-spark` está disponible mediante autenticación de suscripción OAuth de ChatGPT/Codex cuando tu cuenta iniciada la expone; OpenClaw sigue suprimiendo rutas directas con clave de API de OpenAI y clave de API de Azure para este modelo porque esos transportes lo rechazan ```json5 { agents: { defaults: { model: { primary: "openai/gpt-5.5" } } }, } ``` ### Anthropic - Proveedor: `anthropic` - Autenticación: `ANTHROPIC_API_KEY` - Rotación opcional: `ANTHROPIC_API_KEYS`, `ANTHROPIC_API_KEY_1`, `ANTHROPIC_API_KEY_2`, más `OPENCLAW_LIVE_ANTHROPIC_KEY` (anulación única) - 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 con 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 Claude CLI mantiene la referencia de modelo canónica y selecciona el backend de CLI por separado: `anthropic/claude-opus-4-8` con `agentRuntime.id: "claude-cli"` con alcance de modelo. Las referencias heredadas `claude-cli/claude-opus-4-7` siguen funcionando por compatibilidad. El personal de Anthropic nos indicó que el uso de Claude CLI al estilo OpenClaw vuelve a estar permitido, por lo que OpenClaw trata la reutilización de Claude CLI y el uso de `claude -p` como aprobados para esta integración salvo que Anthropic publique una política nueva. El token de configuración de Anthropic sigue estando disponible como ruta de token compatible con OpenClaw, pero OpenClaw ahora prefiere la reutilización de Claude CLI y `claude -p` cuando estén disponibles. ```json5 { agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } }, } ``` ### OAuth de OpenAI ChatGPT/Codex - Proveedor: `openai` - Autenticación: OAuth (ChatGPT) - Referencia de modelo heredada de OpenAI Codex: `openai/gpt-5.5` - Referencia del arnés nativo de servidor de aplicación Codex: `openai/gpt-5.5` - Documentación del arnés nativo de servidor de aplicación Codex: [Arnés de Codex](/es/plugins/codex-harness) - Referencias de modelo heredadas: `codex/gpt-*` - Límite de Plugin: `openai/*` carga el Plugin de OpenAI; el Plugin nativo de servidor de aplicación Codex lo selecciona el runtime del arnés de Codex. - CLI: `openclaw onboard --auth-choice openai` o `openclaw models auth login --provider openai` - El transporte predeterminado es `auto` (WebSocket primero, SSE como respaldo) - Anula por modelo de OpenAI Codex mediante `agents.defaults.models["openai/"].params.transport` (`"sse"`, `"websocket"` o `"auto"`) - `params.serviceTier` también se reenvía en solicitudes nativas de Responses de Codex (`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` - `openai/gpt-5.5` usa el `contextWindow = 400000` nativo del catálogo de Codex y el runtime predeterminado `contextTokens = 272000`; anula el límite del runtime con `models.providers.openai.models[].contextTokens` - Nota de política: OpenAI Codex OAuth es compatible explícitamente con herramientas/flujos de trabajo externos como OpenClaw. - Para la ruta común de suscripción más runtime nativo de Codex, inicia sesión con autenticación `openai` y configura `openai/gpt-5.5`; los turnos de agente de OpenAI seleccionan Codex de forma predeterminada. - Usa `agentRuntime.id: "openclaw"` de proveedor/modelo solo cuando quieras la ruta integrada de OpenClaw; de lo contrario, mantén `openai/gpt-5.5` en el arnés predeterminado de Codex. - las referencias GPT heredadas de Codex son estado heredado, no una ruta de proveedor live. Usa `openai/gpt-5.5` en el runtime nativo de Codex para nueva configuración de agente y ejecuta `openclaw doctor --fix` para migrar referencias de modelo heredadas antiguas de Codex a referencias canónicas `openai/*`. ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { openai: { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### Otras opciones alojadas con estilo de suscripción Plan de Codificación de Z.AI o endpoints de API generales. OAuth del Plan de Codificación de MiniMax o acceso con clave de API. Superficie de proveedor de Qwen Cloud más asignación de endpoints de Alibaba DashScope y del Plan de Codificación. ### OpenCode - Autenticación: `OPENCODE_API_KEY` (o `OPENCODE_ZEN_API_KEY`) - Proveedor de runtime Zen: `opencode` - Proveedor de runtime 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`, respaldo de `GOOGLE_API_KEY` y `OPENCLAW_LIVE_GEMINI_KEY` (sobrescritura única) - 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` - Alias: se acepta `google/gemini-3.1-pro` y se normaliza al id de la API Gemini en vivo de Google, `google/gemini-3.1-pro-preview` - CLI: `openclaw onboard --auth-choice gemini-api-key` - Razonamiento: `/think adaptive` usa el razonamiento dinámico de Google. Gemini 3/3.1 omiten 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 heredado `cached_content`) para reenviar un identificador nativo del proveedor `cachedContents/...`; los aciertos de caché de Gemini aparecen como `cacheRead` de OpenClaw ### Google Vertex y Gemini CLI - Proveedores: `google-vertex`, `google-gemini-cli` - Autenticación: Vertex usa ADC de gcloud; Gemini CLI usa su flujo de OAuth Gemini CLI OAuth en OpenClaw es una integración no oficial. Algunos usuarios han informado restricciones de 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. ```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** pegas un id de cliente ni un secreto en `openclaw.json`. El flujo de inicio de sesión de la CLI almacena tokens en perfiles de autenticación en el host del Gateway. Si las solicitudes fallan después de iniciar sesión, define `GOOGLE_CLOUD_PROJECT` o `GOOGLE_CLOUD_PROJECT_ID` en el host del Gateway. Gemini CLI usa `stream-json` de forma predeterminada. OpenClaw lee los mensajes de flujo del asistente y normaliza `stats.cached` a `cacheRead`; las sobrescrituras heredadas de `--output-format json` siguen leyendo el texto de respuesta desde `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 modelo usan el ID de proveedor canónico `zai/*`. - `zai-api-key` detecta automáticamente el punto de conexión de Z.AI correspondiente; `zai-coding-global`, `zai-coding-cn`, `zai-global` y `zai-cn` fuerzan una superficie específica ### Vercel AI Gateway - 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 proveedor incluidos | Proveedor | Id | Env de autenticación | Modelo de ejemplo | | ---------------------------------------- | -------------------------------- | --------------------------------------------------- | --------------------------------------------------------- | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | ClawRouter | `clawrouter` | `CLAWROUTER_API_KEY` | `clawrouter/anthropic/claude-sonnet-4-6` | | Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-03-2025` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | 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` | OpenRouter OAuth o `OPENROUTER_API_KEY` | `openrouter/auto` | | [Qwen OAuth](/es/providers/qwen-oauth) | `qwen-oauth` | `QWEN_API_KEY` | `qwen-oauth/qwen3.5-plus` | | 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` | SuperGrok/X Premium OAuth 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 aplicación y marcadores `cache_control` de Anthropic solo en rutas verificadas de `openrouter.ai`. Las referencias de DeepSeek, Moonshot y ZAI son aptas para TTL de caché en el almacenamiento en caché de prompts gestionado por OpenRouter, pero no reciben marcadores de caché de Anthropic. Como ruta de proxy compatible con OpenAI, omite el modelado exclusivo de OpenAI nativo (`serviceTier`, `store` de Responses, indicios de caché de prompts, compatibilidad de razonamiento de OpenAI). Las referencias respaldadas por Gemini conservan solo el saneamiento de firmas de pensamiento de proxy-Gemini. Las referencias respaldadas por Gemini siguen la misma ruta de saneamiento de proxy-Gemini; `kilocode/kilo/auto` y otras referencias de proxy sin soporte de razonamiento omiten la inyección de razonamiento de proxy. La incorporación con clave de API escribe definiciones explícitas de 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 ids de modelo usan un espacio de nombres `nvidia//` (por ejemplo `nvidia/nvidia/nemotron-...` junto a `nvidia/moonshotai/kimi-k2.5`); los selectores conservan la composición literal `/` mientras que la clave canónica enviada a la API permanece con un solo prefijo. Usa la ruta Responses de xAI. La ruta recomendada es SuperGrok/X Premium OAuth; 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 del respaldo con clave de API. `grok-4.3` es el modelo de chat predeterminado incluido, y `grok-build-0.1` se puede seleccionar para trabajo centrado en compilación/codificación. `/fast` o `params.fastMode: true` reescribe `grok-3`, `grok-3-mini`, `grok-4` y `grok-4-0709` a sus variantes `*-fast`. `tool_stream` está activado de forma predeterminada; desactívalo mediante `agents.defaults.models["xai/"].params.tool_stream=false`. ## Proveedores mediante `models.providers` (URL personalizada/base) Usa `models.providers` (o `models.json`) para añadir proveedores **personalizados** o proxies compatibles con OpenAI/Anthropic. Muchos de los Plugins de proveedor 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. Las comprobaciones de capacidades de modelos del Gateway también leen metadatos explícitos de `models.providers..models[]`. Si un modelo personalizado o proxy acepta imágenes, configura `input: ["text", "image"]` en ese modelo para que WebChat y las rutas de adjuntos originadas en Node pasen imágenes como entradas nativas del modelo en lugar de referencias de medios solo de texto. `agents.defaults.models["provider/model"]` solo controla la visibilidad del modelo, los alias y los metadatos por modelo para los agentes. No registra por sí solo un nuevo modelo de tiempo de ejecución. Para modelos de proveedores personalizados, añade también `models.providers..models[]` con al menos el `id` correspondiente. ### Moonshot AI (Kimi) Instala `@openclaw/moonshot-provider` antes de la incorporación. Añade una entrada explícita `models.providers.moonshot` solo cuando necesites anular 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` IDs de modelo 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" }], }, }, }, } ``` ### Programación con Kimi 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 `id` de modelo heredados `kimi/kimi-code` y `kimi/k2p5` siguen aceptándose por compatibilidad y se normalizan al `id` de modelo de API estable de Kimi. ### Volcano Engine (Doubao) Volcano Engine (火山引擎) proporciona acceso a Doubao y a 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 codificació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 prefiere tanto las filas `volcengine/*` como `volcengine-plan/*`. Si esos modelos aún no se han cargado, 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 128K) - `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 acceso a los mismos modelos que Volcano Engine para usuarios internacionales. - Proveedor: `byteplus` (codificació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 superficie de codificació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 prefiere tanto las filas `byteplus/*` como `byteplus-plan/*`. Si esos modelos aún no se han cargado, 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 detrás del 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 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` - 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 obtener detalles de configuración, opciones de modelos y fragmentos de configuración. En la ruta de streaming compatible con Anthropic de MiniMax, OpenClaw desactiva thinking de forma predeterminada para la familia M2.x salvo que lo configures explícitamente; MiniMax-M3 (y M3.x) permanece de forma predeterminada en la ruta de thinking omitida/adaptativa del proveedor. `/fast on` reescribe `MiniMax-M2.7` como `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 es `MiniMax-VL-01`, propiedad del 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` Después configura un modelo (reemplázalo por uno de los ID 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 y carga automática, con `/v1/chat/completions` para inferencia de forma predeterminada. Si quieres que la carga JIT, TTL y expulsión automática de LM Studio sean propietarias del ciclo de vida del modelo, configura `models.providers.lmstudio.params.preload: false`. Consulta [/providers/lmstudio](/es/providers/lmstudio) para configuración y solución de problemas. ### Ollama Ollama se distribuye como un Plugin de proveedor incluido y usa la API nativa de Ollama: - Proveedor: `ollama` - Autenticación: no requerida (servidor local) - Modelo de ejemplo: `ollama/llama3.3` - Instalación: [https://ollama.com/download](https://ollama.com/download) ```bash # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama se detecta localmente en `http://127.0.0.1:11434` cuando habilitas `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 incorporación, modo cloud/local y configuración personalizada. ### vLLM vLLM se distribuye como un Plugin de proveedor incluido para servidores locales/autohospedados compatibles con OpenAI: - 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): ```bash export VLLM_API_KEY="vllm-local" ``` Después configura un modelo (reemplázalo por uno de los ID devueltos por `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` Consulta [/providers/vllm](/es/providers/vllm) para obtener detalles. ### SGLang SGLang se distribuye como un Plugin de proveedor incluido para servidores rápidos autohospedados compatibles con OpenAI: - 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 exige autenticación): ```bash export SGLANG_API_KEY="sglang-local" ``` Después configura un modelo (reemplázalo por uno de los ID devueltos por `/v1/models`): ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` Consulta [/providers/sglang](/es/providers/sglang) para obtener detalles. ### 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 proveedores personalizados, `reasoning`, `input`, `cost`, `contextWindow` y `maxTokens` son opcionales. Cuando se omiten, OpenClaw usa de forma predeterminada: - `reasoning: false` - `input: ["text"]` - `cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }` - `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 admitidos. - Las rutas compatibles con OpenAI de estilo proxy también omiten la conformación de solicitudes exclusiva de OpenAI nativo: sin `service_tier`, sin Responses `store`, sin Completions `store`, sin sugerencias de caché de prompts, sin conformación de payload de compatibilidad con razonamiento de OpenAI y sin encabezados ocultos de atribución de OpenClaw. - Para proxies de Completions compatibles con OpenAI que necesitan campos específicos del proveedor, configura `agents.defaults.models["provider/model"].params.extra_body` (o `extraBody`) para combinar JSON adicional en el cuerpo de la solicitud saliente. - Para controles de plantillas de chat de vLLM, configura `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 thinking de la sesión está desactivado. - Para modelos locales lentos o hosts remotos de LAN/tailnet, configura `models.providers..timeoutSeconds`. Esto amplía el manejo de solicitudes HTTP de modelos del proveedor, incluida la conexión, los encabezados, el streaming del cuerpo y la cancelación total de guarded-fetch, sin aumentar el tiempo de espera de toda la ejecución del agente. Si `agents.defaults.timeoutSeconds` o un tiempo de espera específico de la ejecución es menor, aumenta también ese límite; los tiempos de espera del proveedor no pueden ampliar toda la ejecución. - Las llamadas HTTP del proveedor de modelos permiten respuestas DNS de IP falsa de Surge, Clash y sing-box en `198.18.0.0/15` y `fc00::/7` solo para el hostname configurado de `baseUrl` del proveedor. Los endpoints de proveedores personalizados/locales también confían en el origen exacto configurado `scheme://host:port` para solicitudes de modelo protegidas, incluidos hosts loopback, LAN y tailnet. Esta no es una nueva opción de configuración; el `baseUrl` que configuras amplía la política de solicitudes solo para ese origen. La autorización de hostname con IP falsa y la confianza de origen exacto son mecanismos independientes. Otros destinos privados, loopback, link-local, de metadatos y puertos distintos siguen requiriendo una habilitación explícita con `models.providers..request.allowPrivateNetwork: true`. Configura `models.providers..request.allowPrivateNetwork: false` para desactivar la confianza de origen exacto. - Si `baseUrl` está vacío/omitido, OpenClaw mantiene el comportamiento predeterminado de OpenAI (que resuelve a `api.openai.com`). - Por seguridad, un `compat.supportsDeveloperRole: true` explícito se sigue sobrescribiendo en endpoints `openai-completions` no nativos. - Para `api: "anthropic-messages"` en endpoints no directos (cualquier proveedor que no sea el `anthropic` canónico, o un `models.providers.anthropic.baseUrl` personalizado cuyo host no sea un endpoint público de `api.anthropic.com`), OpenClaw suprime los encabezados beta implícitos de Anthropic como `claude-code-20250219`, `interleaved-thinking-2025-05-14` y marcadores de OAuth, para que los proxies personalizados compatibles con Anthropic no rechacen flags beta no admitidos. Configura `models.providers..headers["anthropic-beta"]` explícitamente si tu proxy necesita características beta específicas. ## Ejemplos de CLI ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` Consulta también: [Configuración](/es/gateway/configuration) para ver ejemplos completos de configuración. ## 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 fallback y comportamiento de reintento - [Modelos](/es/concepts/models) - configuración y alias de modelos - [Proveedores](/es/providers) - guías de configuración por proveedor