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

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.

Rotación de claves de API

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.

{  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

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 se distribuye como parte del Plugin incluido google.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

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

Particularidades que conviene conocer

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.

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.

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.

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

Ejemplos de CLI

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw 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