OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

El plugin minimax incluido registra dos proveedores y siete 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

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 Edición de texto a imagen y 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)

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

Internacional

  • Ejecutar la configuración inicial

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

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

  • Comprobar que el modelo está disponible

    bash
    openclaw models list --provider minimax-portal

    • China

  • Ejecutar la configuración inicial

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

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

  • Comprobar que el modelo está disponible

    bash
    openclaw models list --provider minimax-portal

    • Clave de API

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

    Internacional

  • Ejecutar la configuración inicial

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

    Esto configura api.minimax.io como URL base.

  • Comprobar que el modelo está disponible

    bash
    openclaw models list --provider minimax

    • China

  • Ejecutar la configuración inicial

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

    Esto configura api.minimaxi.com como URL base.

  • Comprobar que el modelo está disponible

    bash
    openclaw models list --provider minimax

    • Ejemplo de configuración

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

    Configurar mediante openclaw configure

  • Iniciar el asistente

    bash
    openclaw configure

  • Seleccionar modelo/autenticación

    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 (plan Coding)
    minimax-cn-oauth OAuth de China (plan Coding)
    minimax-global-api Clave de API internacional
    minimax-cn-api Clave de API de 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 MINIMAX_API_KEY o la autenticación 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 la relación de aspecto
    • Hasta 9 imágenes de salida por solicitud y 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
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

    La generación de imágenes siempre utiliza el endpoint específico de imágenes de MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, ya que ese campo configura la URL base del chat compatible con Anthropic. Establezca MINIMAX_API_HOST=https://api.minimaxi.com para dirigir la generación de imágenes a través del endpoint de China; el endpoint global predeterminado es https://api.minimax.io.

    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
    • Identificadores 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 la autenticación: messages.tts.providers.minimax.apiKey, luego los perfiles de autenticación OAuth/token de minimax-portal, después las claves de entorno del plan Token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) y, por último, MINIMAX_API_KEY
    • Si no se configura ningún host de TTS, OpenClaw reutiliza el host OAuth de minimax-portal configurado y elimina sufijos de ruta compatibles con Anthropic, como /anthropic
    • Los archivos adjuntos de audio normales permanecen en formato 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 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 de speed y vol, pero pitch se envía como un entero; OpenClaw trunca los valores fraccionarios de pitch antes de la solicitud a la API
    Ajuste Variable de entorno Valor predeterminado Descripción
    messages.tts.providers.minimax.baseUrl MINIMAX_API_HOST https://api.minimax.io Host de la API T2A de MiniMax.
    messages.tts.providers.minimax.model MINIMAX_TTS_MODEL speech-2.8-hd Identificador del modelo TTS.
    messages.tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator Identificador de voz usado para la salida de voz.
    messages.tts.providers.minimax.speed 1.0 Velocidad de reproducción, 0.5..2.0.
    messages.tts.providers.minimax.vol 1.0 Volumen, (0, 10].
    messages.tts.providers.minimax.pitch 0 Desplazamiento entero del 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 de la instrucción: lyrics, instrumental
    • Formato de salida: mp3
    • Las ejecuciones respaldadas por una sesión se desvinculan mediante el flujo compartido de tarea/estado, incluido action: "status"
    json5
    {  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

    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 e I2V-01
    • Modos: texto a vídeo y flujos 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
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

    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 del proveedor 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 variables de entorno aceptados: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
    • Alternativa de compatibilidad: MINIMAX_API_KEY cuando ya apunta a una credencial del plan de tokens
    • 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.*.

    Configuración avanzada

    Opciones de configuración
    Opción Descripción
    models.providers.minimax.baseUrl Se recomienda 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 recomienda 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 Asigna alias a los modelos que quieras incluir en la lista de permitidos
    models.mode Mantén merge si quieres añadir MiniMax junto con los modelos integrados
    Valores predeterminados de razonamiento

    Con 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 con formato de OpenAI, lo que expondría el razonamiento interno en la salida visible.

    MiniMax-M3 (y M3.x) queda exento: M3 devuelve un arreglo content vacío 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" }.

    Niveles de razonamiento disponibles por familia de modelos:

    Familia de modelos Niveles 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 modelo alternativo

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

    json5
    {  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 consultan api.minimax.io. Las URL base ausentes o con formato incorrecto mantienen la alternativa de China por compatibilidad.
    • OpenClaw normaliza el uso del Coding Plan de MiniMax con la misma visualización de % left que utilizan otros proveedores. Los campos sin procesar usage_percent / usagePercent de MiniMax representan la cuota restante, no la cuota 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 prioriza la entrada del modelo de chat, obtiene la etiqueta del periodo 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 periodos del 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 priorizan las credenciales OAuth de MiniMax almacenadas 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 de contenido multimedia MiniMax-VL-01, propiedad del plugin
    • Actualiza los valores de precios en models.json si necesitas un seguimiento exacto de los costos
    • Usa openclaw models list para confirmar el ID de proveedor actual y, después, cambia con openclaw models set minimax/MiniMax-M3 o openclaw models set minimax-portal/MiniMax-M3

    Solución de problemas

    "Modelo desconocido: minimax/MiniMax-M3"

    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 o clave de entorno de MiniMax). Para corregirlo:

    • Ejecuta openclaw configure y selecciona una opción de autenticación de MiniMax, o
    • Añade manualmente el bloque models.providers.minimax o models.providers.minimax-portal correspondiente, o
    • Configura MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN o un perfil de autenticación de MiniMax para que se pueda insertar el proveedor correspondiente.

    Asegúrate de que el ID del modelo distinga entre 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

    Después, vuelve a comprobarlo con:

    bash
    openclaw models list

    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 video

    Parámetros compartidos de la herramienta de video y selección de proveedores.
    Búsqueda con MiniMax

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

    Solución general de problemas y preguntas frecuentes.
    Was this useful?
    On this page

    On this page