Configuración de proveedores de modelos en OpenClaw

Configurar diferentes modelos de lenguaje para tus proyectos suele ser un proceso lento. Tienes que manejar múltiples API, formatos de respuesta distintos y configuraciones que cambian constantemente. OpenClaw simplifica esto para que te centres en construir y no en pelearte con la infraestructura.

Integrar un nuevo modelo no debería quitarte toda la mañana. Con esta guía verás cómo conectar tus proveedores favoritos y empezar a usarlos en pocos minutos.

Requisitos previos

• OpenClaw instalado en tu sistema.
• API keys de los proveedores que quieras usar (OpenAI, Anthropic, Google, etc.).
• Acceso a la CLI para ejecutar comandos de configuración.

Inicio rápido

La forma más rápida de empezar es usar los comandos de la CLI. OpenClaw utiliza el formato provider/model para identificar cada modelo.

1. Configura el acceso: Ejecuta openclaw onboard --auth-choice <tu-proveedor>.
2. Elige tu modelo: Usa openclaw models set <provider/model>.
3. Verifica la lista: Ejecuta openclaw models list para ver tus modelos disponibles.

Proveedores integrados (catálogo pi-ai)

Estos proveedores ya vienen preconfigurados. No necesitas tocar el archivo models.providers; solo configura la autenticación y elige un modelo.

OpenAI y Anthropic

Para OpenAI, usa la variable OPENAI_API_KEY. Para Anthropic, puedes usar ANTHROPIC_API_KEY o el comando claude setup-token.

Ejemplo de configuración en JSON para OpenAI:

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

Ejemplo para Anthropic:

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

Google Gemini y Vertex

Google ofrece varias opciones. Puedes usar Gemini con una API key o Vertex mediante ADC.

• Antigravity: Habilita el plugin con openclaw plugins enable google-antigravity-auth e inicia sesión con openclaw models auth login --provider google-antigravity --set-default.
• Gemini CLI: Habilita el plugin con openclaw plugins enable google-gemini-cli-auth.

Otros proveedores directos

• Z.AI (GLM): Usa ZAI_API_KEY. El CLI permite el comando openclaw onboard --auth-choice zai-api-key.
• Vercel AI Gateway: Usa AI_GATEWAY_API_KEY.
• Mistral: Usa MISTRAL_API_KEY.
• GitHub Copilot: Usa COPILOT_GITHUB_TOKEN.

Proveedores mediante models.providers (Custom)

Si necesitas usar proxies compatibles con OpenAI/Anthropic o proveedores específicos como Moonshot, usa la sección models.providers.

Moonshot AI (Kimi)

Moonshot utiliza endpoints compatibles con OpenAI. Configúralo así:

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

Ollama (Local)

Ollama funciona de forma local y OpenClaw lo detecta automáticamente en http://127.0.0.1:11434/v1.

1. Instala Ollama y descarga un modelo: ollama pull llama3.3.
2. Configura OpenClaw:

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

Proxies locales (LM Studio, vLLM)

Si usas herramientas como LM Studio, define el proveedor de forma manual:

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

Solución de problemas

• Error en Google Antigravity o Gemini CLI: Estos proveedores requieren que habilites sus plugins específicos antes de intentar el login. Usa openclaw plugins enable.
• Qwen OAuth no conecta: Verifica que el plugin qwen-portal-auth esté activo.
• Tokens no encontrados: El flujo de login de la CLI guarda los tokens en perfiles de autenticación en el host del Gateway. No intentes pegar manualmente IDs de cliente o secretos en openclaw.json.
• Configuración de modelos custom: Si omites valores como contextWindow o maxTokens, OpenClaw usará 200,000 y 8,192 por defecto.

Si necesitas ayuda personalizada para configurar tu entorno, utiliza el AI Setup Assistant.

Próximos pasos

• Conceptos: Selección de modelos
• Guía de configuración del Gateway
• Detalles del proveedor Qwen
• Configuración avanzada de Ollama