MiniMax

OpenClaw の MiniMax プロバイダーは、デフォルトで MiniMax M2.7 を使用します。

MiniMax は次も提供します。

• T2A v2 による同梱の音声合成
• MiniMax-VL-01 による同梱の画像理解
• music-2.6 による同梱の音楽生成
• MiniMax Token Plan 検索 API による同梱の web_search

プロバイダーの分割:

# 組み込みカタログ

# はじめに

希望する認証方法を選び、セットアップ手順に従います。

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

# openclaw configure で設定

JSON を編集せずに MiniMax を設定するには、対話型の設定ウィザードを使用します。

openclaw configure

# 機能

# 画像生成

MiniMax plugin は、image_generate ツール用に image-01 モデルを登録します。次をサポートします。

• アスペクト比制御付きのテキストから画像の生成
• アスペクト比制御付きの画像から画像の編集 (被写体参照)
• リクエストごとに最大 9 枚の出力画像
• 編集リクエストごとに最大 1 枚の参照画像
• サポートされるアスペクト比: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

MiniMax を画像生成に使用するには、画像生成プロバイダーとして設定します。

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

この plugin は、テキストモデルと同じ MINIMAX_API_KEY または OAuth 認証を使用します。MiniMax がすでに設定済みであれば、追加の設定は不要です。

minimax と minimax-portal はどちらも、同じ image-01 モデルで image_generate を登録します。API キー設定では MINIMAX_API_KEY を使用し、OAuth 設定では 代わりに同梱の minimax-portal 認証パスを使用できます。

画像生成では常に MiniMax 専用の画像エンドポイント (/v1/image_generation) を使用し、models.providers.minimax.baseUrl は無視します。 このフィールドはチャット/Anthropic 互換ベース URL を設定するためです。画像生成を CN エンドポイント経由にするには MINIMAX_API_HOST=https://api.minimaxi.com を設定します。 デフォルトのグローバルエンドポイントは https://api.minimax.io です。

オンボーディングまたは API キー設定が明示的な models.providers.minimax エントリを書き込む場合、OpenClaw は MiniMax-M2.7 と MiniMax-M2.7-highspeed をテキスト専用チャットモデルとして実体化します。画像理解は plugin 所有の MiniMax-VL-01 メディアプロバイダーを通じて別途公開されます。

# テキスト読み上げ

同梱の minimax plugin は、messages.tts の音声プロバイダーとして MiniMax T2A v2 を登録します。

• デフォルト TTS モデル: speech-2.8-hd
• デフォルト音声: English_expressive_narrator
• サポートされる同梱モデル ID には、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 が含まれます。
• 認証解決は、messages.tts.providers.minimax.apiKey、次に minimax-portal OAuth/トークン認証プロファイル、次に Token Plan 環境 キー (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY)、次に MINIMAX_API_KEY の順です。
• TTS ホストが設定されていない場合、OpenClaw は設定済みの minimax-portal OAuth ホストを再利用し、/anthropic などの Anthropic 互換パスサフィックスを取り除きます。
• 通常の音声添付は MP3 のままです。
• Feishu や Telegram などの音声メモターゲットは、Feishu/Lark ファイル API が ネイティブ音声メッセージに対して file_type: "opus" のみを受け付けるため、 ffmpeg で MiniMax MP3 から 48kHz Opus にトランスコードされます。
• MiniMax T2A は小数の speed と vol を受け付けますが、pitch は 整数として送信されます。OpenClaw は API リクエスト前に小数の pitch 値を切り捨てます。

# 音楽生成

同梱の MiniMax plugin は、minimax と minimax-portal の両方に対して、共有 music_generate ツールを通じた音楽生成を登録します。

• デフォルト音楽モデル: minimax/music-2.6
• OAuth 音楽モデル: minimax-portal/music-2.6
• minimax/music-2.5 と minimax/music-2.0 もサポートします
• プロンプト制御: lyrics, instrumental, durationSeconds
• 出力形式: mp3
• セッションに基づく実行は、action: "status" を含む共有タスク/ステータスフローを通じて切り離されます

MiniMax をデフォルトの音楽プロバイダーとして使用するには:

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

# 動画生成

同梱の MiniMax plugin は、minimax と minimax-portal の両方に対して、共有 video_generate ツールを通じた動画生成を登録します。

• デフォルト動画モデル: minimax/MiniMax-Hailuo-2.3
• OAuth 動画モデル: minimax-portal/MiniMax-Hailuo-2.3
• モード: テキストから動画、および単一画像参照フロー
• aspectRatio と resolution をサポートします

MiniMax をデフォルトの動画プロバイダーとして使用するには:

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

# 画像理解

MiniMax Plugin は、画像理解をテキストカタログとは別に登録します。

そのため、バンドルされたテキストプロバイダーカタログにテキスト専用の M2.7 チャット参照がまだ表示されている場合でも、自動メディアルーティングで MiniMax の画像理解を使用できます。

# Web 検索

MiniMax Plugin は、MiniMax Token Plan 検索 API を通じて web_search も登録します。

• プロバイダー ID: minimax
• 構造化された結果: タイトル、URL、スニペット、関連クエリ
• 推奨 env var: MINIMAX_CODE_PLAN_KEY
• 受け付ける env エイリアス: MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN
• 互換性フォールバック: すでにトークンプラン資格情報を指している場合の MINIMAX_API_KEY
• リージョンの再利用: plugins.entries.minimax.config.webSearch.region、次に MINIMAX_API_HOST、次に MiniMax プロバイダーのベース URL
• 検索はプロバイダー ID minimax のままです。OAuth CN/グローバル設定は models.providers.minimax-portal.baseUrl を通じてリージョンを間接的に制御でき、MINIMAX_OAUTH_TOKEN を通じて bearer 認証を提供できます

設定は plugins.entries.minimax.config.webSearch.* の下にあります。

# 高度な設定

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

# 注記

• モデル参照は認証パスに従います。
  • API キー設定: minimax/<model>
  • OAuth 設定: minimax-portal/<model>
• デフォルトのチャットモデル: MiniMax-M2.7
• 代替チャットモデル: MiniMax-M2.7-highspeed
• オンボーディングと直接の API キー設定は、両方の M2.7 バリアントに対してテキスト専用モデル定義を書き込みます
• 画像理解は、Plugin 所有の MiniMax-VL-01 メディアプロバイダーを使用します
• 正確なコスト追跡が必要な場合は、models.json の価格値を更新してください
• openclaw models list を使用して現在のプロバイダー ID を確認し、その後 openclaw models set minimax/MiniMax-M2.7 または openclaw models set minimax-portal/MiniMax-M2.7 で切り替えてください

# トラブルシューティング

openclaw models list

# 関連