Saltar al contenido principal
El Plugin minimax incluido registra dos proveedores más cinco capacidades: chat, generación de imágenes, generación de música, generación de video, comprensión de imágenes, voz (T2A v2) y búsqueda web.
ID de proveedorAuthCapacidades
minimaxClave de APITexto, generación de imágenes, generación de música, generación de video, comprensión de imágenes, voz, búsqueda web
minimax-portalOAuthTexto, generación de imágenes, generación de música, generación de video, comprensión de imágenes, voz
Enlace de referido para MiniMax Coding Plan (10% de descuento): MiniMax Coding Plan

​
Catálogo integrado

ModeloTipoDescripción
MiniMax-M3Chat (razonamiento)Modelo de razonamiento alojado predeterminado
MiniMax-M2.7Chat (razonamiento)Modelo de razonamiento alojado anterior
MiniMax-M2.7-highspeedChat (razonamiento)Nivel de razonamiento M2.7 más rápido
MiniMax-VL-01VisiónModelo de comprensión de imágenes
image-01Generación de imágenesEdición de texto a imagen e imagen a imagen
music-2.6Generación de músicaModelo de música predeterminado
MiniMax-Hailuo-2.3Generación de videoFlujos de texto a video e imagen a video
Las referencias de modelo siguen la ruta de autenticación: minimax/<model> para configuraciones con clave de API, minimax-portal/<model> para configuraciones con OAuth.

​
Primeros pasos

Ideal para: configuración rápida con MiniMax Coding Plan mediante OAuth, sin requerir clave de API.
1

Ejecutar onboarding

openclaw onboard --auth-choice minimax-global-oauth
URL base del proveedor resultante: api.minimax.io.
2

Verificar que el modelo esté disponible

openclaw models list --provider minimax-portal
Las configuraciones con OAuth usan el ID de proveedor minimax-portal. Las referencias de modelo siguen el formato minimax-portal/MiniMax-M3.

​
Configurar mediante openclaw configure

1

Inicia el asistente

openclaw configure
2

Selecciona Modelo/autenticación

Elige Modelo/autenticación en el menú.
3

Elige una opción de autenticación de MiniMax

Opción de autenticaciónDescripción
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

Elige tu modelo predeterminado

Selecciona tu modelo predeterminado cuando se te solicite.

​
Capacidades

​
Generación de imágenes

El Plugin MiniMax registra el modelo image-01 para la herramienta image_generate tanto en minimax como en minimax-portal, reutilizando la misma autenticación MINIMAX_API_KEY u OAuth que los modelos de texto.
  • Generación de texto a imagen y edición de imagen a imagen (referencia de sujeto), ambas con control de relación de aspecto
  • Hasta 9 imágenes de salida por solicitud, 1 imagen de referencia por solicitud de edición
  • Relaciones de aspecto admitidas: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
La generación de imágenes siempre usa el endpoint de imagen dedicado de MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, ya que ese campo configura en su lugar la URL base compatible con chat/Anthropic. Define MINIMAX_API_HOST=https://api.minimaxi.com para enrutar la generación de imágenes a través del endpoint de CN; el endpoint global predeterminado es https://api.minimax.io.
Consulta Generación de imágenes para ver los parámetros compartidos de la herramienta, la selección de proveedor y el comportamiento de conmutación por error.

​
Texto a voz

El Plugin minimax incluido registra MiniMax T2A v2 como proveedor de voz para messages.tts.
  • Modelo TTS predeterminado: speech-2.8-hd
  • Voz predeterminada: English_expressive_narrator
  • Ids de modelos incluidos: speech-2.8-hd, speech-2.8-turbo, speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo, speech-01-hd, speech-01-turbo, speech-01-240228
  • Orden de resolución de autenticación: messages.tts.providers.minimax.apiKey, luego perfiles de autenticación OAuth/token de minimax-portal, luego claves de entorno Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), luego MINIMAX_API_KEY
  • Si no se configura ningún host de TTS, OpenClaw reutiliza el host OAuth configurado de minimax-portal y elimina sufijos de ruta compatibles con Anthropic como /anthropic
  • Los adjuntos de audio normales permanecen en MP3. Los destinos de notas de voz (Feishu, Telegram y otros canales que solicitan un adjunto compatible con notas de voz) se transcodifican de MP3 de MiniMax a Opus de 48 kHz con ffmpeg, porque, por ejemplo, la API de archivos de Feishu/Lark solo acepta file_type: "opus" para mensajes de audio nativos
  • MiniMax T2A acepta valores fraccionarios para speed y vol, pero pitch se envía como entero; OpenClaw trunca los valores fraccionarios de pitch antes de la solicitud a la API
