MiniMax

バンドルされている minimax Plugin は、2 つのプロバイダーに加えて、チャット、画像生成、音楽生成、動画生成、画像理解、音声（T2A v2）、ウェブ検索の 7 つの機能を登録します。

組み込みカタログ

モデル参照は認証方式に従います。API キー設定では minimax/<model>、OAuth 設定では minimax-portal/<model> を使用します。

はじめに

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 で設定

openclaw configure

機能

画像生成

MiniMax Plugin は、minimax と minimax-portal の両方で image_generate ツール用の image-01 モデルを登録し、テキストモデルと同じ MINIMAX_API_KEY または OAuth 認証を再利用します。

• アスペクト比を制御できる、テキストからの画像生成と画像から画像への編集（被写体参照）
• 1 リクエストあたり最大 9 枚の出力画像、1 編集リクエストあたり 1 枚の参照画像
• 対応アスペクト比：1:1、16:9、4:3、3:2、2:3、3:4、9:16、21:9

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

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

テキスト読み上げ

同梱の 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、speech-01-240228
• 認証の解決順序：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）
• music-2.6-free、music-cover、music-cover-free にも対応
• プロンプト制御：lyrics、instrumental
• 出力形式：mp3
• セッションに紐づく実行は、action: "status" を含む共通のタスク/ステータスフローを通じて切り離されます

{  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）
• MiniMax-Hailuo-2.3-Fast、MiniMax-Hailuo-02、I2V-01-Director、I2V-01-live、I2V-01 にも対応
• モード：テキストから動画への生成と、単一画像を参照するフロー
• resolution（Hailuo 2.3/02 モデルでは 768P または 1080P）に対応します。aspectRatio には対応しておらず、指定しても無視されます

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

画像理解

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

そのため、バンドルされたテキストプロバイダーカタログに画像対応のM3チャット参照も含まれている場合でも、自動メディアルーティングでMiniMaxの画像理解を使用できます。PDF理解では、テキスト抽出にのみMiniMax-M2.7を使用します。MiniMaxはPDFから画像への変換経路を登録しません。

Web検索

MiniMax Pluginは、MiniMax Token Plan検索API（/v1/coding_plan/search）を介してweb_searchも登録します。

• プロバイダーID: minimax
• 構造化された結果: タイトル、URL、スニペット、関連クエリ
• 推奨環境変数: MINIMAX_CODE_PLAN_KEY
• 使用可能な環境変数エイリアス: MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN
• 互換性フォールバック: すでにToken Planの認証情報を指している場合のMINIMAX_API_KEY
• リージョンの再利用: plugins.entries.minimax.config.webSearch.region、次にMINIMAX_API_HOST、その次にMiniMaxプロバイダーのベースURL
• 検索ではプロバイダーID minimaxを使用し続けます。OAuthの中国/グローバル設定では、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"],      },    },  },}

注記

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

トラブルシューティング

openclaw models list

関連項目