MiniMax

The bundled minimax plugin registers two chat providers plus six capabilities: image generation, music generation, video generation, image understanding, speech (T2A v2), and web search.

Built-in catalog¶

Model refs follow the auth path: minimax/<model> for API-key setups, minimax-portal/<model> for OAuth setups.

MiniMax M3 is a preferred Code Mode model on both API-key and OAuth routes. With no global Code Mode setting, the automatic tier can engage it; explicit agent or model settings still take precedence.

Getting started¶

**Best for:** quick setup with MiniMax Coding Plan via OAuth, no API key required.

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

**Best for:** hosted MiniMax with Anthropic-compatible API.

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: { vars: { 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"],
            compat: { codeMode: "preferred" },
            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,
          },
        ],
      },
    },
  },
}

Configure via openclaw configure¶

1. Launch the wizard

openclaw configure

2. Select Model/auth

Choose Model/auth from the menu.

3. Choose a MiniMax auth option

4. Pick your default model

Select your default model when prompted.

Capabilities¶

Image generation¶

The MiniMax plugin registers the image-01 model for the image_generate tool on both minimax and minimax-portal, reusing the same MINIMAX_API_KEY or OAuth auth as the text models.

• Text-to-image generation and image-to-image editing (subject reference), both with aspect ratio control
• Up to 9 output images per request, 1 reference image per edit request
• Supported aspect ratios: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

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

Image generation always uses MiniMax's dedicated image endpoint (/v1/image_generation) and ignores models.providers.minimax.baseUrl, since that field configures the chat/Anthropic-compatible base URL instead. Set MINIMAX_API_HOST=https://api.minimaxi.com to route image generation through the CN endpoint; the default global endpoint is https://api.minimax.io.

Text-to-speech¶

The bundled minimax plugin registers MiniMax T2A v2 as a speech provider for tts.

• Default TTS model: speech-2.8-hd
• Default voice: English_expressive_narrator
• Bundled model ids: 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
• Auth resolution order: tts.providers.minimax.apiKey, then minimax-portal OAuth/token auth profiles, then Token Plan environment keys (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), then MINIMAX_API_KEY
• If no TTS host is configured, OpenClaw reuses the configured minimax-portal OAuth host and strips Anthropic-compatible path suffixes such as /anthropic
• Normal audio attachments stay MP3. Voice-note targets (Feishu, Telegram, and other channels that request a voice-note-compatible attachment) are transcoded from MiniMax MP3 to 48kHz Opus with ffmpeg, because e.g. the Feishu/Lark file API only accepts file_type: "opus" for native audio messages
• MiniMax T2A accepts fractional speed and vol, but pitch is sent as an integer; OpenClaw truncates fractional pitch values before the API request

Music generation¶

The bundled MiniMax plugin registers music generation through the shared music_generate tool for both minimax and minimax-portal.

• Default music model: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
• Also supports music-2.6-free, music-cover, and music-cover-free
• Prompt controls: lyrics, instrumental
• Output format: mp3
• Session-backed runs detach through the shared task/status flow, including action: "status"

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

Video generation¶

The bundled MiniMax plugin registers video generation through the shared video_generate tool for both minimax and minimax-portal.

• Default video model: minimax/MiniMax-Hailuo-2.3 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
• Also supports MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, and I2V-01
• Modes: text-to-video and single-image reference flows
• Supports resolution (768P or 1080P on Hailuo 2.3/02 models); aspectRatio is not supported and is ignored

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

Image understanding¶

The MiniMax plugin registers image understanding separately from the text catalog:

That is why automatic media routing can use MiniMax image understanding even when the bundled text-provider catalog also includes M3 image-capable chat refs. PDF understanding uses MiniMax-M2.7 for text extraction only; MiniMax does not register a PDF-to-image conversion path.

Web search¶

The MiniMax plugin also registers web_search through the MiniMax Token Plan search API (/v1/coding_plan/search).

• Provider id: minimax
• Structured results: titles, URLs, snippets, related queries
• Preferred env var: MINIMAX_CODE_PLAN_KEY
• Accepted env aliases: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Compatibility fallback: MINIMAX_API_KEY when it already points at a token-plan credential
• Region reuse: plugins.entries.minimax.config.webSearch.region, then MINIMAX_API_HOST, then MiniMax provider base URLs
• Search stays on provider id minimax; OAuth CN/global setup can steer region indirectly through models.providers.minimax-portal.baseUrl and can provide bearer auth through MINIMAX_OAUTH_TOKEN

Config lives under plugins.entries.minimax.config.webSearch.*.

Advanced configuration¶

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

Notes¶

• Default chat model: MiniMax-M3. Alternate chat models: MiniMax-M2.7, MiniMax-M2.7-highspeed
• Onboarding and direct API-key setup write model definitions for M3 and both M2.7 variants
• Image understanding uses the plugin-owned MiniMax-VL-01 media provider
• Update pricing values in models.json if you need exact cost tracking
• Use openclaw models list to confirm the current provider id, then switch with openclaw models set minimax/MiniMax-M3 or openclaw models set minimax-portal/MiniMax-M3

Troubleshooting¶

openclaw models list

Related¶

Model selection

Choosing providers, model refs, and failover behavior.

Image generation

Shared image tool parameters and provider selection.

Music generation

Shared music tool parameters and provider selection.

Video generation

Shared video tool parameters and provider selection.

MiniMax Search

Web search configuration via MiniMax Token Plan.

Troubleshooting

General troubleshooting and FAQ.