ConfiguraciónVariable de entornoPredeterminadoDescripción
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHost de la API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdId del modelo TTS.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorId de voz usado para la salida de voz.
messages.tts.providers.minimax.speed1.0Velocidad de reproducción, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volumen, (0, 10].
messages.tts.providers.minimax.pitch0Desplazamiento de tono entero, -12..12.

​
Generación de música

El Plugin MiniMax incluido registra la generación de música mediante la herramienta compartida music_generate tanto para minimax como para minimax-portal.
  • Modelo de música predeterminado: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
  • También admite music-2.6-free, music-cover y music-cover-free
  • Controles de prompt: lyrics, instrumental
  • Formato de salida: mp3
  • Las ejecuciones respaldadas por sesión se desacoplan mediante el flujo compartido de tarea/estado, incluido action: "status"
{
  agents: {
    defaults: {
      musicGenerationModel: { primary: "minimax/music-2.6" },
    },
  },
}
Consulta Generación de música para ver los parámetros compartidos de la herramienta, la selección de proveedor y el comportamiento de conmutación por error.

​
Generación de video

El Plugin MiniMax incluido registra la generación de video mediante la herramienta compartida video_generate tanto para minimax como para minimax-portal.
  • Modelo de video predeterminado: minimax/MiniMax-Hailuo-2.3 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
  • También admite MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live e I2V-01
  • Modos: flujos de texto a video y de referencia de una sola imagen
  • Admite resolution (768P o 1080P en modelos Hailuo 2.3/02); aspectRatio no es compatible y se ignora
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },
    },
  },
}
Consulta Generación de video para ver los parámetros compartidos de herramientas, la selección de proveedores y el comportamiento de conmutación por error.

​
Comprensión de imágenes

El Plugin MiniMax registra la comprensión de imágenes por separado del catálogo de texto:
ID de proveedorModelo de imagen predeterminadoExtracción de texto de PDF
minimaxMiniMax-VL-01MiniMax-M2.7
minimax-portalMiniMax-VL-01MiniMax-M2.7
Por eso el enrutamiento automático de medios puede usar la comprensión de imágenes de MiniMax incluso cuando el catálogo de proveedor de texto incluido también contiene refs de chat compatibles con imágenes M3. La comprensión de PDF usa MiniMax-M2.7 solo para extracción de texto; MiniMax no registra una ruta de conversión de PDF a imagen.

​
Búsqueda web

El Plugin MiniMax también registra web_search mediante la API de búsqueda MiniMax Token Plan (/v1/coding_plan/search).
  • ID de proveedor: minimax
  • Resultados estructurados: títulos, URL, fragmentos, consultas relacionadas
  • Variable de entorno preferida: MINIMAX_CODE_PLAN_KEY
  • Alias de entorno aceptados: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
  • Respaldo de compatibilidad: MINIMAX_API_KEY cuando ya apunta a una credencial de token-plan
  • Reutilización de región: plugins.entries.minimax.config.webSearch.region, luego MINIMAX_API_HOST, luego las URL base del proveedor MiniMax
  • La búsqueda permanece en el ID de proveedor minimax; la configuración OAuth CN/global puede dirigir la región indirectamente mediante models.providers.minimax-portal.baseUrl y puede proporcionar autenticación bearer mediante MINIMAX_OAUTH_TOKEN
La configuración se encuentra en plugins.entries.minimax.config.webSearch.*.
Consulta Búsqueda MiniMax para ver la configuración y el uso completos de la búsqueda web.

