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 認証を再利用します。

• アスペクト比制御に対応した、テキストからの画像生成と画像から画像への編集（対象参照）
• リクエストごとに最大 9 枚の出力画像、編集リクエストごとに 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 は、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
• 認証の解決順序：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
• 互換性フォールバック: すでにトークンプランの認証情報を指している場合は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

関連項目