MiniMax

El plugin minimax incluido registra dos proveedores y cinco capacidades: chat, generación de imágenes, generación de música, generación de vídeo, comprensión de imágenes, voz (T2A v2) y búsqueda web.

ID del proveedor	Autenticación	Capacidades
`minimax`	Clave de API	Texto, generación de imágenes, generación de música, generación de vídeo, comprensión de imágenes, voz, búsqueda web
`minimax-portal`	OAuth	Texto, generación de imágenes, generación de música, generación de vídeo, comprensión de imágenes, voz

Enlace de referido para MiniMax Coding Plan (10 % de descuento): MiniMax Coding Plan

Catálogo integrado

Modelo	Tipo	Descripción
`MiniMax-M3`	Chat (razonamiento)	Modelo de razonamiento alojado predeterminado
`MiniMax-M2.7`	Chat (razonamiento)	Modelo de razonamiento alojado anterior
`MiniMax-M2.7-highspeed`	Chat (razonamiento)	Nivel de razonamiento M2.7 más rápido
`MiniMax-VL-01`	Visión	Modelo de comprensión de imágenes
`image-01`	Generación de imágenes	Generación de texto a imagen y edición de imagen a imagen
`music-2.6`	Generación de música	Modelo de música predeterminado
`MiniMax-Hailuo-2.3`	Generación de vídeo	Flujos de texto a vídeo y de imagen a vídeo

Las referencias de modelos siguen la ruta de autenticación: minimax/<model> para configuraciones con clave de API y minimax-portal/<model> para configuraciones con OAuth.

Primeros pasos

OAuth (Coding Plan)
Clave de API

Recomendado para: configuración rápida con MiniMax Coding Plan mediante OAuth, sin necesidad de una clave de API.

Internacional
China

Ejecutar la incorporación

openclaw onboard --auth-choice minimax-global-oauth

URL base resultante del proveedor: api.minimax.io.

Verificar que el modelo esté disponible

openclaw models list --provider minimax-portal

Ejecutar la incorporación

openclaw onboard --auth-choice minimax-cn-oauth

URL base resultante del proveedor: api.minimaxi.com.

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 modelos siguen el formato minimax-portal/MiniMax-M3.

Recomendado para: MiniMax alojado con una API compatible con Anthropic.

Internacional
China

Ejecutar la incorporación

openclaw onboard --auth-choice minimax-global-api

Esto configura api.minimax.io como URL base.

Verificar que el modelo esté disponible

openclaw models list --provider minimax

Ejecutar la incorporación

openclaw onboard --auth-choice minimax-cn-api

Esto configura api.minimaxi.com como URL base.

Verificar que el modelo esté disponible

openclaw models list --provider minimax

Ejemplo de configuración

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M3",
            name: "MiniMax M3",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
            contextWindow: 1000000,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

El endpoint de streaming compatible con Anthropic de MiniMax-M2.x emite reasoning_content en fragmentos delta al estilo de OpenAI en lugar de bloques de pensamiento nativos de Anthropic, lo que expone el razonamiento interno en la salida visible si el pensamiento queda habilitado implícitamente. OpenClaw deshabilita de forma predeterminada el pensamiento de M2.x, salvo que se establezca explícitamente thinking. MiniMax-M3 (y M3.x con compatibilidad futura) está exento: M3 emite bloques de pensamiento de Anthropic adecuados y requiere que el pensamiento esté activo para producir contenido visible, por lo que OpenClaw mantiene M3 en la ruta de pensamiento adaptativo del proveedor. Consulte la sección Valores predeterminados del pensamiento en Configuración avanzada, más adelante.

Las configuraciones con clave de API usan el ID de proveedor minimax. Las referencias de modelos siguen el formato minimax/MiniMax-M3.

Configurar mediante `openclaw configure`

Iniciar el asistente

openclaw configure

Seleccionar Model/auth

Elija Model/auth en el menú.

Elegir una opción de autenticación de MiniMax

Opción de autenticación	Descripción
`minimax-global-oauth`	OAuth internacional (Coding Plan)
`minimax-cn-oauth`	OAuth para China (Coding Plan)
`minimax-global-api`	Clave de API internacional
`minimax-cn-api`	Clave de API para China

Elegir el modelo predeterminado

Seleccione el modelo predeterminado cuando se le 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 o 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 compatibles: 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 dedicado de imágenes de MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, ya que ese campo configura la URL base de chat compatible con Anthropic. Establezca MINIMAX_API_HOST=https://api.minimaxi.com para dirigir la generación de imágenes mediante el endpoint de China; el endpoint global predeterminado es https://api.minimax.io.

Consulte Generación de imágenes para conocer 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 tts.

