Proveedores de modelos

Referencia para proveedores de LLM/modelos (no canales de chat como WhatsApp/Telegram). Para conocer las reglas de selección de modelos, consulte Modelos.

Reglas rápidas

Referencias de modelos y auxiliares de la CLI

Las referencias de modelos usan provider/model (ejemplo: opencode/claude-opus-4-6).
agents.defaults.models almacena alias y ajustes por modelo; agents.defaults.modelPolicy.allow es la lista de permitidos de reemplazo explícito opcional.
Auxiliares de la CLI: openclaw onboard, openclaw models list, openclaw models set <provider/model>.
models.providers.*.contextWindow / contextTokens / maxTokens establecen los valores predeterminados del proveedor; models.providers.*.models[].contextWindow / contextTokens / maxTokens los reemplazan por modelo.
Reglas de respaldo, sondeos de período de espera y persistencia de reemplazos de sesión: Conmutación por error de modelos.

Añadir autenticación de un proveedor no cambia el modelo principal

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 pueden seguir devolviendo un modelo predeterminado recomendado en su parche de configuración de autenticación, pero OpenClaw lo interpreta como «hacer disponible este modelo» cuando ya existe un modelo principal, no como «reemplazar el modelo principal actual».Para cambiar intencionadamente el modelo predeterminado, use openclaw models set <provider/model> o openclaw models auth login --provider <id> --set-default.

Separación entre proveedor y entorno de ejecución de OpenAI

Las referencias de modelos de OpenAI y los entornos de ejecución de agentes están separados:

openai/<model> selecciona el proveedor y el modelo canónicos de OpenAI. El prefijo por sí solo nunca selecciona Codex.
Cuando la política de entorno de ejecución del proveedor/modelo no está definida o es auto, OpenAI solo puede seleccionar Codex de forma implícita para una ruta oficial HTTPS exacta de Platform Responses o ChatGPT Responses sin un reemplazo de solicitud definido.
Los adaptadores de Completions definidos, los endpoints personalizados y las rutas con comportamiento de solicitud definido permanecen en OpenClaw. Se rechazan los endpoints HTTP oficiales de texto sin cifrar.
Las referencias de modelos heredadas de Codex son configuraciones heredadas que doctor reescribe como openai/<model>.
El agentRuntime.id: "openclaw" del 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 seguro cuando la ruta efectiva no es compatible con Codex.

