MiniMax

O provedor MiniMax do OpenClaw usa MiniMax M2.7 como padrão.

A MiniMax também fornece:

• Síntese de fala integrada via T2A v2
• Compreensão de imagens integrada via MiniMax-VL-01
• Geração de música integrada via music-2.6
• web_search integrado pela API de busca do MiniMax Token Plan

Divisão por provedor:

# Catálogo integrado

# Primeiros passos

Escolha seu método de autenticação preferido e siga as etapas de configuração.

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

# Configurar via openclaw configure

Use o assistente interativo de configuração para definir a MiniMax sem editar JSON:

openclaw configure

# Recursos

# Geração de imagens

O Plugin MiniMax registra o modelo image-01 para a ferramenta image_generate. Ele oferece suporte a:

• Geração de texto para imagem com controle de proporção
• Edição de imagem para imagem (referência de assunto) com controle de proporção
• Até 9 imagens de saída por solicitação
• Até 1 imagem de referência por solicitação de edição
• Proporções compatíveis: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

Para usar o MiniMax na geração de imagens, defina-o como o provedor de geração de imagens:

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

O Plugin usa a mesma MINIMAX_API_KEY ou autenticação OAuth dos modelos de texto. Nenhuma configuração adicional é necessária se o MiniMax já estiver configurado.

Tanto minimax quanto minimax-portal registram image_generate com o mesmo modelo image-01. Configurações com chave de API usam MINIMAX_API_KEY; configurações OAuth podem usar o caminho de autenticação minimax-portal integrado.

A geração de imagens sempre usa o endpoint de imagem dedicado do MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, pois esse campo configura a URL base compatível com chat/Anthropic. Defina MINIMAX_API_HOST=https://api.minimaxi.com para rotear a geração de imagens pelo endpoint da CN; o endpoint global padrão é https://api.minimax.io.

Quando a integração inicial ou a configuração por chave de API grava entradas explícitas em models.providers.minimax, o OpenClaw materializa MiniMax-M2.7 e MiniMax-M2.7-highspeed como modelos de chat somente de texto. A compreensão de imagens é exposta separadamente pelo provedor de mídia MiniMax-VL-01, de propriedade do Plugin.

# Texto para fala

O Plugin minimax integrado registra o MiniMax T2A v2 como provedor de fala para messages.tts.

• Modelo TTS padrão: speech-2.8-hd
• Voz padrão: English_expressive_narrator
• IDs de modelos integrados compatíveis incluem 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 e speech-01-turbo.
• A resolução de autenticação é messages.tts.providers.minimax.apiKey, depois perfis de autenticação OAuth/token minimax-portal, depois chaves de ambiente do Plano de Token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) e, por fim, MINIMAX_API_KEY.
• Se nenhum host TTS estiver configurado, o OpenClaw reutiliza o host OAuth minimax-portal configurado e remove sufixos de caminho compatíveis com Anthropic, como /anthropic.
• Anexos de áudio normais permanecem em MP3.
• Destinos de notas de voz, como Feishu e Telegram, são transcodificados de MP3 do MiniMax para Opus a 48 kHz com ffmpeg, porque a API de arquivos do Feishu/Lark só aceita file_type: "opus" para mensagens de áudio nativas.
• O MiniMax T2A aceita speed e vol fracionários, mas pitch é enviado como um inteiro; o OpenClaw trunca valores fracionários de pitch antes da solicitação à API.

# Geração de música

O Plugin MiniMax integrado registra a geração de música por meio da ferramenta compartilhada music_generate para minimax e minimax-portal.

• Modelo de música padrão: minimax/music-2.6
• Modelo de música OAuth: minimax-portal/music-2.6
• Também oferece suporte a minimax/music-2.5 e minimax/music-2.0
• Controles de prompt: lyrics, instrumental, durationSeconds
• Formato de saída: mp3
• Execuções apoiadas por sessão são desanexadas pelo fluxo compartilhado de tarefa/status, incluindo action: "status"

Para usar o MiniMax como provedor de música padrão:

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

# Geração de vídeo

O Plugin MiniMax integrado registra a geração de vídeo por meio da ferramenta compartilhada video_generate para minimax e minimax-portal.

• Modelo de vídeo padrão: minimax/MiniMax-Hailuo-2.3
• Modelo de vídeo OAuth: minimax-portal/MiniMax-Hailuo-2.3
• Modos: fluxos de texto para vídeo e referência de imagem única
• Compatível com aspectRatio e resolution

Para usar o MiniMax como provedor de vídeo padrão:

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

# Compreensão de imagem

O Plugin MiniMax registra a compreensão de imagem separadamente do catálogo de texto:

É por isso que o roteamento automático de mídia pode usar a compreensão de imagem do MiniMax mesmo quando o catálogo de provedor de texto incluído ainda mostra refs de chat M2.7 somente texto.

# Pesquisa na web

O Plugin MiniMax também registra web_search por meio da API de pesquisa do MiniMax Token Plan.

• ID do provedor: minimax
• Resultados estruturados: títulos, URLs, trechos, consultas relacionadas
• Variável de ambiente preferida: MINIMAX_CODE_PLAN_KEY
• Aliases de ambiente aceitos: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Fallback de compatibilidade: MINIMAX_API_KEY quando ela já aponta para uma credencial token-plan
• Reutilização de região: plugins.entries.minimax.config.webSearch.region, depois MINIMAX_API_HOST, depois URLs base do provedor MiniMax
• A pesquisa permanece no ID de provedor minimax; a configuração OAuth CN/global pode direcionar a região indiretamente por meio de models.providers.minimax-portal.baseUrl e pode fornecer autenticação bearer por meio de MINIMAX_OAUTH_TOKEN

A configuração fica em plugins.entries.minimax.config.webSearch.*.

# Configuração avançada

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

# Observações

• Refs de modelo seguem o caminho de autenticação:
  • Configuração por chave de API: minimax/<model>
  • Configuração OAuth: minimax-portal/<model>
• Modelo de chat padrão: MiniMax-M2.7
• Modelo de chat alternativo: MiniMax-M2.7-highspeed
• Onboarding e configuração direta por chave de API gravam definições de modelo somente texto para ambas as variantes M2.7
• A compreensão de imagem usa o provedor de mídia MiniMax-VL-01 pertencente ao Plugin
• Atualize os valores de preço em models.json se precisar de rastreamento de custo exato
• Use openclaw models list para confirmar o ID de provedor atual, depois alterne com openclaw models set minimax/MiniMax-M2.7 ou openclaw models set minimax-portal/MiniMax-M2.7

# Solução de problemas

openclaw models list

# Relacionados