Proveedores de modelos

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

Reglas rápidas

Configurar proveedores en la interfaz de control

Abra Configuración → Proveedores de modelos en la interfaz de control para añadir, reemplazar o eliminar las claves de API de proveedores almacenadas en models.providers.<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 mediante el entorno siguen gestionándose mediante el entorno del proceso del Gateway.

Use Probar conexión para ejecutar un sondeo activo del proveedor y consultar la latencia o un error categorizado de autenticación, límite de frecuencia, facturación, tiempo de espera o respuesta. Un sondeo realiza una solicitud real al proveedor y puede consumir una pequeña cantidad de tokens. También se puede cerrar la sesión de los perfiles de OAuth y de tokens desde la tarjeta del proveedor.

La tarjeta Modelos predeterminados gestiona el modelo principal, los modelos de respaldo ordenados y el modelo de utilidad del catálogo de modelos configurado. Elija los modelos y, después, guárdelos juntos en las opciones existentes agents.defaults.model y agents.defaults.utilityModel. Para el modelo de utilidad, Automático deja la opción sin establecer y Desactivado almacena una cadena vacía para desactivar el enrutamiento de utilidad.

Comportamiento de proveedores gestionado por plugins

La mayor parte de la lógica específica de cada proveedor reside en los plugins de proveedores (registerProvider(...)), mientras que OpenClaw mantiene el bucle genérico de inferencia. Los plugins gestionan la incorporación, los catálogos de modelos, la asignación de variables de entorno de autenticación, la normalización del transporte y la configuración, la limpieza del esquema de herramientas, la clasificación de conmutación por error, la actualización de OAuth, los informes de uso, los perfiles de pensamiento/razonamiento y mucho más.

La lista completa de hooks del SDK de proveedores y los ejemplos de plugins incluidos se encuentra en Plugins de proveedores. 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 de proveedores oficiales

Los plugins de proveedores oficiales publican sus propias filas del catálogo de modelos. Estos proveedores no requieren entradas de modelo models.providers; active el plugin del proveedor, configure la autenticación y elija un modelo. Use models.providers solo para proveedores personalizados explícitos u opciones específicas de solicitud, como los tiempos de espera.

OpenAI

• Proveedor: openai
• Autenticación: OPENAI_API_KEY
• Rotación opcional: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, además de OPENCLAW_LIVE_OPENAI_KEY (reemplazo único)
• Valor predeterminado de una configuración nueva: openai/gpt-5.6; en la API directa, el identificador básico se resuelve como Sol.
• Modelos de ejemplo: openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
• Verifique la disponibilidad de la cuenta o del modelo con openclaw models list --provider openai si una instalación o clave de API específica se comporta de manera diferente.
• CLI: openclaw onboard --auth-choice openai-api-key
• El transporte predeterminado es auto; OpenClaw pasa la opción de transporte al entorno de ejecución compartido del modelo.
• Reemplácelo para cada modelo mediante agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" o "auto")
• El procesamiento prioritario de OpenAI se puede activar 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 dirigido a api.openai.com, no a proxies genéricos compatibles con OpenAI
• Las rutas nativas de OpenAI también conservan el store de Responses, las indicaciones de caché de prompts y la adaptación de la carga útil para la compatibilidad con el razonamiento de OpenAI; las rutas mediante proxy no lo hacen
• openai/gpt-5.3-codex-spark solo está disponible mediante OAuth de ChatGPT/Codex; las rutas de claves de API directas de OpenAI y de claves de API de Azure lo rechazan

{  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}

Si la organización de la API no ofrece GPT-5.6, establezca openai/gpt-5.5 explícitamente. La incorporación y la reautenticación normales conservan un modelo principal explícito existente; models auth login --set-default y models set son las vías de reemplazo intencionado.

Anthropic

• Proveedor: anthropic
• Autenticación: ANTHROPIC_API_KEY
• Rotación opcional: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, además de OPENCLAW_LIVE_ANTHROPIC_KEY (reemplazo único)
• Modelo de ejemplo: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Las solicitudes públicas directas de Anthropic admiten el conmutador compartido /fast y params.fastMode, incluido el tráfico autenticado mediante clave de API y OAuth enviado a api.anthropic.com; OpenClaw lo asigna a service_tier de Anthropic (auto frente a standard_only)
• La configuración preferida de la CLI de Claude mantiene la referencia del modelo canónica y selecciona el backend de la CLI por separado: anthropic/claude-opus-4-8 con agentRuntime.id: "claude-cli" específico del modelo. Las referencias heredadas claude-cli/claude-opus-4-7 siguen funcionando por compatibilidad.

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

OAuth de OpenAI ChatGPT/Codex

