Using MiniMax with OpenClaw

Prerequisites

• ✓An active MiniMax Coding Plan or MiniMax API key so you can authenticate either via OAuth or direct API.
• ✓An OpenClaw installation new enough to include the MiniMax provider and `openclaw onboard` / `openclaw configure` commands.
• ✓Access to `api.minimax.io` or `api.minimaxi.com` from your environment, depending on whether you use the international or China endpoints.

Steps

1. 1

   Decide between OAuth Coding Plan and API key auth

   Pick whether you want to connect MiniMax via the Coding Plan OAuth flow or via a direct API key. OAuth is best when you use the MiniMax Coding Plan and don’t want to manage raw keys; API key mode is better when you already have an Anthropic-compatible MiniMax key and want explicit control over base URLs.

2. 2

   Run MiniMax onboarding with global OAuth

   If you use the international MiniMax Coding Plan, run the global OAuth onboarding flow. 7`.

   bashCopy

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

3. 3

   Run MiniMax onboarding with China OAuth

   If your account is in the China region, use the China OAuth onboarding flow instead. com` and still exposes models through the `minimax-portal` provider id.

   bashCopy

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

4. 4

   Run MiniMax onboarding with a global API key

   For direct API key setups in the international region, use the global API onboarding choice. 7`.

   bashCopy

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

5. 5

   Run MiniMax onboarding with a China API key

   If your MiniMax API key targets the China region, run the China API onboarding flow. com` as the base URL for the `minimax` provider.

   bashCopy

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

6. 6

   Verify MiniMax models are registered for your auth path

   After onboarding, confirm that OpenClaw sees the MiniMax models under the correct provider id. Use `minimax-portal` for OAuth setups and `minimax` for API-key setups so you don’t chase case or provider-id issues later.

   bashCopy

   openclaw models list --provider minimax-portal

7. 7

   Verify MiniMax models for API key setups

   If you configured MiniMax via API key, list models under the `minimax` provider. This is also a quick sanity check that your `MINIMAX_API_KEY` or related auth is wired correctly.

   bashCopy

   openclaw models list --provider minimax

8. 8

   Configure MiniMax provider and default chat model

   Add an explicit MiniMax provider block so you control base URLs, APIs, pricing metadata, and which models OpenClaw exposes. 7` as the default agent model.

   jsonCopy

   {
     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", "image"],
               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", "image"],
               cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
               contextWindow: 204800,
               maxTokens: 131072,
             },
           ],
         },
       },
     },
   }

9. 9

   Set MiniMax as the default image generation provider

   If you want OpenClaw’s `image_generate` tool to use MiniMax, set the default image generation model to `minimax/image-01`. The MiniMax plugin reuses the same auth as your text models, so you don’t need extra keys for image generation.

   jsonCopy

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

10. 10

    Set MiniMax as the default music generation provider

    5+`. 0` explicitly if you need older tiers.

    jsonCopy

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

11. 11

    Set MiniMax as the default video generation provider

    3`. This enables text-to-video and single-image reference flows through the shared `video_generate` tool.

    jsonCopy

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

12. 12

    Configure MiniMax as a failover model

    If you already use another primary model (for example Anthropic Opus), you can keep it as primary and add MiniMax as a fallback. 7` when the primary fails.

    jsonCopy

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

13. 13

    Use the interactive configure wizard for MiniMax

    If you prefer not to edit JSON by hand, use `openclaw configure` to set MiniMax auth and defaults. The wizard lets you pick a MiniMax auth choice and default model from a menu, then writes the config for you.

    bashCopy

    openclaw configure

Configuration

Troubleshooting

openclaw models list

Frequently asked questions