OpenClawSkills
GitHub
Proveedores • 5 min de lectura

MiniMax

Use MiniMax M2.1 in OpenClaw

MiniMax is an AI company that builds the M2/M2.1 model family. The current coding-focused release is MiniMax M2.1 (December 23, 2025), built for real-world complex tasks.

Source: ''MiniMax M2.1 release note''

Tutorial.step

Model overview (M2.1)

MiniMax highlights these improvements in M2.1:

- Stronger multi-language coding (Rust, Java, Go, C++, Kotlin, Objective-C, TS/JS).

- Better web/app development and aesthetic output quality (including native mobile).

- Improved composite instruction handling for office-style workflows, building on interleaved thinking and integrated constraint execution.

- More concise responses with lower token usage and faster iteration loops.

- Stronger tool/agent framework compatibility and context management (Claude Code, Droid/Factory AI, Cline, Kilo Code, Roo Code, BlackBox).

- Higher-quality dialogue and technical writing outputs.

Tutorial.step

MiniMax M2.1 vs MiniMax M2.1 Lightning

- Speed: Lightning is the "fast" variant in MiniMax's pricing docs.

- Cost: Pricing shows the same input cost, but Lightning has higher output cost.

- Coding plan routing: The Lightning back-end isn't directly available on the MiniMax coding plan. MiniMax auto-routes most requests to Lightning, but falls back to the regular M2.1 back-end during traffic spikes.

Tutorial.step

Choose a setup

#

Tutorial.step

MiniMax M2.1 (OAuth)

Mejor para: usuarios de MiniMax con cuenta de suscripción.

Habilita el plugin OAuth incluido y autentica:

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

Se te pedirá seleccionar un endpoint:

- ''Global'' - Usuarios internacionales (''api.minimax.io'')

- ''CN'' - Usuarios en China (''api.minimaxi.com'')

Ver ''README del plugin OAuth de MiniMax'' para detalles.

#

Tutorial.step

MiniMax M2.1 (clave API)

Mejor para: MiniMax hospedado con API compatible con Anthropic.

Configura vía CLI:

- Ejecuta ''openclaw configure''

- Selecciona Model/auth

- Elige MiniMax M2.1

Json5
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.1" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.1",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 15, output: 60, cacheRead: 2, cacheWrite: 10 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

#

Tutorial.step

MiniMax M2.1 como fallback (Opus primario)

Mejor para: mantener Opus 4.5 como primario, fallar a MiniMax M2.1.

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

#

Tutorial.step

Opcional: Local vía LM Studio (manual)

Mejor para: inferencia local con LM Studio.

Hemos visto resultados fuertes con MiniMax M2.1 en hardware potente (ej. un desktop/servidor) usando el servidor local de LM Studio.

Configura manualmente vía ''openclaw.json'':

Json5
{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.1-gs32" },
      models: { "lmstudio/minimax-m2.1-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      lmstudio: {
        baseUrl: "http://127.0.0.1:1234/v1",
        apiKey: "lmstudio",
        api: "openai-responses",
        models: [
          {
            id: "minimax-m2.1-gs32",
            name: "MiniMax M2.1 GS32",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}
Tutorial.step

Configurar vía `openclaw configure`

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

1. Ejecuta ''openclaw configure''.

2. Selecciona Model/auth.

3. Elige MiniMax M2.1.

4. Elige tu modelo predeterminado cuando se te pregunte.

Tutorial.step

Opciones de configuración

- ''models.providers.minimax.baseUrl'': prefiere ''https://api.minimax.io/anthropic'' (compatible Anthropic); ''https://api.minimax.io/v1'' es opcional para payloads compatibles OpenAI.

- ''models.providers.minimax.api'': prefiere ''anthropic-messages''; ''openai-completions'' es opcional para payloads compatibles OpenAI.

- ''models.providers.minimax.apiKey'': clave API de MiniMax (''MINIMAX_API_KEY'').

- ''models.providers.minimax.models'': define ''id'', ''name'', ''reasoning'', ''contextWindow'', ''maxTokens'', ''cost''.

- ''agents.defaults.models'': alias modelos que quieres en la allowlist.

- ''models.mode'': mantén ''merge'' si quieres agregar MiniMax junto a los incorporados.

Tutorial.step

Notas

- Las refs de modelo son ''minimax/<model>''.

- API de uso del Coding Plan: ''https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains'' (requiere una clave de coding plan).

- Actualiza valores de precios en ''models.json'' si necesitas tracking de costos exacto.

- Enlace de referido para MiniMax Coding Plan (10% descuento): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link

- Ver ''/concepts/model-providers'' para reglas de proveedores.

- Usa ''openclaw models list'' y ''openclaw models set minimax/MiniMax-M2.1'' para cambiar.

Tutorial.step

Solución de Problemas

#

Tutorial.step

"Unknown model: minimax/MiniMax-M2.1"

Esto usualmente significa que el proveedor MiniMax no está configurado (sin entrada de proveedor y sin perfil de auth/clave env de MiniMax encontrada). Una corrección para esta detección está en 2026.1.12 (no liberado al momento de escribir). Corrige:

- Actualizando a ''2026.1.12'' (o ejecuta desde source ''main''), luego reinicia el gateway.

- Ejecutando ''openclaw configure'' y seleccionando ''MiniMax M2.1'', o

- Agregando el bloque ''models.providers.minimax'' manualmente, o

- Estableciendo ''MINIMAX_API_KEY'' (o un perfil de auth MiniMax) para que el proveedor pueda ser inyectado.

Asegúrate que el id del modelo es sensible a mayúsculas:

- ''minimax/MiniMax-M2.1''

- ''minimax/MiniMax-M2.1-lightning''

Luego verifica con:

Bash
openclaw models list