MiniMax

OpenClaw's MiniMax provider defaults to MiniMax M2.7.

MiniMax also provides:

• Bundled speech synthesis via T2A v2
• Bundled image understanding via MiniMax-VL-01
• Bundled music generation via music-2.6
• Bundled web_search through the MiniMax Token Plan search API

Provider split:

# Built-in catalog

# Getting started

Choose your preferred auth method and follow the setup steps.

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider 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.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,
          },
        ],
      },
    },
  },
}

# Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:

openclaw configure

# Capacidades

# Generación de imágenes

El Plugin 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 admitidas: 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 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 la ruta de autenticación minimax-portal incluida en su lugar.

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 compatible con chat/Anthropic. Configura 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.

Cuando la incorporación o la configuración con clave de API escribe entradas explícitas de models.providers.minimax, OpenClaw materializa MiniMax-M2.7 y MiniMax-M2.7-highspeed como modelos de chat solo de texto. La comprensión de imágenes se expone por separado mediante el proveedor de medios MiniMax-VL-01 propiedad del Plugin.

# 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
• Los ids de modelos incluidos admitidos incluyen 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 y speech-01-turbo.
• La resolución de autenticación es messages.tts.providers.minimax.apiKey, luego 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 luego MINIMAX_API_KEY.
• Si no se configura ningún host de TTS, OpenClaw reutiliza el host OAuth configurado de minimax-portal y elimina los sufijos de ruta compatibles con Anthropic como /anthropic.
• Los adjuntos de audio normales permanecen en MP3.
• Los destinos de notas de voz como Feishu y Telegram se transcodifican de MP3 de MiniMax a Opus de 48 kHz con ffmpeg, porque la API de archivos de Feishu/Lark solo acepta file_type: "opus" para mensajes de audio nativos.
• MiniMax T2A acepta speed y vol fraccionarios, pero pitch se envía como entero; OpenClaw trunca los valores fraccionarios de pitch antes de la solicitud a la API.

# 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
• Modelo de música OAuth: minimax-portal/music-2.6
• También admite minimax/music-2.5 y minimax/music-2.0
• Controles de prompt: lyrics, instrumental, durationSeconds
• Formato de salida: mp3
• Las ejecuciones respaldadas por 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.6",
      },
    },
  },
}

# 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
• Modelo de video OAuth: minimax-portal/MiniMax-Hailuo-2.3
• Modos: flujos de texto a video y 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",
      },
    },
  },
}

# Comprensión de imágenes

El Plugin de MiniMax registra la comprensión de imágenes por separado del catálogo de texto:

Por eso el enrutamiento automático de medios puede usar la comprensión de imágenes de MiniMax incluso cuando el catálogo de proveedores de texto incluido sigue mostrando referencias de chat M2.7 solo de texto.

# Búsqueda web

El Plugin de MiniMax también registra web_search mediante la API de búsqueda MiniMax Token Plan.

• 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
• Fallback de compatibilidad: MINIMAX_API_KEY cuando ya apunta a una credencial de plan de tokens
• 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 vive en plugins.entries.minimax.config.webSearch.*.

# Configuración avanzada

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

# Notas

• Las referencias de modelo siguen la ruta de autenticación:
  • Configuración con clave de API: minimax/<model>
  • Configuración 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 de modelos solo de texto para 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 de costos exacto
• Usa openclaw models list para confirmar el ID de proveedor actual, luego cambia con openclaw models set minimax/MiniMax-M2.7 o openclaw models set minimax-portal/MiniMax-M2.7

# Solución de problemas

openclaw models list

# Relacionado