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 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

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)

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

Internacional

  • Ejecutar la incorporación

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

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

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider minimax-portal

    • China

  • Ejecutar la incorporación

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

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

  • Verificar 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 incorporación

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

    Esto configura api.minimax.io como URL base.

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider minimax

    • China

  • Ejecutar la incorporación

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

    Esto configura api.minimaxi.com como URL base.

  • Verificar 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 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
    json5
    {  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.

    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"
    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 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
    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 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.*.

    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.

    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 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

    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:

    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 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.
    Was this useful?
    On this page

    On this page