Saltar al contenido principal

​
MiniMax

El proveedor MiniMax de OpenClaw usa por defecto MiniMax M2.7. MiniMax también proporciona:
  • Síntesis de voz integrada mediante T2A v2
  • Comprensión de imágenes integrada mediante MiniMax-VL-01
  • Generación de música integrada mediante music-2.5+
  • web_search integrado mediante la API de búsqueda Coding Plan de MiniMax
Separación de proveedores:
Provider IDAuthCapabilities
minimaxClave de APITexto, generación de imágenes, comprensión de imágenes, speech, búsqueda web
minimax-portalOAuthTexto, generación de imágenes, comprensión de imágenes

​
Línea de modelos

ModelTypeDescription
MiniMax-M2.7Chat (reasoning)Modelo de razonamiento alojado predeterminado
MiniMax-M2.7-highspeedChat (reasoning)Nivel de razonamiento M2.7 más rápido
MiniMax-VL-01VisionModelo de comprensión de imágenes
image-01Image generationTexto a imagen y edición de imagen a imagen
music-2.5+Music generationModelo de música predeterminado
music-2.5Music generationNivel anterior de generación de música
music-2.0Music generationNivel heredado de generación de música
MiniMax-Hailuo-2.3Video generationFlujos de texto a video y de referencia de imagen

​
Primeros pasos

Elige tu método de autenticación preferido y sigue los pasos de configuración.
Ideal para: configuración rápida con MiniMax Coding Plan mediante OAuth, sin necesidad de clave de API.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Esto autentica contra api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
Las configuraciones con OAuth usan el id de proveedor minimax-portal. Las referencias de modelo siguen la forma minimax-portal/MiniMax-M2.7.
Enlace de referidos para MiniMax Coding Plan (10% de descuento): MiniMax Coding Plan

​
Configurar mediante openclaw configure

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

Launch the wizard

openclaw configure
2

Select Model/auth

Elige Model/auth en el menú.
3

Choose a MiniMax auth option

Elige una de las opciones disponibles de MiniMax:
Auth choiceDescription
minimax-global-oauthOAuth internacional (Coding Plan)
minimax-cn-oauthOAuth de China (Coding Plan)
minimax-global-apiClave de API internacional
minimax-cn-apiClave de API de China
4

Pick your default model

Selecciona tu modelo predeterminado cuando se te solicite.

​
Capacidades

​
Generación de imágenes

El Plugin de MiniMax registra el modelo image-01 para la herramienta image_generate. Admite:
  • 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
  • Hasta 9 imágenes de salida por solicitud
  • Hasta 1 imagen de referencia por solicitud de edición
  • Relaciones de aspecto compatibles: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
Para usar MiniMax para generación de imágenes, establécelo como proveedor de generación de imágenes: 
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
El plugin usa la misma autenticación MINIMAX_API_KEY u OAuth que los modelos de texto. No se necesita configuración adicional si MiniMax ya está configurado. Tanto minimax como minimax-portal registran image_generate con el mismo modelo image-01. Las configuraciones con clave de API usan MINIMAX_API_KEY; las configuraciones con OAuth pueden usar en su lugar la ruta de autenticación integrada minimax-portal. Cuando la incorporación o la configuración con clave de API escribe entradas explícitas models.providers.minimax, OpenClaw materializa MiniMax-M2.7 y MiniMax-M2.7-highspeed con input: ["text", "image"]. El catálogo de texto integrado de MiniMax en sí mismo sigue siendo metadatos solo de texto hasta que exista esa configuración explícita del proveedor. La comprensión de imágenes se expone por separado a través del proveedor multimedia MiniMax-VL-01 propiedad del plugin.
Consulta Generación de imágenes para ver parámetros compartidos de herramientas, selección de proveedor y comportamiento de failover.

​
Generación de música

El plugin minimax integrado también registra la generación de música mediante la herramienta compartida music_generate.
  • Modelo de música predeterminado: minimax/music-2.5+
  • También admite minimax/music-2.5 y minimax/music-2.0
  • Controles del prompt: lyrics, instrumental, durationSeconds
  • Formato de salida: mp3
  • Las ejecuciones con respaldo de sesión se desacoplan mediante el flujo compartido de tarea/estado, incluido action: "status"
Para usar MiniMax como proveedor de música predeterminado: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.5+",
      },
    },
  },
}
Consulta Generación de música para ver parámetros compartidos de herramientas, selección de proveedor y comportamiento de failover.

​
Generación de video

El plugin minimax integrado también registra la generación de video mediante la herramienta compartida video_generate.
  • Modelo de video predeterminado: minimax/MiniMax-Hailuo-2.3
  • Modos: texto a video y flujos de referencia de una sola imagen
  • Admite aspectRatio y resolution
Para usar MiniMax como proveedor de video predeterminado: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Consulta Generación de video para ver parámetros compartidos de herramientas, selección de proveedor y comportamiento de failover.

​
Comprensión de imágenes

El plugin MiniMax registra la comprensión de imágenes por separado del catálogo de texto:
Provider IDDefault image model
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Por eso el enrutamiento automático de multimedia puede usar la comprensión de imágenes de MiniMax incluso cuando el catálogo integrado del proveedor de texto todavía muestra referencias de chat M2.7 solo de texto.

​
Búsqueda web

