Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
Provider IDAuthCapabilities
minimaxAPI keyText, image generation, music generation, video generation, image understanding, speech, web search
minimax-portalOAuthText, image generation, music generation, video generation, image understanding, speech

​
Built-in catalog

ModelTypeDescription
MiniMax-M2.7Chat (reasoning)Default hosted reasoning model
MiniMax-M2.7-highspeedChat (reasoning)Faster M2.7 reasoning tier
MiniMax-VL-01VisionImage understanding model
image-01Image generationText-to-image and image-to-image editing
music-2.6Music generationDefault music model
music-2.5Music generationPrevious music generation tier
music-2.0Music generationLegacy music generation tier
MiniMax-Hailuo-2.3Video generationText-to-video and image reference flows

​
Getting started

Choose your preferred auth method and follow the setup steps.
Best for: quick setup with MiniMax Coding Plan via OAuth, no API key required.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
This authenticates against api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
OAuth setups use the minimax-portal provider id. Model refs follow the form minimax-portal/MiniMax-M2.7.
Referral link for MiniMax Coding Plan (10% off): MiniMax Coding Plan

​
Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:
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

Elige una de las opciones disponibles 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. 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.
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
  • 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.
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.pitch0Cambio 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
  • 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",
      },
    },
  },
}
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
  • 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",
      },
    },
  },
}
Consulta Generación de video para ver los parámetros compartidos de la herramienta, la selección de proveedor y el comportamiento de conmutación por error.

​
Comprensión de imágenes

El Plugin de MiniMax registra la comprensión de imágenes por separado del catálogo de texto:
ID de proveedorModelo de imagen predeterminado
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
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.*.
Consulta Búsqueda de 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 cargas útiles compatibles con OpenAI
models.providers.minimax.apiPrefiere anthropic-messages; openai-completions es opcional para cargas útiles 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.modelsModelos de alias 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" } salvo que el pensamiento ya esté definido explícitamente en params/config.Esto evita que el endpoint de streaming de MiniMax emita reasoning_content en fragmentos delta de estilo OpenAI, lo que filtraría el razonamiento interno en la salida visible.
/fast on o params.fastMode: true reescribe MiniMax-M2.7 como MiniMax-M2.7-highspeed en la ruta de stream compatible con Anthropic.
Ideal para: mantener tu modelo de generación más reciente y más potente como principal, con fallback a MiniMax M2.7. El ejemplo siguiente usa Opus como principal concreto; cámbialo por tu modelo principal preferido de última generación.
{
  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 plan de programación).
  • 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 ausentes o mal formadas mantienen el fallback CN por compatibilidad.
  • OpenClaw normaliza el uso del plan de programación de MiniMax a la misma visualización de % restante 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 recuento 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 desde 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 prefieren el OAuth almacenado de MiniMax antes de recurrir a 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 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
Enlace de referido 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 suele significar que el proveedor MiniMax no está configurado (no se encontró una entrada de proveedor coincidente ni un perfil de autenticación/clave de entorno de MiniMax). Hay una corrección para esta detección en 2026.1.12. Corrígelo así:
  • Actualiza a 2026.1.12 (o ejecuta desde el código fuente main) y luego reinicia el Gateway.
  • Ejecuta openclaw configure y selecciona una opción de autenticación de MiniMax, o
  • Agrega manualmente el bloque models.providers.minimax o models.providers.minimax-portal correspondiente, o
  • Define 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 de modelo sea sensible a mayúsculas y minúsculas:
  • Ruta con clave de API: minimax/MiniMax-M2.7 o minimax/MiniMax-M2.7-highspeed
  • Ruta 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 modelo

Elección de proveedores, referencias de modelo 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 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.

Búsqueda de MiniMax

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

Solución de problemas

Solución de problemas general y preguntas frecuentes.