Consulte Entorno de ejecución implícito de agentes de OpenAI y Entorno de Codex. Si la separación entre proveedor y entorno de ejecución resulta confusa, lea primero Entornos de ejecución de agentes.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 del proveedor/modelo o las referencias heredadas codex/<model> lo requieren. Un prefijo openai/* por sí solo no lo requiere.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 id 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 cuando se añade o actualiza la autenticación de OpenAI. GPT-5.5 sigue disponible mediante cualquiera de los entornos de ejecución como opción de recuperación explícita para cuentas sin acceso a GPT-5.6.

Entornos de ejecución de la CLI

Los entornos de ejecución de la CLI usan la misma separación: elija referencias de modelos canónicas como anthropic/claude-* o google/gemini-* y, a continuación, establezca la política de entorno de ejecución del proveedor/modelo como 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 la CLI de Codex incluido.

Configurar proveedores en la interfaz de control

Abra Settings → Model Providers en la interfaz de control para añadir, reemplazar o eliminar claves de API de proveedores almacenadas en models.providers.<id>.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 por el entorno siguen gestionándose mediante el entorno del proceso del Gateway. Use Test connection para ejecutar un sondeo en vivo del proveedor y ver 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 Default models gestiona el modelo principal, los modelos de respaldo ordenados y el modelo auxiliar a partir del catálogo de modelos configurado. Elija los modelos y guárdelos juntos en los ajustes existentes agents.defaults.model y agents.defaults.utilityModel. Para el modelo auxiliar, Automatic deja el ajuste sin definir y Disabled almacena una cadena vacía para desactivar el enrutamiento auxiliar.

Comportamiento propiedad del plugin del proveedor

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 se encargan de 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 la 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 enlaces del SDK de proveedores y ejemplos de plugins incluidos se encuentra en Plugins de proveedores. 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 propiedad del proveedor reside en enlaces explícitos del proveedor, como la política de repetición, la normalización del esquema de herramientas, el encapsulado de flujos y los auxiliares de transporte/solicitudes. 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

Fuentes y prioridad de las claves

Configure varias claves mediante:

OPENCLAW_LIVE_<PROVIDER>_KEY (único reemplazo activo, máxima prioridad)
<PROVIDER>_API_KEYS (lista separada por comas o punto y coma)
<PROVIDER>_API_KEY (clave principal)
<PROVIDER>_API_KEY_* (lista numerada, p. ej., <PROVIDER>_API_KEY_1)

Para los proveedores de Google, GOOGLE_API_KEY también se incluye como respaldo. El orden de selección de claves conserva la prioridad y elimina los valores duplicados.

Cuándo se activa la rotación

Las solicitudes solo se vuelven a intentar con la clave siguiente 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 se deban al límite de frecuencia producen un error inmediato; no se intenta rotar las claves.
Cuando fallan todas las claves candidatas, se devuelve el error final del último intento.

Plugins oficiales de proveedores

Los plugins oficiales de proveedores 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 o ajustes de solicitud específicos, 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 (único reemplazo)
Valor predeterminado de una configuración nueva: openai/gpt-5.6; en la API directa, el id 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 y el 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 transmite la opción de transporte al entorno de ejecución compartido del modelo.
Reemplácelo por modelo mediante agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" o "auto")
El procesamiento prioritario de OpenAI puede activarse mediante agents.defaults.models["openai/<model>"].params.serviceTier
/fast y params.fastMode asignan las solicitudes directas de Responses 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 hacia api.openai.com, no a proxies genéricos compatibles con OpenAI
Las rutas nativas de OpenAI también conservan store de Responses, las sugerencias de caché de prompts y la adaptación de las cargas de compatibilidad de razonamiento de OpenAI; las rutas de proxy no
openai/gpt-5.3-codex-spark solo está disponible mediante OAuth de ChatGPT/Codex; las rutas de clave de API directa de OpenAI y de clave de API de Azure lo rechazan

{
  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 (único reemplazo)
Modelo de ejemplo: anthropic/claude-opus-5
CLI: openclaw onboard --auth-choice apiKey
Las solicitudes públicas directas a 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 la CLI de Claude mantiene canónica la referencia del modelo y selecciona el backend de la CLI por separado: anthropic/claude-opus-5 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 aprobada 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.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-5" } } },
}

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
Referencias de modelos heredadas: codex/gpt-*, openai-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 integrado de Responses de ChatGPT de OpenClaw usa de forma predeterminada auto (primero WebSocket, con SSE como alternativa).
agents.defaults.models["openai/<model>"].params.transport, params.serviceTier y params.fastMode son ajustes definidos para solicitudes integradas. 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 hacia 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.
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 usa el contextWindow = 400000 nativo del catálogo de Codex y el entorno de ejecución predeterminado contextTokens = 272000; sustituya el límite del entorno de ejecución con models.providers.openai.models[].contextTokens
Inicie sesión con la autenticación openai y use 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 ofrece GPT-5.6.
Use 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é establecido o sea auto, solo una ruta HTTPS oficial exacta compatible con Responses/ChatGPT y sin ninguna sustitución de solicitud definida podrá seleccionar Codex implícitamente.
Las referencias heredadas de GPT de Codex son estado heredado, no una ruta de proveedor activa. Use referencias canónicas openai/* para la configuración de agentes nuevos y ejecute openclaw doctor --fix para migrar las referencias codex/* y openai-codex/* conservando su semántica nativa de Codex mediante agentRuntime.id: "codex" con ámbito de modelo. Las selecciones canónicas explícitas existentes de openai/gpt-5.5 no se actualizan.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.6-sol" },
    },
  },
}

{
  models: {
    providers: {
      openai: {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

Otras opciones alojadas de tipo suscripción

MiniMax

Acceso a MiniMax Coding Plan mediante OAuth o clave de API.

Qwen Cloud

Interfaz del proveedor Qwen Cloud, además de la correspondencia de endpoints de Alibaba DashScope y Coding Plan.

Z.AI (GLM)

Coding Plan de Z.AI o endpoints generales de 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

{
  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 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 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 usa el razonamiento dinámico de Google. Los 3/3.1 de Gemini omiten un thinkingLevel fijo; Gemini 2.5 envía thinkingBudget: -1.
Las ejecuciones directas de Gemini también aceptan agents.defaults.models["google/<model>"].params.cachedContent (o el valor heredado cached_content) para reenviar un identificador cachedContents/... nativo del proveedor; los aciertos de caché de Gemini se muestran 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

El OAuth de Gemini CLI 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 use una cuenta no crítica si decide continuar.

El OAuth de Gemini CLI se distribuye como parte del Plugin incluido google.

Instalar Gemini CLI

brew
npm

brew install gemini-cli

npm install -g @google/gemini-cli

Activar el Plugin

openclaw plugins enable google

Iniciar sesión

openclaw models auth login --provider google-gemini-cli --set-default

Modelo predeterminado: google-gemini-cli/gemini-3-flash-preview. No se pega un identificador ni un secreto de cliente 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.

Establecer el proyecto (si es necesario)

Si las solicitudes fallan después de iniciar sesión, establezca 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 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 usan el identificador de proveedor canónico zai/*.
- zai-api-key detecta automáticamente el endpoint de Z.AI correspondiente; zai-coding-global, zai-coding-cn, zai-global y zai-cn fuerzan una interfaz 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 proveedores incluidos

Proveedor	Id	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-5-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	`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`
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.5` / `xiaomi-token-plan/mimo-v2.5-pro`

Particularidades que conviene conocer

OpenRouter

Aplica sus encabezados de atribución de aplicaciones y los marcadores cache_control de Anthropic únicamente en rutas openrouter.ai verificadas. Las referencias de DeepSeek, Moonshot y ZAI pueden usar TTL de caché para el almacenamiento en caché de prompts gestionado por OpenRouter, pero no reciben marcadores de caché de Anthropic. Como ruta compatible con OpenAI de tipo proxy, omite el modelado exclusivo de OpenAI nativo (serviceTier, store de Responses, sugerencias de caché de prompts y compatibilidad de razonamiento de OpenAI). Las referencias basadas en Gemini conservan únicamente el saneamiento de firmas de pensamiento de Gemini mediante proxy.

Kilo Gateway

Las referencias basadas en Gemini siguen la misma ruta de saneamiento de Gemini mediante proxy; kilocode/kilo-auto/balanced y otras referencias sin compatibilidad con razonamiento mediante proxy omiten la inyección de razonamiento del proxy.

MiniMax

La incorporación mediante 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.

NVIDIA

Los identificadores de modelo utilizan un espacio de nombres nvidia/<vendor>/<model> (por ejemplo, nvidia/nvidia/nemotron-...); los selectores conservan la composición literal <provider>/<model-id>, mientras que la clave canónica enviada a la API mantiene un único prefijo.

xAI

Utiliza 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 seguro para la región. 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 desactiva mediante agents.defaults.models["xai/<model>"].params.tool_stream=false.

Proveedores mediante `models.providers` (URL personalizada/base)

Utilice models.providers (o models.json) para añadir proveedores personalizados o proxies compatibles con OpenAI/Anthropic. Muchos de los plugins de proveedor incluidos que aparecen a continuación ya publican un catálogo predeterminado. Utilice entradas models.providers.<id> explícitas solo cuando quiera sustituir la URL base, los encabezados o la lista de modelos predeterminados. Las rutas incluidas y conocidas por el catálogo obtienen sus capacidades compat del plugin de proveedor propietario. Un bloque de configuración compat sirve para un proveedor/modelo personalizado o una ruta api/baseUrl diferente cuyo contrato de endpoint se haya verificado; consulte la guía de capacidades de proveedores personalizados. Doctor elimina los valores heredados que simplemente repiten el catálogo y deja visibles los valores divergentes para que el operador los revise. Las comprobaciones de capacidades de modelos del Gateway también leen metadatos models.providers.<id>.models[] explícitos. Si un modelo personalizado o proxy acepta imágenes, establezca input: ["text", "image"] en ese modelo para que WebChat y las rutas de archivos adjuntos con origen en nodos pasen las imágenes como entradas nativas del modelo, en lugar de como referencias multimedia de solo texto. agents.defaults.models["provider/model"] controla los alias y los metadatos por modelo para los agentes. Por sí solo, no restringe las sustituciones ni registra un nuevo modelo de tiempo de ejecución. Para modelos de proveedores personalizados, añada también models.providers.<provider>.models[] con al menos el id correspondiente; utilice agents.defaults.modelPolicy.allow por separado cuando quiera imponer una restricción de sustitución.

Moonshot AI (Kimi)

Instale @openclaw/moonshot-provider antes de la incorporación. Añada una entrada models.providers.moonshot explícita solo cuando necesite sustituir la URL base o los metadatos del modelo:

Proveedor: moonshot
Autenticación: MOONSHOT_API_KEY
Modelo de ejemplo: moonshot/kimi-k3
CLI: openclaw onboard --auth-choice moonshot-api-key o openclaw onboard --auth-choice moonshot-api-key-cn

Identificadores de modelos Kimi:

moonshot/kimi-k2.6
moonshot/kimi-k3
moonshot/kimi-k2.7-code
moonshot/kimi-k2.7-code-highspeed
moonshot/kimi-k2.5

{
  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) para ver la guía de configuración completa.

Kimi Coding

Kimi Coding utiliza el endpoint compatible con Anthropic de Moonshot AI:

Proveedor: kimi
Autenticación: KIMI_API_KEY
Kimi K3: kimi/k3 (256K) o kimi/k3[1m] (plan de 1M)
Kimi Code: kimi/kimi-for-coding
Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-for-coding" } },
  },
}

Los kimi/kimi-code y kimi/k2p5 heredados siguen aceptándose como identificadores de modelo 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

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

La incorporación utiliza 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 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.

Modelos estándar
Modelos de programación (volcengine-plan)

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

BytePlus (internacional)

BytePlus ARK proporciona acceso a los mismos modelos que Volcano Engine para usuarios internacionales.

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

{
  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 prioriza las filas byteplus/* y 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.

Modelos estándar
Modelos de programación (byteplus-plan)

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/kimi-k2.5
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-M3
CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M3", name: "MiniMax M3" }],
      },
    },
  },
}

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 para obtener información sobre la configuración, las opciones de modelos y fragmentos de configuración.

En la ruta de transmisión 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 convierte 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 al Plugin MiniMax-VL-01 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):

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

OpenClaw utiliza los elementos nativos /api/v1/models y /api/v1/models/load de LM Studio para el descubrimiento y la carga automática, con /v1/chat/completions para la inferencia de forma predeterminada. Si desea que la carga JIT, el TTL y la expulsión automática de LM Studio administren el ciclo de vida del modelo, establezca models.providers.lmstudio.params.preload: false. Consulte /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 se requiere ninguna (servidor local)
Modelo de ejemplo: ollama/llama3.3
Instalación: https://ollama.com/download

# Instale Ollama y, a continuación, descargue un modelo:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

Ollama se detecta localmente en http://127.0.0.1:11434 cuando se habilita 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 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 el descubrimiento automático localmente (cualquier valor funciona si el servidor no exige autenticación):

export VLLM_API_KEY="vllm-local"

A continuación, establezca un modelo (sustitúyalo por uno de los identificadores devueltos por /v1/models):

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

Consulte /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 el descubrimiento automático localmente (cualquier valor funciona si el servidor no exige autenticación):

export SGLANG_API_KEY="sglang-local"

A continuación, establezca un modelo (sustitúyalo por uno de los identificadores devueltos por /v1/models):

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

Consulte /providers/sglang para obtener más información.

Proxies locales (LM Studio, vLLM, LiteLLM, etc.)

Ejemplo (compatible con OpenAI):

{
  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,
          },
        ],
      },
    },
  },
}

Campos opcionales predeterminados

Para proveedores personalizados, reasoning, input, cost, contextWindow y maxTokens son opcionales. Si 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.

Reglas de adaptación de rutas de proxy

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 de tipo proxy compatibles con OpenAI también omiten la adaptació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 adaptación de cargas útiles para la compatibilidad de razonamiento de OpenAI y sin encabezados ocultos de atribución de OpenClaw.
Para 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 en el cuerpo de la solicitud saliente.
Para los controles de plantillas 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.<id>.timeoutSeconds. Esto amplía el procesamiento de las solicitudes HTTP de modelos del proveedor, incluida la conexión, los encabezados, la transmisión del cuerpo y la cancelación total de la recuperación protegida, 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 inferior, aumente también ese límite; los tiempos de espera del proveedor no pueden prolongar toda la ejecución.
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 el 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 y de metadatos, así como puertos diferentes, siguen requiriendo la habilitación explícita de models.providers.<id>.request.allowPrivateNetwork: true. Establezca models.providers.<id>.request.allowPrivateNetwork: false para desactivar 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 reemplazando 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 los encabezados beta implícitos de Anthropic, como claude-code-20250219, interleaved-thinking-2025-05-14 y los marcadores de OAuth, para que los proxies personalizados compatibles con Anthropic no rechacen indicadores beta no compatibles. Establezca models.providers.<id>.headers["anthropic-beta"] explícitamente si el proxy necesita funciones beta específicas.

Ejemplos de CLI

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

Consulte también: Configuración para ver ejemplos completos de configuración.

Temas relacionados

Referencia de configuración - claves de configuración de modelos
Conmutación por error de modelos - cadenas de respaldo y comportamiento de reintento
Modelos - configuración y alias de modelos
Proveedores - guías de configuración de cada proveedor

Overview

Concepts and configuration

Providers

Proveedores de modelos

Reglas rápidas

Configurar proveedores en la interfaz de control

Comportamiento propiedad del plugin del proveedor

Rotación de claves de API

Plugins oficiales de proveedores

OpenAI

Anthropic

OAuth de OpenAI ChatGPT/Codex

Otras opciones alojadas de tipo suscripción

MiniMax

Qwen Cloud

Z.AI (GLM)

OpenCode

Google Gemini (clave de API)

Google Vertex y Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Otros Plugins de proveedores incluidos

Particularidades que conviene conocer

Proveedores mediante `models.providers` (URL personalizada/base)

Moonshot AI (Kimi)

Kimi Coding

Volcano Engine (Doubao)

BytePlus (internacional)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

Proxies locales (LM Studio, vLLM, LiteLLM, etc.)

Ejemplos de CLI

Temas relacionados

​Reglas rápidas

​Configurar proveedores en la interfaz de control

​Comportamiento propiedad del plugin del proveedor

​Rotación de claves de API

​Plugins oficiales de proveedores

​OpenAI

​Anthropic

​OAuth de OpenAI ChatGPT/Codex

​Otras opciones alojadas de tipo suscripción

MiniMax

Qwen Cloud

Z.AI (GLM)

​OpenCode

​Google Gemini (clave de API)

​Google Vertex y Gemini CLI

​Z.AI (GLM)

​Vercel AI Gateway

​Otros Plugins de proveedores incluidos

​Particularidades que conviene conocer

​Proveedores mediante models.providers (URL personalizada/base)

​Moonshot AI (Kimi)

​Kimi Coding

​Volcano Engine (Doubao)

​BytePlus (internacional)

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

​Proxies locales (LM Studio, vLLM, LiteLLM, etc.)

​Ejemplos de CLI

​Temas relacionados

Reglas rápidas

Configurar proveedores en la interfaz de control

Comportamiento propiedad del plugin del proveedor

Rotación de claves de API

Plugins oficiales de proveedores

OpenAI

Anthropic

OAuth de OpenAI ChatGPT/Codex

Otras opciones alojadas de tipo suscripción

OpenCode

Google Gemini (clave de API)

Google Vertex y Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Otros Plugins de proveedores incluidos

Particularidades que conviene conocer

Proveedores mediante `models.providers` (URL personalizada/base)

Moonshot AI (Kimi)

Kimi Coding

Volcano Engine (Doubao)

BytePlus (internacional)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

Proxies locales (LM Studio, vLLM, LiteLLM, etc.)

Ejemplos de CLI

Temas relacionados