MiniMax

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

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

openclaw configure で設定する

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

openclaw configure

機能

画像生成

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

• アスペクト比制御付きの テキストから画像への生成
• アスペクト比制御付きの 画像から画像への編集（被写体参照）
• 1 リクエストあたり最大 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-M3, MiniMax-M2.7, および MiniMax-M2.7-highspeed をチャットモデルとして具体化します。M3 はテキスト入力と画像入力を通知します。 画像理解は、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 などのボイスノート対象は、MiniMax MP3 から ffmpeg で 48kHz Opus にトランスコードされます。これは Feishu/Lark ファイル API がネイティブ音声メッセージに file_type: "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
• 出力形式: 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 は、テキストカタログとは別に画像理解を登録します:

そのため、同梱のテキストプロバイダーカタログに M3 の画像対応チャット参照も含まれている場合でも、自動メディアルーティングは MiniMax の画像理解を使用できます。

ウェブ検索

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

トラブルシューティング

openclaw models list

関連