Modelo TTS predeterminado: speech-2.8-hd
Voz predeterminada: English_expressive_narrator
ID 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
Orden de resolución de autenticación: tts.providers.minimax.apiKey, después los perfiles de autenticación OAuth/token de minimax-portal, luego las claves de entorno de Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) y, por último, MINIMAX_API_KEY
Si no se configura ningún host TTS, OpenClaw reutiliza el host OAuth configurado de minimax-portal y elimina los sufijos de ruta compatibles con Anthropic, como /anthropic
Los archivos adjuntos de audio normales se mantienen en MP3. Los destinos de notas de voz (Feishu, Telegram y otros canales que solicitan un archivo adjunto compatible con notas de voz) se transcodifican de MP3 de MiniMax a Opus de 48kHz 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 de speed y vol, pero pitch se envía como entero; OpenClaw trunca los valores fraccionarios de pitch antes de la solicitud a la API

Ajuste	Variable de entorno	Valor predeterminado	Descripción
`tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	Host de la API T2A de MiniMax.
`tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	ID del modelo TTS.
`tts.providers.minimax.voiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	ID de voz utilizado para la salida de voz.
`tts.providers.minimax.speed`		`1.0`	Velocidad de reproducción, `0.5..2.0`.
`tts.providers.minimax.vol`		`1.0`	Volumen, `(0, 10]`.
`tts.providers.minimax.pitch`		`0`	Desplazamiento entero de tono, `-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 del prompt: lyrics, instrumental
Formato de salida: mp3
Las ejecuciones respaldadas por sesiones se desvinculan mediante el flujo compartido de tarea/estado, incluido action: "status"

{
  agents: {
    defaults: {
      musicGenerationModel: { primary: "minimax/music-2.6" },
    },
  },
}

Consulte Generación de música para conocer los parámetros compartidos de la herramienta, la selección de proveedor y el comportamiento de conmutación por error.

Generación de vídeo

El plugin MiniMax incluido registra la generación de vídeo mediante la herramienta compartida video_generate tanto para minimax como para minimax-portal.

Modelo de vídeo 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 y I2V-01
Modos: flujos de texto a vídeo y de referencia con una sola imagen
Admite resolution (768P o 1080P en los modelos Hailuo 2.3/02); aspectRatio no es compatible y se ignora

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },
    },
  },
}

Consulte Generación de vídeo para conocer los parámetros compartidos de la herramienta, 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 del proveedor	Modelo de imagen predeterminado	Extracción de texto de PDF
`minimax`	`MiniMax-VL-01`	`MiniMax-M2.7`
`minimax-portal`	`MiniMax-VL-01`	`MiniMax-M2.7`

Por eso, el enrutamiento automático de contenido multimedia puede usar la comprensión de imágenes de MiniMax incluso cuando el catálogo incluido de proveedores de texto también contiene referencias de chat M3 con capacidad para imágenes. La comprensión de PDF usa MiniMax-M2.7 únicamente para extraer 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 de MiniMax Token Plan (/v1/coding_plan/search).

ID del proveedor: minimax
Resultados estructurados: títulos, URL, fragmentos y consultas relacionadas
Variable de entorno preferida: MINIMAX_CODE_PLAN_KEY
Alias de entorno aceptados: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
Alternativa 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, después MINIMAX_API_HOST y, por último, las URL base del proveedor MiniMax
La búsqueda permanece en el ID de proveedor minimax; la configuración de OAuth para China o global puede dirigir indirectamente la región mediante models.providers.minimax-portal.baseUrl y proporcionar autenticación mediante token de portador a través de MINIMAX_OAUTH_TOKEN

La configuración se encuentra en plugins.entries.minimax.config.webSearch.*.

Consulte Búsqueda de MiniMax para conocer la configuración y el uso completos de la búsqueda web.

Configuración avanzada

Opciones de configuración

Opción	Descripción
`models.providers.minimax.baseUrl`	Se prefiere `https://api.minimax.io/anthropic` (compatible con Anthropic); `https://api.minimax.io/v1` es opcional para cargas útiles compatibles con OpenAI
`models.providers.minimax.api`	Se prefiere `anthropic-messages`; `openai-completions` es opcional para cargas útiles compatibles con OpenAI
`models.providers.minimax.apiKey`	Clave de API de MiniMax (`MINIMAX_API_KEY`)
`models.providers.minimax.models`	Define `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost`
`agents.defaults.models`	Alias, parámetros y metadatos por modelo
`agents.defaults.modelPolicy.allow`	Lista explícita opcional de modelos permitidos
`models.mode`	Mantenga `merge` si desea añadir MiniMax junto con los proveedores integrados

Valores predeterminados de razonamiento

En api: "anthropic-messages", OpenClaw inserta thinking: { type: "disabled" } para los modelos MiniMax M2.x, salvo que un contenedor anterior ya haya establecido el campo thinking en la carga útil. Esto evita que el punto de conexión de transmisión de M2.x emita reasoning_content en fragmentos delta al estilo de OpenAI, lo que expondría el razonamiento interno en la salida visible.MiniMax-M3 (y M3.x) está exento: M3 devuelve una matriz content vacía con stop_reason: "end_turn" cuando el razonamiento está desactivado, por lo que OpenClaw elimina el valor predeterminado implícito de desactivación 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 modelos	Niveles	Valor predeterminado
`MiniMax-M3`	`off`, `adaptive`	`adaptive`
`MiniMax-M2.x`	`off`, `minimal`, `low`, `medium`, `high`	`off`

