Configura MiniMax M2.1 en OpenClaw: Guía rápida

¿Alguna vez has sentido que configurar un nuevo proveedor de IA te quita más tiempo del que te ahorra? Integrar modelos potentes en tu flujo de trabajo no debería ser un proceso complicado ni lleno de fricciones técnicas.

Si buscas una alternativa sólida y eficiente, aquí tienes cómo configurar MiniMax en OpenClaw para aprovechar al máximo sus capacidades de texto e imagen.

MiniMax

El proveedor de MiniMax en OpenClaw utiliza por defecto MiniMax M2.7.

Alineación de modelos

MiniMax-M2.7: modelo de texto principal.
MiniMax-M2.7-highspeed: nivel de texto M2.7 más rápido.
image-01: modelo de generación de imágenes (generación y edición de imagen a imagen).

Generación de imágenes

El plugin de MiniMax registra el modelo image-01 para la herramienta image_generate. Soporta:

Generación de texto a imagen con control de relación de aspecto.
Edición de imagen a imagen (referencia de sujeto) con control de relación de aspecto.
Relaciones de aspecto soportadas: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9.

Para usar MiniMax en la generación de imágenes, configúralo como el proveedor de generación de imágenes:

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

El plugin utiliza la misma MINIMAX_API_KEY o autenticación OAuth que los modelos de texto. No necesitas configuración adicional si MiniMax ya está listo.

Elige una configuración

MiniMax OAuth (Coding Plan) - recomendado

Ideal para: una configuración rápida con el Coding Plan de MiniMax vía OAuth, sin necesidad de API key.

Activa el plugin de OAuth incluido y autentícate:

openclaw plugins enable minimax  # skip if already loaded.
openclaw gateway restart  # restart if gateway is already running
openclaw onboard --auth-choice minimax-portal

Se te pedirá que selecciones un endpoint:

Global - Usuarios internacionales (api.minimax.io)
CN - Usuarios en China (api.minimaxi.com)

Consulta el README del paquete del plugin MiniMax en el repositorio de OpenClaw para más detalles.

MiniMax M2.7 (API key)

Ideal para: usar MiniMax con una API compatible con Anthropic.

Configura a través de la CLI:

Ejecuta openclaw configure
Selecciona Model/auth
Elige una opción de autenticación de MiniMax

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

MiniMax M2.7 como fallback (ejemplo)

Ideal para: mantener tu modelo más fuerte de última generación como primario y usar MiniMax M2.7 como respaldo en caso de error. El siguiente ejemplo usa Opus como primario; cámbialo por tu modelo preferido.

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "primary" },
        "minimax/MiniMax-M2.7": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
    },
  },
}

Configura mediante `openclaw configure`

Usa el asistente de configuración interactivo para establecer MiniMax sin tener que editar el JSON manualmente:

Ejecuta openclaw configure.
Selecciona Model/auth.
Elige una opción de autenticación de MiniMax.
Selecciona tu modelo por defecto cuando se te solicite.

Opciones de configuración

models.providers.minimax.baseUrl: se prefiere https://api.minimax.io/anthropic (compatible con Anthropic); https://api.minimax.io/v1 es opcional para payloads compatibles con OpenAI.
models.providers.minimax.api: se prefiere anthropic-messages; openai-completions es opcional para payloads compatibles con OpenAI.
models.providers.minimax.apiKey: tu API key de MiniMax (MINIMAX_API_KEY).
models.providers.minimax.models: define id, name, reasoning, contextWindow, maxTokens, cost.
agents.defaults.models: alias para los modelos que quieras en la lista permitida.
models.mode: mantén merge si quieres añadir MiniMax junto a los modelos integrados.

Notas

Las referencias de modelos son minimax/<model>.
Modelo de texto por defecto: MiniMax-M2.7.
Modelo de texto alternativo: MiniMax-M2.7-highspeed.
API de uso del Coding Plan: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (requiere una clave de coding plan).
Actualiza los valores de precios en models.json si necesitas un seguimiento exacto de costes.
Enlace de referido para el MiniMax Coding Plan (10% de descuento): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
Consulta /concepts/model-providers para ver las reglas de proveedores.
Usa openclaw models list y openclaw models set minimax/MiniMax-M2.7 para cambiar de modelo.

Solución de problemas

”Unknown model: minimax/MiniMax-M2.7”

Esto normalmente significa que el proveedor de MiniMax no está configurado (no se encontró ninguna entrada de proveedor ni perfil de autenticación o clave de entorno de MiniMax). Existe una corrección para esta detección en la versión 2026.1.12. Para solucionarlo:

Actualiza a 2026.1.12 (o ejecuta desde la fuente main) y reinicia el Gateway.
Ejecuta openclaw configure y selecciona una opción de autenticación de MiniMax, o
Añade el bloque models.providers.minimax manualmente, o
Configura MINIMAX_API_KEY (o un perfil de autenticación de MiniMax) para que el proveedor pueda ser inyectado.

Asegúrate de que el ID del modelo respete las mayúsculas y minúsculas:

minimax/MiniMax-M2.7
minimax/MiniMax-M2.7-highspeed

Luego vuelve a verificar con:

openclaw models list

Pasos siguientes

AI Setup Assistant

OpenClaw Expert

Sigues atascado?

Si esta pagina no resolvio tu caso, pregunta a OpenClaw Expert para pasos concretos.