MiniMax

OpenClaw's MiniMax provider defaults to MiniMax M2.7.

MiniMax also provides:

• Bundled speech synthesis via T2A v2
• Bundled image understanding via
  text

  Copy

  MiniMax-VL-01
• Bundled music generation via
  text

  Copy

  music-2.6
• Bundled
  text

  Copy

  web_search
  through the MiniMax Coding Plan search API

Provider split:

Built-in catalog

Getting started

Choose your preferred auth method and follow the setup steps.

text
Copy
<Tabs>
  <Tab title="International">
    <Steps>
      <Step title="Run onboarding">
        ```bash}
        openclaw onboard --auth-choice minimax-global-oauth
        ```

        This authenticates against `api.minimax.io`.
      </Step>

      <Step title="Verify the model is available">
        ```bash}
        openclaw models list --provider minimax-portal
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="China">
    <Steps>
      <Step title="Run onboarding">
        ```bash}
        openclaw onboard --auth-choice minimax-cn-oauth
        ```

        This authenticates against `api.minimaxi.com`.
      </Step>

      <Step title="Verify the model is available">
        ```bash}
        openclaw models list --provider minimax-portal
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Note>
  OAuth setups use the `minimax-portal` provider id. Model refs follow the form `minimax-portal/MiniMax-M2.7`.
</Note>

<Tip>
  Referral link for MiniMax Coding Plan (10% off): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb\&source=link)
</Tip>

text
Copy
<Tabs>
  <Tab title="International">
    <Steps>
      <Step title="Run onboarding">
        ```bash}
        openclaw onboard --auth-choice minimax-global-api
        ```

        This configures `api.minimax.io` as the base URL.
      </Step>

      <Step title="Verify the model is available">
        ```bash}
        openclaw models list --provider minimax
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="China">
    <Steps>
      <Step title="Run onboarding">
        ```bash}
        openclaw onboard --auth-choice minimax-cn-api
        ```

        This configures `api.minimaxi.com` as the base URL.
      </Step>

      <Step title="Verify the model is available">
        ```bash}
        openclaw models list --provider minimax
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Config example

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

<Warning>
  On the Anthropic-compatible streaming path, OpenClaw disables MiniMax thinking by default unless you explicitly set `thinking` yourself. MiniMax's streaming endpoint emits `reasoning_content` in OpenAI-style delta chunks instead of native Anthropic thinking blocks, which can leak internal reasoning into visible output if left enabled implicitly.
</Warning>

<Note>
  API-key setups use the `minimax` provider id. Model refs follow the form `minimax/MiniMax-M2.7`.
</Note>

Configure via

text

Copy

openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:

text
Copy
| Auth choice            | Description                       |
| ---------------------- | --------------------------------- |
| `minimax-global-oauth` | International OAuth (Coding Plan) |
| `minimax-cn-oauth`     | China OAuth (Coding Plan)         |
| `minimax-global-api`   | International API key             |
| `minimax-cn-api`       | China API key                     |

Capabilities

Image generation

The MiniMax plugin registers the

• Text-to-image generation with aspect ratio control
• Image-to-image editing (subject reference) with aspect ratio control
• Up to 9 output images per request
• Up to 1 reference image per edit request
• Supported aspect ratios:
  text

  Copy

  1:1
  ,
  text

  Copy

  16:9
  ,
  text

  Copy

  4:3
  ,
  text

  Copy

  3:2
  ,
  text

  Copy

  2:3
  ,
  text

  Copy

  3:4
  ,
  text

  Copy

  9:16
  ,
  text

  Copy

  21:9

To use MiniMax for image generation, set it as the image generation provider:

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

The plugin uses the same

Both

Image generation always uses MiniMax's dedicated image endpoint (

When onboarding or API-key setup writes explicit

Text-to-speech

The bundled

• Default TTS model:
  text

  Copy

  speech-2.8-hd
• Default voice:
  text

  Copy

  English_expressive_narrator
• Supported bundled model ids include
  text

  Copy

  speech-2.8-hd
  ,
  text

  Copy

  speech-2.8-turbo
  ,
  text

  Copy

  speech-2.6-hd
  ,
  text

  Copy

  speech-2.6-turbo
  ,
  text

  Copy

  speech-02-hd
  ,
  text

  Copy

  speech-02-turbo
  ,
  text

  Copy

  speech-01-hd
  , and
  text

  Copy

  speech-01-turbo
  .