Modo rápido

/fast on o params.fastMode: true sustituye MiniMax-M2.7 por MiniMax-M2.7-highspeed en la ruta de transmisión compatible con Anthropic (api: "anthropic-messages", proveedor minimax o minimax-portal).

Ejemplo de alternativa

Ideal para: mantener como principal el modelo de última generación más potente y recurrir a MiniMax M2.7 en caso de error. El siguiente ejemplo usa Opus como modelo principal concreto; sustitúyalo por el modelo principal de última generación que prefiera.

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

Detalles de uso de Coding Plan

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 obtiene 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 ausentes o con formato incorrecto mantienen la alternativa para China por motivos de compatibilidad.
OpenClaw normaliza el uso de Coding Plan de MiniMax al mismo formato de visualización % left que utilizan otros proveedores. Los campos sin procesar usage_percent / usagePercent de MiniMax representan la cuota restante, no la consumida, por lo que OpenClaw los invierte. Los campos basados en recuentos tienen prioridad cuando están presentes.
Cuando la API devuelve model_remains, OpenClaw prefiere la entrada del modelo de chat, obtiene la etiqueta de la ventana a partir de start_time / end_time cuando es necesario e incluye el nombre del modelo seleccionado en la etiqueta del plan para facilitar la distinción entre las ventanas de Coding Plan.
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 las variables de entorno de la 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 mediante clave de API escriben definiciones de modelos para M3 y ambas variantes de M2.7
La comprensión de imágenes usa el proveedor multimedia MiniMax-VL-01, propiedad del plugin
Actualice los valores de precios en models.json si necesita un seguimiento exacto de los costes
Use openclaw models list para confirmar el ID de proveedor actual y, a continuación, cambie con openclaw models set minimax/MiniMax-M3 o openclaw models set minimax-portal/MiniMax-M3

Consulte Proveedores de modelos para conocer las reglas de los proveedores.

Solución de problemas

"Modelo desconocido: minimax/MiniMax-M3"

Normalmente, esto significa que el proveedor MiniMax no está configurado (no se encontró ninguna entrada de proveedor coincidente ni ningún perfil de autenticación o clave de entorno de MiniMax). Para solucionarlo:

Ejecute openclaw configure y seleccione una opción de autenticación de MiniMax, o
Añada manualmente el bloque models.providers.minimax o models.providers.minimax-portal correspondiente, o
Establezca MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN o un perfil de autenticación de MiniMax para que se pueda insertar el proveedor correspondiente.

Asegúrese de que el ID del modelo distingue entre mayúsculas y minúsculas:

Ruta de clave de API: minimax/MiniMax-M3, minimax/MiniMax-M2.7 o minimax/MiniMax-M2.7-highspeed
Ruta de OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 o minimax-portal/MiniMax-M2.7-highspeed

Después, vuelva a comprobarlo con:

openclaw models list

Más ayuda: Solución de problemas y Preguntas frecuentes.

Contenido relacionado

Selección de modelos

Selección de proveedores, referencias 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 vídeo

Parámetros compartidos de la herramienta de vídeo y selección de proveedores.

Búsqueda de MiniMax

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

Solución de problemas

Solución general de problemas y preguntas frecuentes.

Overview

Concepts and configuration

Providers

Catálogo integrado

Primeros pasos

Ejemplo de configuración

Configurar mediante `openclaw configure`

Capacidades

Generación de imágenes

Texto a voz

Generación de música

Generación de vídeo

Comprensión de imágenes

Búsqueda web

Configuración avanzada

Notas

Solución de problemas

Contenido relacionado

Selección de modelos

Generación de imágenes

Generación de música

Generación de vídeo

Búsqueda de MiniMax

Solución de problemas

​Catálogo integrado

​Primeros pasos

​Ejemplo de configuración

​Configurar mediante openclaw configure

​Capacidades

​Generación de imágenes

​Texto a voz

​Generación de música

​Generación de vídeo

​Comprensión de imágenes

​Búsqueda web

​Configuración avanzada

​Notas

​Solución de problemas

​Contenido relacionado

Selección de modelos

Generación de imágenes

Generación de música

Generación de vídeo

Búsqueda de MiniMax

Solución de problemas

Catálogo integrado

Primeros pasos

Ejemplo de configuración

Configurar mediante `openclaw configure`

Capacidades

Generación de imágenes

Texto a voz

Generación de música

Generación de vídeo

Comprensión de imágenes

Búsqueda web

Configuración avanzada

Notas

Solución de problemas

Contenido relacionado