El plugin MiniMax también registra web_search mediante la API de búsqueda Coding Plan de MiniMax.
  • Id del proveedor: minimax
  • Resultados estructurados: títulos, URL, fragmentos, consultas relacionadas
  • Variable de entorno preferida: MINIMAX_CODE_PLAN_KEY
  • Alias de entorno aceptado: MINIMAX_CODING_API_KEY
  • Fallback de compatibilidad: MINIMAX_API_KEY cuando ya apunta a un token de coding-plan
  • Reutilización de región: plugins.entries.minimax.config.webSearch.region, luego MINIMAX_API_HOST, y después las URL base del proveedor MiniMax
  • La búsqueda se mantiene en el id de proveedor minimax; la configuración OAuth CN/global aún puede dirigir indirectamente la región mediante models.providers.minimax-portal.baseUrl
La configuración vive en plugins.entries.minimax.config.webSearch.*.
Consulta MiniMax Search para ver la configuración y el uso completos de la búsqueda web.

​
Configuración avanzada

OptionDescription
models.providers.minimax.baseUrlPrefiere https://api.minimax.io/anthropic (compatible con Anthropic); https://api.minimax.io/v1 es opcional para payloads compatibles con OpenAI
models.providers.minimax.apiPrefiere anthropic-messages; openai-completions es opcional para payloads compatibles con OpenAI
models.providers.minimax.apiKeyClave de API de MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsDefine id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsAlias de modelos que quieres en la allowlist
models.modeMantén merge si quieres agregar MiniMax junto con los integrados
En api: "anthropic-messages", OpenClaw inyecta thinking: { type: "disabled" } a menos que thinking ya esté configurado explícitamente en params/config.Esto evita que el endpoint de streaming de MiniMax emita reasoning_content en fragmentos delta con estilo OpenAI, lo que filtraría razonamiento interno a la salida visible.
/fast on o params.fastMode: true reescribe MiniMax-M2.7 a MiniMax-M2.7-highspeed en la ruta de stream compatible con Anthropic.
Ideal para: mantener como principal tu modelo más potente de última generación y usar MiniMax M2.7 como fallback. El ejemplo siguiente usa Opus como principal concreto; cámbialo por tu modelo principal de última generación 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"],
      },
    },
  },
}
  • API de uso de Coding Plan: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (requiere una clave de coding plan).
  • OpenClaw normaliza el uso de coding-plan de MiniMax al mismo formato de visualización de % restante usado por otros proveedores. Los campos sin procesar de MiniMax usage_percent / usagePercent representan cuota restante, no cuota consumida, por lo que OpenClaw los invierte. Los campos basados en conteo tienen prioridad cuando están presentes.
  • Cuando la API devuelve model_remains, OpenClaw prefiere la entrada del modelo de chat, deriva la etiqueta de ventana a partir de start_time / end_time cuando es necesario e incluye el nombre del modelo seleccionado en la etiqueta del plan para que las ventanas de coding-plan sean más fáciles de distinguir.
  • Las instantáneas de uso tratan minimax, minimax-cn y minimax-portal como la misma superficie de cuota de MiniMax, y priorizan el OAuth almacenado de MiniMax antes de recurrir a las variables de entorno de clave de Coding Plan.

​
Notas

  • Las referencias de modelo siguen la ruta de autenticación:
    • Configuración con clave de API: minimax/<model>
    • Configuración con OAuth: minimax-portal/<model>
  • Modelo de chat predeterminado: MiniMax-M2.7
  • Modelo de chat alternativo: MiniMax-M2.7-highspeed
  • La incorporación y la configuración directa con clave de API escriben definiciones explícitas de modelo con input: ["text", "image"] para ambas variantes de M2.7
  • El catálogo integrado del proveedor actualmente expone las referencias de chat como metadatos solo de texto hasta que exista una configuración explícita del proveedor MiniMax
  • Actualiza los valores de precios en models.json si necesitas un seguimiento exacto de costes
  • Usa openclaw models list para confirmar el id de proveedor actual y luego cambia con openclaw models set minimax/MiniMax-M2.7 o openclaw models set minimax-portal/MiniMax-M2.7
Enlace de referidos para MiniMax Coding Plan (10% de descuento): MiniMax Coding Plan
Consulta Proveedores de modelos para ver las reglas de proveedores.

​
Solución de problemas

Esto normalmente significa que el proveedor MiniMax no está configurado (no hay ninguna entrada de proveedor coincidente ni ninguna clave/env perfil de autenticación de MiniMax encontrada). Hay una corrección para esta detección en 2026.1.12. Soluciónalo de una de estas formas:
  • Actualiza a 2026.1.12 (o ejecuta desde la rama main del código fuente) y luego reinicia el Gateway.
  • Ejecuta openclaw configure y selecciona una opción de autenticación de MiniMax, o
  • Agrega manualmente el bloque coincidente models.providers.minimax o models.providers.minimax-portal, o
  • Establece MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN o un perfil de autenticación de MiniMax para que se pueda inyectar el proveedor correspondiente.
Asegúrate de que el id del modelo distingue entre mayúsculas y minúsculas:
  • Ruta con clave de API: minimax/MiniMax-M2.7 o minimax/MiniMax-M2.7-highspeed
  • Ruta con OAuth: minimax-portal/MiniMax-M2.7 o minimax-portal/MiniMax-M2.7-highspeed
Luego vuelve a comprobar con:
openclaw models list
Más ayuda: Solución de problemas y Preguntas frecuentes.

​
Relacionado

Selección de modelos

Elegir proveedores, referencias de modelos y comportamiento de failover.

Generación de imágenes

Parámetros compartidos de la herramienta de imágenes y selección de proveedor.

Generación de música

Parámetros compartidos de la herramienta de música y selección de proveedor.

Generación de video

Parámetros compartidos de la herramienta de video y selección de proveedor.

MiniMax Search

Configuración de búsqueda web mediante MiniMax Coding Plan.

Solución de problemas

Solución general de problemas y preguntas frecuentes.