• Auth resolution is
  text

  Copy

  messages.tts.providers.minimax.apiKey
  , then
  text

  Copy

  minimax-portal
  OAuth/token auth profiles, then Token Plan environment keys (
  text

  Copy

  MINIMAX_OAUTH_TOKEN
  ,
  text

  Copy

  MINIMAX_CODE_PLAN_KEY
  ,
  text

  Copy

  MINIMAX_CODING_API_KEY
  ), then
  text

  Copy

  MINIMAX_API_KEY
  .
• If no TTS host is configured, OpenClaw reuses the configured
  text

  Copy

  minimax-portal
  OAuth host and strips Anthropic-compatible path suffixes such as
  text

  Copy

  /anthropic
  .
• Normal audio attachments stay MP3.
• Voice-note targets such as Feishu and Telegram are transcoded from MiniMax MP3 to 48kHz Opus with
  text

  Copy

  ffmpeg
  , because the Feishu/Lark file API only accepts
  text

  Copy

  file_type: "opus"
  for native audio messages.
• MiniMax T2A accepts fractional
  text

  Copy

  speed
  and
  text

  Copy

  vol
  , but
  text

  Copy

  pitch
  is sent as an integer; OpenClaw truncates fractional
  text

  Copy

  pitch
  values before the API request.

Music generation

The bundled MiniMax plugin registers music generation through the shared

• Default music model:
  text

  Copy

  minimax/music-2.6
• OAuth music model:
  text

  Copy

  minimax-portal/music-2.6
• Also supports
  text

  Copy

  minimax/music-2.5
  and
  text

  Copy

  minimax/music-2.0
• Prompt controls:
  text

  Copy

  lyrics
  ,
  text

  Copy

  instrumental
  ,
  text

  Copy

  durationSeconds
• Output format:
  text

  Copy

  mp3
• Session-backed runs detach through the shared task/status flow, including
  text

  Copy

  action: "status"

To use MiniMax as the default music provider:

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

Video generation

The bundled MiniMax plugin registers video generation through the shared

• Default video model:
  text

  Copy

  minimax/MiniMax-Hailuo-2.3
• OAuth video model:
  text

  Copy

  minimax-portal/MiniMax-Hailuo-2.3
• Modes: text-to-video and single-image reference flows
• Supports
  text

  Copy

  aspectRatio
  and
  text

  Copy

  resolution

To use MiniMax as the default video provider:

json5
Copy
{
  agents: {
    defaults: {
      videoGenerationModel: {
        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 still shows text-only M2.7 chat refs.

Web search

The MiniMax plugin also registers

• Provider id:
  text

  Copy

  minimax
• Structured results: titles, URLs, snippets, related queries
• Preferred env var:
  text

  Copy

  MINIMAX_CODE_PLAN_KEY
• Accepted env alias:
  text

  Copy

  MINIMAX_CODING_API_KEY
• Compatibility fallback:
  text

  Copy

  MINIMAX_API_KEY
  when it already points at a coding-plan token
• Region reuse:
  text

  Copy

  plugins.entries.minimax.config.webSearch.region
  , then
  text

  Copy

  MINIMAX_API_HOST
  , then MiniMax provider base URLs
• Search stays on provider id
  text

  Copy

  minimax
  ; OAuth CN/global setup can still steer region indirectly through
  text

  Copy

  models.providers.minimax-portal.baseUrl

Config lives under

Advanced configuration

Notes

• Model refs follow the auth path:
  • API-key setup:
    text

    Copy

    minimax/<model>
  • OAuth setup:
    text

    Copy

    minimax-portal/<model>
• Default chat model:
  text

  Copy

  MiniMax-M2.7
• Alternate chat model:
  text

  Copy

  MiniMax-M2.7-highspeed
• Onboarding and direct API-key setup write text-only model definitions for both M2.7 variants
• Image understanding uses the plugin-owned
  text

  Copy

  MiniMax-VL-01
  media provider
• Update pricing values in
  text

  Copy

  models.json
  if you need exact cost tracking
• Use
  text

  Copy

  openclaw models list
  to confirm the current provider id, then switch with
  text

  Copy

  openclaw models set minimax/MiniMax-M2.7
  or
  text

  Copy

  openclaw models set minimax-portal/MiniMax-M2.7

Troubleshooting

Related