Proveedores de Modelos

Esta página cubre proveedores de LLM/modelos (no canales de chat como WhatsApp/Telegram).

Para reglas de selección de modelos, ver ''/concepts/models''.

Las referencias de modelos usan ''provider/model'' (ej., ''opencode/claude-opus-4-5'').

Si configuras ''agents.defaults.models'', se convierte en una lista blanca.

Ayudantes CLI: ''openclaw onboard'', ''openclaw models list'', ''openclaw models set <provider/model>''.

OpenClaw viene con el directorio pi‑ai. Estos proveedores no requieren

configuración de ''models.providers''; solo configura autenticación + selecciona un modelo.

#

- Proveedor: ''openai''

- Auth: ''OPENAI_API_KEY''

- Ejemplo de modelo: ''openai/gpt-5.2''

- CLI: ''openclaw onboard --auth-choice openai-api-key''

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

#

- Proveedor: ''anthropic''

- Auth: ''ANTHROPIC_API_KEY'' o ''claude setup-token''

- Ejemplo de modelo: ''anthropic/claude-opus-4-5''

- CLI: ''openclaw onboard --auth-choice token'' (pega el token de configuración) o ''openclaw models auth paste-token --provider anthropic''

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

#

- Proveedor: ''openai-codex''

- Auth: OAuth (ChatGPT)

- Ejemplo de modelo: ''openai-codex/gpt-5.2''

- CLI: ''openclaw onboard --auth-choice openai-codex'' o ''openclaw models auth login --provider openai-codex''

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

#

- Proveedor: ''opencode''

- Auth: ''OPENCODE_API_KEY'' (o ''OPENCODE_ZEN_API_KEY'')

- Ejemplo de modelo: ''opencode/claude-opus-4-5''

- CLI: ''openclaw onboard --auth-choice opencode-zen''

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

#

- Proveedor: ''google''

- Auth: ''GEMINI_API_KEY''

- Ejemplo de modelo: ''google/gemini-3-pro-preview''

- CLI: ''openclaw onboard --auth-choice gemini-api-key''

#

- Proveedores: ''google-vertex'', ''google-antigravity'', ''google-gemini-cli''

- Auth: Vertex usa gcloud ADC; Antigravity/Gemini CLI usan sus respectivos flujos de auth

- OAuth de Antigravity se proporciona como plugin incluido (''google-antigravity-auth'', deshabilitado por defecto).

- Habilitar: ''openclaw plugins enable google-antigravity-auth''

- Login: ''openclaw models auth login --provider google-antigravity --set-default''

- OAuth de Gemini CLI se proporciona como plugin incluido (''google-gemini-cli-auth'', deshabilitado por defecto).

- Habilitar: ''openclaw plugins enable google-gemini-cli-auth''

- Login: ''openclaw models auth login --provider google-gemini-cli --set-default''

- Nota: ''No'' pegas client IDs o secrets en ''openclaw.json''. El flujo de login CLI almacena

tokens en perfiles de auth en el host del gateway.

-

#

- Proveedor: ''zai''

- Auth: ''ZAI_API_KEY''

- Ejemplo de modelo: ''zai/glm-4.7''

- CLI: ''openclaw onboard --auth-choice zai-api-key''