​
Configuración avanzada

OpciónDescripción
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.modelsAsigna alias a los modelos que quieres en la lista de permitidos
models.modeMantén merge si quieres agregar MiniMax junto con los integrados
En api: "anthropic-messages", OpenClaw inyecta thinking: { type: "disabled" } para modelos MiniMax M2.x, a menos que un wrapper anterior ya haya establecido el campo thinking en el payload. Esto evita que el endpoint de streaming de M2.x emita reasoning_content en fragmentos delta de estilo OpenAI, lo que filtraría razonamiento interno en la salida visible.MiniMax-M3 (y M3.x) está exento: M3 devuelve un array content vacío con stop_reason: "end_turn" cuando el razonamiento está deshabilitado, por lo que OpenClaw elimina el valor predeterminado deshabilitado implícito para M3 y, cuando se establece un nivel de razonamiento, fuerza thinking: { type: "adaptive" } en su lugar.Niveles de razonamiento disponibles por familia de modelos:
Familia de modelosNivelesPredeterminado
MiniMax-M3off, adaptiveadaptive
MiniMax-M2.xoff, minimal, low, medium, highoff
/fast on o params.fastMode: true reescribe MiniMax-M2.7 como MiniMax-M2.7-highspeed en la ruta de streaming compatible con Anthropic (api: "anthropic-messages", proveedor minimax o minimax-portal).
Ideal para: mantener tu modelo de última generación más potente como principal y conmutar por error a MiniMax M2.7. 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/token_plan/remains o https://api.minimax.io/v1/token_plan/remains (requiere una clave de coding plan).
  • El sondeo de uso deriva el host de models.providers.minimax-portal.baseUrl o models.providers.minimax.baseUrl cuando están configurados, por lo que las configuraciones globales que usan https://api.minimax.io/anthropic sondean api.minimax.io. Las URL base faltantes o mal formadas mantienen el respaldo CN por compatibilidad.
  • OpenClaw normaliza el uso de MiniMax coding-plan a la misma visualización de % left usada por otros proveedores. Los campos sin procesar usage_percent / usagePercent de MiniMax son 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, minimax-portal y minimax-portal-cn como la misma superficie de cuota de MiniMax, y prefieren el OAuth de MiniMax almacenado antes de recurrir a variables de entorno de clave de Coding Plan.

​
Notas

  • Modelo de chat predeterminado: MiniMax-M3. Modelos de chat alternativos: MiniMax-M2.7, MiniMax-M2.7-highspeed
  • La incorporación y la configuración directa con clave de API escriben definiciones de modelos para M3 y ambas variantes M2.7
  • La comprensión de imágenes usa el proveedor de medios MiniMax-VL-01 propiedad del Plugin
  • Actualiza los valores de precios en models.json si necesitas seguimiento exacto de costos
  • Usa openclaw models list para confirmar el ID de proveedor actual y luego cambia con openclaw models set minimax/MiniMax-M3 o openclaw models set minimax-portal/MiniMax-M3
Consulta Proveedores de modelos para ver las reglas de proveedores.

​
Solución de problemas

Esto suele significar que el proveedor MiniMax no está configurado (no se encontró ninguna entrada de proveedor coincidente ni ningún perfil de autenticación/clave de entorno de MiniMax). Corrígelo de la siguiente manera:
  • Ejecutando openclaw configure y seleccionando una opción de autenticación de MiniMax, o
  • Agregando manualmente el bloque models.providers.minimax o models.providers.minimax-portal correspondiente, o
  • Estableciendo 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 distinga mayúsculas y minúsculas:
  • Ruta con clave de API: minimax/MiniMax-M3, minimax/MiniMax-M2.7 o minimax/MiniMax-M2.7-highspeed
  • Ruta OAuth: minimax-portal/MiniMax-M3, 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, refs de modelos y comportamiento de conmutación por error.

Generación de imágenes

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

Generación de música

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

Generación de video

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

Búsqueda MiniMax

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

Solución de problemas

Solución de problemas general y preguntas frecuentes.