• Proveedor: openai
• Autenticación: OAuth (ChatGPT)
• Referencia nueva del arnés nativo del servidor de aplicaciones de Codex: openai/gpt-5.6-sol
• Documentación del arnés nativo del servidor de aplicaciones de Codex: arnés de Codex
• Referencias de modelos heredadas: codex/gpt-*
• Límite del Plugin: openai/* carga el Plugin de OpenAI; la política explícita del entorno de ejecución o la ruta efectiva propiedad del proveedor determina si se selecciona el Plugin nativo del servidor de aplicaciones de Codex.
• CLI: openclaw onboard --auth-choice openai o openclaw models auth login --provider openai
• El transporte de Responses de ChatGPT integrado en OpenClaw utiliza de forma predeterminada auto (primero WebSocket, con SSE como alternativa).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier y params.fastMode son ajustes de solicitud integrada definidos explícitamente. Mantienen la selección implícita del entorno de ejecución en OpenClaw; Codex nativo controla el transporte de su servidor de aplicaciones y el nivel de servicio.
• Los encabezados ocultos de atribución de OpenClaw (originator, version, User-Agent) solo se adjuntan al tráfico de Codex nativo dirigido a chatgpt.com/backend-api, no a proxies genéricos compatibles con OpenAI
• El conmutador compartido /fast sigue disponible como control del entorno de ejecución; es distinto de los parámetros de modelo definidos explícitamente.
• El catálogo nativo de Codex puede exponer las referencias exactas openai/gpt-5.6-sol, openai/gpt-5.6-terra y openai/gpt-5.6-luna según el acceso de la cuenta. No aplica en el cliente el alias simple gpt-5.6 de la API directa.
• openai/gpt-5.5 utiliza el valor nativo contextWindow = 400000 del catálogo de Codex y el entorno de ejecución predeterminado contextTokens = 272000; cambie el límite del entorno de ejecución con models.providers.openai.models[].contextTokens
• Inicie sesión con la autenticación openai y utilice openai/gpt-5.6-sol para una configuración nueva respaldada por una suscripción. Seleccione openai/gpt-5.5 explícitamente si ese espacio de trabajo de Codex no expone GPT-5.6.
• Utilice el proveedor/modelo agentRuntime.id: "openclaw" para mantener una ruta que, de otro modo, sería apta en el entorno de ejecución integrado. Cuando el entorno de ejecución no esté definido o sea auto, solo una ruta oficial HTTPS exacta compatible con Responses/ChatGPT y sin modificaciones explícitas de la solicitud podrá seleccionar Codex implícitamente.
• Las referencias GPT heredadas de Codex son estado heredado, no una ruta de proveedor activa. Utilice referencias canónicas openai/* para la configuración de agentes nuevos y ejecute openclaw doctor --fix para migrar referencias de modelos Codex heredadas sin actualizar una selección explícita existente de openai/gpt-5.5.

{  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 basadas en 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 utiliza google/gemini-3.1-flash-preview se normaliza a google/gemini-3-flash-preview
• Alias: se acepta google/gemini-3.1-pro y se normaliza al identificador activo de la API Gemini de Google, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Razonamiento: /think adaptive utiliza el razonamiento dinámico de Google. Gemini 3/3.1 omite un thinkingLevel fijo; Gemini 2.5 envía thinkingBudget: -1.
• Las ejecuciones directas de Gemini también aceptan agents.defaults.models["google/<model>"].params.cachedContent (o el valor heredado cached_content) para reenviar un identificador cachedContents/... nativo del proveedor; los aciertos de caché de Gemini se presentan como cacheRead de OpenClaw

Google Vertex y CLI de Gemini

• Proveedores: google-vertex, google-gemini-cli
• Autenticación: Vertex utiliza ADC de gcloud; la CLI de Gemini utiliza su flujo OAuth

OAuth de la CLI de Gemini 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

La CLI de Gemini utiliza stream-json de forma predeterminada. OpenClaw lee los mensajes del flujo del asistente y normaliza stats.cached en cacheRead; las sustituciones heredadas de --output-format json siguen leyendo el texto de respuesta de response.

Z.AI (GLM)

• Proveedor: zai
• Autenticación: ZAI_API_KEY
• Modelo de ejemplo: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Las referencias de modelos utilizan el identificador canónico de proveedor zai/*.
  • zai-api-key detecta automáticamente el endpoint correspondiente de Z.AI; zai-coding-global, zai-coding-cn, zai-global y zai-cn fuerzan una superficie específica

Gateway de IA de Vercel

• Proveedor: vercel-ai-gateway
• Autenticación: AI_GATEWAY_API_KEY
• Modelos de ejemplo: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Otros Plugins de proveedores incluidos

Particularidades que conviene conocer

Proveedores mediante models.providers (URL personalizada/base)

Use models.providers (o models.json) para añadir proveedores personalizados o proxies compatibles con OpenAI/Anthropic.

Muchos de los plugins de proveedores incluidos que aparecen a continuación ya publican un catálogo predeterminado. Use entradas models.providers.<id> explícitas únicamente cuando quiera sobrescribir la URL base, los encabezados o la lista de modelos predeterminados.

Las comprobaciones de capacidades de modelos del Gateway también leen los metadatos models.providers.<id>.models[] explícitos. Si un modelo personalizado o de proxy acepta imágenes, establezca input: ["text", "image"] en ese modelo para que WebChat y las rutas de archivos adjuntos originadas en nodos pasen las imágenes como entradas nativas del modelo en lugar de referencias multimedia de solo texto.

agents.defaults.models["provider/model"] solo controla la visibilidad de los modelos, los alias y los metadatos por modelo para los agentes. No registra por sí mismo un nuevo modelo de tiempo de ejecución. Para los modelos de proveedores personalizados, añada también models.providers.<provider>.models[] con al menos el id correspondiente.

Moonshot AI (Kimi)

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

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

Identificadores de modelos Kimi K2:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  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 usa el endpoint compatible con Anthropic de Moonshot AI:

• Proveedor: kimi
• Autenticación: KIMI_API_KEY
• Modelo de ejemplo: kimi/kimi-for-coding

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

Los valores heredados kimi/kimi-code y kimi/k2p5 siguen aceptándose como identificadores de modelos de compatibilidad y se normalizan al identificador de modelo estable de la API de Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) proporciona acceso a Doubao y otros modelos en China.

• Proveedor: volcengine (programación: volcengine-plan)
• Autenticación: VOLCANO_ENGINE_API_KEY
• Modelo de ejemplo: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

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

La incorporación usa de forma predeterminada la superficie de programación, pero el catálogo general volcengine/* se registra al mismo tiempo.

En los selectores de modelos de incorporación/configuración, la opción de autenticación de Volcengine da preferencia tanto a las filas volcengine/* como a las volcengine-plan/*. Si esos modelos aún no están cargados, OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío limitado al proveedor.

BytePlus (internacional)

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

• Proveedor: byteplus (programación: byteplus-plan)
• Autenticación: BYTEPLUS_API_KEY
• Modelo de ejemplo: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

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

La incorporación usa de forma predeterminada la interfaz de programación, pero el catálogo general byteplus/* se registra al mismo tiempo.

En los selectores de modelos de incorporación/configuración, la opción de autenticación de BytePlus da preferencia a las filas byteplus/* y byteplus-plan/*. Si esos modelos aún no están cargados, OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío limitado al proveedor.

Synthetic

Synthetic proporciona modelos compatibles con Anthropic mediante el proveedor synthetic:

• Proveedor: synthetic
• Autenticación: SYNTHETIC_API_KEY
• Modelo de ejemplo: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

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

MiniMax

MiniMax se configura mediante models.providers porque utiliza endpoints personalizados:

• OAuth de MiniMax (global): --auth-choice minimax-global-oauth
• OAuth de MiniMax (China): --auth-choice minimax-cn-oauth
• Clave de API de MiniMax (global): --auth-choice minimax-global-api
• Clave de API de MiniMax (China): --auth-choice minimax-cn-api
• Autenticación: MINIMAX_API_KEY para minimax; MINIMAX_OAUTH_TOKEN o MINIMAX_API_KEY para minimax-portal

Consulte /providers/minimax 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 a MiniMax-VL-01, propiedad del Plugin, en ambas rutas de autenticación de MiniMax
• La búsqueda web permanece en el identificador de proveedor minimax

LM Studio

LM Studio se distribuye como un Plugin de proveedor incluido que utiliza la API nativa:

• Proveedor: lmstudio
• Autenticación: LM_API_TOKEN
• URL base de inferencia predeterminada: http://localhost:1234/v1

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

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

OpenClaw utiliza los endpoints nativos /api/v1/models y /api/v1/models/load de LM Studio para la detección y la carga automática, con /v1/chat/completions para la inferencia de forma predeterminada. Si se desea que la carga JIT, el TTL y la expulsión automática de LM Studio gestionen el ciclo de vida del modelo, establezca models.providers.lmstudio.params.preload: false. Consulte /providers/lmstudio para obtener información sobre la configuración y la solución de problemas.

Ollama

Ollama se distribuye como un Plugin de proveedor incluido y utiliza la API nativa de Ollama:

• Proveedor: ollama
• Autenticación: no es necesaria (servidor local)
• Modelo de ejemplo: ollama/llama3.3
• Instalación: https://ollama.com/download

# 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 al habilitarlo mediante OLLAMA_API_KEY, y el Plugin de proveedor incluido añade Ollama directamente a openclaw onboard y al selector de modelos. Consulte /providers/ollama para obtener información sobre la incorporación, el modo local/en la nube y la configuración personalizada.

vLLM

vLLM se distribuye como un Plugin de proveedor incluido para servidores locales o autoalojados compatibles con OpenAI:

• Proveedor: vllm
• Autenticación: opcional (depende del servidor)
• URL base predeterminada: http://127.0.0.1:8000/v1

Para habilitar la detección automática localmente (cualquier valor funciona si el servidor no exige autenticación):

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 la detección automática 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.

Contenido relacionado

• Referencia de configuración - claves de configuración de modelos
• Conmutación por error de modelos - cadenas de reserva y comportamiento de reintentos
• Modelos - configuración y alias de modelos
• Proveedores - guías de configuración por proveedor