- Alias: ''z.ai/*'' y ''z-ai/*'' se normalizan a ''zai/*''

#

- Proveedor: ''vercel-ai-gateway''

- Auth: ''AI_GATEWAY_API_KEY''

- Ejemplo de modelo: ''vercel-ai-gateway/anthropic/claude-opus-4.5''

- CLI: ''openclaw onboard --auth-choice ai-gateway-api-key''

#

- OpenRouter: ''openrouter'' (''OPENROUTER_API_KEY'')

- Ejemplo de modelo: ''openrouter/anthropic/claude-sonnet-4-5''

- xAI: ''xai'' (''XAI_API_KEY'')

- Groq: ''groq'' (''GROQ_API_KEY'')

- Cerebras: ''cerebras'' (''CEREBRAS_API_KEY'')

- Los modelos GLM en Cerebras usan IDs ''zai-glm-4.7'' y ''zai-glm-4.6''.

- URL base compatible con OpenAI: ''https://api.cerebras.ai/v1''.

- Mistral: ''mistral'' (''MISTRAL_API_KEY'')

- GitHub Copilot: ''github-copilot'' (''COPILOT_GITHUB_TOKEN'' / ''GH_TOKEN'' / ''GITHUB_TOKEN'')

Usa ''models.providers'' (o ''models.json'') para añadir proveedores ''personalizados'' o

proxies compatibles con OpenAI/Anthropic.

#

Moonshot usa un endpoint compatible con OpenAI, así que configúralo como proveedor personalizado:

- Proveedor: ''moonshot''

- Auth: ''MOONSHOT_API_KEY''

- Ejemplo de modelo: ''moonshot/kimi-k2.5''

IDs de Modelo Kimi K2:

- ''moonshot/kimi-k2.5''

- ''moonshot/kimi-k2-0905-preview''

- ''moonshot/kimi-k2-turbo-preview''

- ''moonshot/kimi-k2-thinking''

- ''moonshot/kimi-k2-thinking-turbo''

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.5", name: "Kimi K2.5" }],
      },
    },
  },
}

#

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

- Proveedor: ''kimi-coding''

- Auth: ''KIMI_API_KEY''

- Ejemplo de modelo: ''kimi-coding/k2p5''

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

#

Qwen proporciona acceso OAuth a Qwen Coder + Vision via flujo de código de dispositivo.

Habilita el plugin incluido, luego inicia sesión:

openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal --set-default

Referencias de modelos:

- ''qwen-portal/coder-model''

- ''qwen-portal/vision-model''

Ver ''/providers/qwen'' para detalles de configuración y notas.

#

Synthetic proporciona modelos compatibles con Anthropic detrás del proveedor ''synthetic'':

- Proveedor: ''synthetic''

- Auth: ''SYNTHETIC_API_KEY''

- Ejemplo de modelo: ''synthetic/hf:MiniMaxAI/MiniMax-M2.1''

- CLI: ''openclaw onboard --auth-choice synthetic-api-key''

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

#

MiniMax se configura via ''models.providers'' porque usa un endpoint personalizado:

- MiniMax (compatible con humano): ''--auth-choice minimax-api''

- Auth: ''MINIMAX_API_KEY''

Ver ''/providers/minimax'' para detalles de configuración, opciones de modelo y fragmentos de configuración.

#

Ollama es un runtime de LLM local que proporciona una API compatible con OpenAI:

- Proveedor: ''ollama''

- Auth: Ninguna (servidor local)

- Ejemplo de modelo: ''ollama/llama3.3''

- Instalación: https://ollama.ai

ollama pull llama3.3

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

Ollama se detecta automáticamente cuando corre localmente en ''http://127.0.0.1:11434/v1''. Ver ''/providers/ollama'' para recomendaciones de modelos y configuración personalizada.

#

Ejemplo (compatible con OpenAI):

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.1-gs32" },
      models: { "lmstudio/minimax-m2.1-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "LMSTUDIO_KEY",
        api: "openai-completions",
        models: [
          {
            id: "minimax-m2.1-gs32",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

Notas:

- Para proveedores personalizados, ''reasoning'', ''input'', ''cost'', ''contextWindow'', y ''maxTokens'' son opcionales.

Cuando se omiten, OpenClaw usa por defecto:

- ''reasoning: false''

- ''input: ["text"]''

- ''cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }''

- ''contextWindow: 200000''

- ''maxTokens: 8192''

- Recomendación: Configura valores explícitos que coincidan con los límites de tu agente/modelo.

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

Ver también: ''/gateway/configuration'' para ejemplos completos de configuración.