MiniMax M2.1 in OpenClaw einrichten: Schnelle Anleitung

Kennst du das? Du willst ein neues Modell wie MiniMax ausprobieren, aber die Konfiguration der API-Keys und Endpoints nervt einfach nur. Oft verbringt man mehr Zeit in Config-Dateien als mit dem eigentlichen Coding.

OpenClaw macht Schluss mit diesem Overhead. Wenn du MiniMax nutzen willst, ist das Setup in wenigen Minuten erledigt, egal ob du Text generieren oder Bilder erstellen möchtest. Hier erfährst du, wie du das Beste aus MiniMax herausholst.

MiniMax

OpenClaws MiniMax-Provider nutzt standardmäßig MiniMax M2.7.

Modellauswahl

• MiniMax-M2.7: Standardmäßig gehostetes Textmodell.
• MiniMax-M2.7-highspeed: Schnellere M2.7 Text-Variante.
• image-01: Modell zur Bildgenerierung (Erstellung und Image-to-Image Editing).

Bildgenerierung

Das MiniMax-Plugin registriert das image-01 Modell für das image_generate Tool. Es unterstützt:

• Text-to-image Generation mit Kontrolle über das Seitenverhältnis.
• Image-to-image Editing (Subjektreferenz) mit Kontrolle über das Seitenverhältnis.
• Unterstützte Seitenverhältnisse: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9.

Um MiniMax für die Bildgenerierung zu nutzen, lege es als Provider fest:

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

Das Plugin nutzt denselben MINIMAX_API_KEY oder OAuth wie die Textmodelle. Wenn MiniMax bereits eingerichtet ist, brauchst du keine weitere Konfiguration.

Wähle ein Setup

MiniMax OAuth (Coding Plan) - empfohlen

Am besten für: Schnelles Setup mit dem MiniMax Coding Plan via OAuth, kein API-Key erforderlich.

Aktiviere das integrierte OAuth-Plugin und authentifiziere dich:

openclaw plugins enable minimax  # skip if already loaded.
openclaw gateway restart  # restart if gateway is already running
openclaw onboard --auth-choice minimax-portal

Du wirst aufgefordert, einen Endpoint zu wählen:

• Global - Internationale Nutzer (api.minimax.io)
• CN - Nutzer in China (api.minimaxi.com)

Details findest du in der README des MiniMax-Plugin-Pakets im OpenClaw-Repo.

MiniMax M2.7 (API-Key)

Am besten für: Gehostetes MiniMax mit Anthropic-kompatibler API.

Konfiguration via CLI:

• Starte openclaw configure
• Wähle Model/auth
• Wähle eine MiniMax Auth-Option

{
  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.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

MiniMax M2.7 als Fallback (Beispiel)

Am besten für: Behalte dein stärkstes Modell der neuesten Generation als primäres Modell und nutze MiniMax M2.7 als Ausweichlösung. Das Beispiel unten nutzt Opus als primäres Modell; tausche es einfach gegen dein bevorzugtes Modell aus.

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

Konfiguration via openclaw configure

Nutze den interaktiven Wizard, um MiniMax einzurichten, ohne JSON-Dateien manuell zu bearbeiten:

1. Starte openclaw configure.
2. Wähle Model/auth.
3. Wähle eine MiniMax Auth-Option.
4. Wähle dein Standardmodell aus, wenn du dazu aufgefordert wirst.

Konfigurationsoptionen

• models.providers.minimax.baseUrl: Nutze bevorzugt https://api.minimax.io/anthropic (Anthropic-kompatibel); https://api.minimax.io/v1 ist optional für OpenAI-kompatible Payloads.
• models.providers.minimax.api: Nutze bevorzugt anthropic-messages; openai-completions ist optional für OpenAI-kompatible Payloads.
• models.providers.minimax.apiKey: MiniMax API-Key (MINIMAX_API_KEY).
• models.providers.minimax.models: Definiere id, name, reasoning, contextWindow, maxTokens, cost.
• agents.defaults.models: Erstelle Aliase für Modelle, die du in der Allowlist haben willst.
• models.mode: Behalte merge bei, wenn du MiniMax zusätzlich zu den integrierten Modellen nutzen willst.

Hinweise

• Modell-Referenzen lauten minimax/<model>.
• Standard-Textmodell: MiniMax-M2.7.
• Alternatives Textmodell: MiniMax-M2.7-highspeed.
• Coding Plan Usage API: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (erfordert einen Coding Plan Key).
• Aktualisiere die Preise in models.json, wenn du ein exaktes Cost-Tracking benötigst.
• Referral-Link für den MiniMax Coding Plan (10% Rabatt): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
• Siehe /concepts/model-providers für Provider-Regeln.
• Nutze openclaw models list und openclaw models set minimax/MiniMax-M2.7 zum Wechseln.

Fehlerbehebung

”Unknown model: minimax/MiniMax-M2.7”

Das bedeutet meistens, dass der MiniMax-Provider nicht konfiguriert ist (kein Provider-Eintrag und kein MiniMax-Auth-Profil oder Env-Key gefunden). Ein Fix für diese Erkennung ist in Version 2026.1.12 enthalten. So löst du das Problem:

• Update auf 2026.1.12 (oder nutze main vom Source), dann Gateway neu starten.
• Führe openclaw configure aus und wähle eine MiniMax Auth-Option.
• Füge den models.providers.minimax Block manuell hinzu.
• Setze MINIMAX_API_KEY (oder ein MiniMax-Auth-Profil), damit der Provider injiziert werden kann.

Achte darauf, dass die Modell-ID case-sensitive ist:

• minimax/MiniMax-M2.7
• minimax/MiniMax-M2.7-highspeed

Prüfe es danach erneut mit:

openclaw models list

AI Setup Assistant

Nächste Schritte

• /concepts/model-providers