--- read_when: - OpenClaw で MiniMax モデルを使いたい - MiniMax のセットアップガイダンスが必要です summary: OpenClawでMiniMaxモデルを使用する title: MiniMax x-i18n: generated_at: "2026-06-27T12:45:01Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 37fe606178d7d15383e56c026b02ba7be751ead706adc097c776c0a6a92aa2a2 source_path: providers/minimax.md workflow: 16 --- OpenClaw の MiniMax プロバイダーは、デフォルトで **MiniMax M3** を使用します。 MiniMax は次も提供します。 - T2A v2 によるバンドル済み音声合成 - `MiniMax-VL-01` によるバンドル済み画像理解 - `music-2.6` によるバンドル済み音楽生成 - MiniMax Token Plan 検索 API 経由のバンドル済み `web_search` プロバイダーの分割: | プロバイダー ID | 認証 | 機能 | | ---------------- | ------- | --------------------------------------------------------------------------------------------------- | | `minimax` | API キー | テキスト、画像生成、音楽生成、動画生成、画像理解、音声、Web 検索 | | `minimax-portal` | OAuth | テキスト、画像生成、音楽生成、動画生成、画像理解、音声 | ## 組み込みカタログ | モデル | 種類 | 説明 | | ------------------------ | ---------------- | ---------------------------------------- | | `MiniMax-M3` | チャット（推論） | デフォルトのホスト型推論モデル | | `MiniMax-M2.7` | チャット（推論） | 以前のホスト型推論モデル | | `MiniMax-M2.7-highspeed` | チャット（推論） | より高速な M2.7 推論ティア | | `MiniMax-VL-01` | ビジョン | 画像理解モデル | | `image-01` | 画像生成 | テキストから画像への生成と画像から画像への編集 | | `music-2.6` | 音楽生成 | デフォルトの音楽モデル | | `music-2.5` | 音楽生成 | 以前の音楽生成ティア | | `music-2.0` | 音楽生成 | レガシー音楽生成ティア | | `MiniMax-Hailuo-2.3` | 動画生成 | テキストから動画への生成と画像参照フロー | ## はじめに 希望する認証方式を選び、セットアップ手順に従ってください。 **最適な用途:** OAuth 経由で MiniMax Coding Plan を使ったクイックセットアップ。API キーは不要です。 ```bash openclaw onboard --auth-choice minimax-global-oauth ``` これは `api.minimax.io` に対して認証します。 ```bash openclaw models list --provider minimax-portal ``` ```bash openclaw onboard --auth-choice minimax-cn-oauth ``` これは `api.minimaxi.com` に対して認証します。 ```bash openclaw models list --provider minimax-portal ``` OAuth セットアップでは `minimax-portal` プロバイダー ID を使用します。モデル参照は `minimax-portal/MiniMax-M3` の形式に従います。 MiniMax Coding Plan の紹介リンク（10% オフ）: [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) **最適な用途:** Anthropic 互換 API を使用するホスト型 MiniMax。 ```bash openclaw onboard --auth-choice minimax-global-api ``` これは `api.minimax.io` をベース URL として設定します。 ```bash openclaw models list --provider minimax ``` ```bash openclaw onboard --auth-choice minimax-cn-api ``` これは `api.minimaxi.com` をベース URL として設定します。 ```bash openclaw models list --provider minimax ``` ### 設定例 ```json5 { 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, }, ], }, }, }, } ``` Anthropic 互換のストリーミングパスでは、`thinking` を明示的に自分で設定しない限り、OpenClaw はデフォルトで MiniMax M2.x の thinking を無効にします。M2.x のストリーミングエンドポイントは、ネイティブの Anthropic thinking ブロックではなく OpenAI 風の delta チャンク内に `reasoning_content` を出力するため、暗黙的に有効なままにすると内部推論が可視出力に漏れる可能性があります。MiniMax-M3（および前方互換の M3.x）はこのデフォルトの対象外です。M3 は適切な Anthropic thinking ブロックを出力し、可視コンテンツを生成するには thinking が有効である必要があるため、OpenClaw は M3 をプロバイダーの省略時/適応型 thinking パスのままにします。 API キーセットアップでは `minimax` プロバイダー ID を使用します。モデル参照は `minimax/MiniMax-M3` の形式に従います。 ## `openclaw configure` で設定する JSON を編集せずに MiniMax を設定するには、対話型設定ウィザードを使用します。 ```bash openclaw configure ``` メニューから **モデル/認証** を選択します。 利用可能な MiniMax オプションのいずれかを選びます。 | 認証の選択肢 | 説明 | | --- | --- | | `minimax-global-oauth` | 国際版 OAuth（Coding Plan） | | `minimax-cn-oauth` | 中国 OAuth（Coding Plan） | | `minimax-global-api` | 国際版 API キー | | `minimax-cn-api` | 中国 API キー | プロンプトが表示されたら、デフォルトモデルを選択します。 ## 機能 ### 画像生成 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 を使用するには、画像生成プロバイダーとして設定します。 ```json5 { 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` メディアプロバイダーを通じて別途公開されたままです。 共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、[画像生成](/ja-JP/tools/image-generation) を参照してください。 ### テキスト読み上げ バンドル済みの `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` 値を切り捨てます。 | 設定 | 環境変数 | デフォルト | 説明 | | ----------------------------------------------- | ---------------------- | ----------------------------- | -------------------------------- | | `messages.tts.providers.minimax.baseUrl` | `MINIMAX_API_HOST` | `https://api.minimax.io` | MiniMax T2A API ホスト。 | | `messages.tts.providers.minimax.model` | `MINIMAX_TTS_MODEL` | `speech-2.8-hd` | TTS モデル ID。 | | `messages.tts.providers.minimax.speakerVoiceId` | `MINIMAX_TTS_VOICE_ID` | `English_expressive_narrator` | 音声出力に使用される音声 ID。 | | `messages.tts.providers.minimax.speed` | | `1.0` | 再生速度、`0.5..2.0`。 | | `messages.tts.providers.minimax.vol` | | `1.0` | 音量、`(0, 10]`。 | | `messages.tts.providers.minimax.pitch` | | `0` | 整数のピッチシフト、`-12..12`。 | ### 音楽生成 バンドル済み 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 をデフォルトの音楽プロバイダーとして使用するには: ```json5 { agents: { defaults: { musicGenerationModel: { primary: "minimax/music-2.6", }, }, }, } ``` 共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、[音楽生成](/ja-JP/tools/music-generation)を参照してください。 ### 動画生成 同梱の MiniMax Plugin は、`minimax` と `minimax-portal` の両方に対して、共有 `video_generate` ツールを通じた動画生成を登録します。 - デフォルトの動画モデル: `minimax/MiniMax-Hailuo-2.3` - OAuth 動画モデル: `minimax-portal/MiniMax-Hailuo-2.3` - モード: テキストから動画、および単一画像参照フロー - `aspectRatio` と `resolution` をサポート MiniMax をデフォルトの動画プロバイダーとして使用するには: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3", }, }, }, } ``` 共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、[動画生成](/ja-JP/tools/video-generation)を参照してください。 ### 画像理解 MiniMax Plugin は、テキストカタログとは別に画像理解を登録します: | プロバイダー ID | デフォルト画像モデル | | ---------------- | ------------------- | | `minimax` | `MiniMax-VL-01` | | `minimax-portal` | `MiniMax-VL-01` | そのため、同梱のテキストプロバイダーカタログに 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.*` の下にあります。 完全なウェブ検索設定と使用方法については、[MiniMax 検索](/ja-JP/tools/minimax-search)を参照してください。 ## 高度な設定 | オプション | 説明 | | --- | --- | | `models.providers.minimax.baseUrl` | `https://api.minimax.io/anthropic` (Anthropic 互換) を推奨します。`https://api.minimax.io/v1` は OpenAI 互換ペイロード向けの任意設定です | | `models.providers.minimax.api` | `anthropic-messages` を推奨します。`openai-completions` は OpenAI 互換ペイロード向けの任意設定です | | `models.providers.minimax.apiKey` | MiniMax API キー (`MINIMAX_API_KEY`) | | `models.providers.minimax.models` | `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` を定義します | | `agents.defaults.models` | allowlist に入れたいモデルのエイリアスを設定します | | `models.mode` | 組み込みと並べて MiniMax を追加したい場合は `merge` のままにします | `api: "anthropic-messages"` では、params/config で thinking がすでに明示的に設定されていない限り、OpenClaw は MiniMax M2.x モデルに `thinking: { type: "disabled" }` を注入します。 これにより、M2.x のストリーミングエンドポイントが OpenAI 形式の delta チャンクで `reasoning_content` を出力し、内部推論が表示出力に漏れることを防ぎます。 MiniMax-M3 (および M3.x) は例外です。M3 は適切な Anthropic thinking ブロックを出力し、thinking が無効な場合は `stop_reason: "end_turn"` と空の `content` 配列を返すため、ラッパーは M3 をプロバイダー側の省略/適応的 thinking パスに維持します。 `/fast on` または `params.fastMode: true` は、Anthropic 互換ストリームパス上で `MiniMax-M2.7` を `MiniMax-M2.7-highspeed` に書き換えます。 **最適な用途:** 最も強力な最新世代モデルを primary として維持し、MiniMax M2.7 にフェイルオーバーします。以下の例では具体的な primary として Opus を使用しています。好みの最新世代 primary モデルに置き換えてください。 ```json5 { 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"], }, }, }, } ``` - Coding Plan 使用量 API: `https://api.minimaxi.com/v1/token_plan/remains` または `https://api.minimax.io/v1/token_plan/remains` (coding plan キーが必要)。 - 使用量ポーリングは、設定されている場合 `models.providers.minimax-portal.baseUrl` または `models.providers.minimax.baseUrl` からホストを導出するため、`https://api.minimax.io/anthropic` を使用するグローバル設定は `api.minimax.io` をポーリングします。ベース URL が欠落している、または不正な形式の場合は、互換性のため CN フォールバックを維持します。 - OpenClaw は MiniMax coding-plan 使用量を、他のプロバイダーで使用される同じ `% left` 表示に正規化します。MiniMax の生の `usage_percent` / `usagePercent` フィールドは消費済みクォータではなく残りクォータであるため、OpenClaw はそれらを反転します。カウントベースのフィールドが存在する場合はそれが優先されます。 - API が `model_remains` を返す場合、OpenClaw はチャットモデルエントリを優先し、必要に応じて `start_time` / `end_time` からウィンドウラベルを導出し、選択されたモデル名をプランラベルに含めることで coding-plan ウィンドウを区別しやすくします。 - 使用量スナップショットは、`minimax`、`minimax-cn`、`minimax-portal` を同じ MiniMax クォータサーフェスとして扱い、Coding Plan キーの env var にフォールバックする前に保存済みの MiniMax OAuth を優先します。 ## メモ - モデル参照は認証パスに従います: - API キー設定: `minimax/` - OAuth 設定: `minimax-portal/` - デフォルトチャットモデル: `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` で切り替えます MiniMax Coding Plan の紹介リンク (10% オフ): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) プロバイダールールについては、[モデルプロバイダー](/ja-JP/concepts/model-providers)を参照してください。 ## トラブルシューティング これは通常、**MiniMax プロバイダーが設定されていない** (一致するプロバイダーエントリがなく、MiniMax 認証プロファイル/env キーも見つからない) ことを意味します。この検出の修正は **2026.1.12** に含まれています。修正するには: - **2026.1.12** にアップグレードする (またはソース `main` から実行する) してから、Gateway を再起動します。 - `openclaw configure` を実行して **MiniMax** 認証オプションを選択する、または - 一致する `models.providers.minimax` または `models.providers.minimax-portal` ブロックを手動で追加する、または - `MINIMAX_API_KEY`、`MINIMAX_OAUTH_TOKEN`、または MiniMax 認証プロファイルを設定して、一致するプロバイダーを注入できるようにします。 モデル ID は**大文字と小文字が区別される**ことを確認してください: - API キーパス: `minimax/MiniMax-M3`, `minimax/MiniMax-M2.7`, または `minimax/MiniMax-M2.7-highspeed` - OAuth パス: `minimax-portal/MiniMax-M3`, `minimax-portal/MiniMax-M2.7`, または `minimax-portal/MiniMax-M2.7-highspeed` その後、次で再確認します: ```bash openclaw models list ``` さらに詳しいヘルプ: [トラブルシューティング](/ja-JP/help/troubleshooting)と [FAQ](/ja-JP/help/faq)。 ## 関連 プロバイダー、モデル参照、フェイルオーバー動作の選択。 共有画像ツールパラメーターとプロバイダー選択。 共有音楽ツールパラメーターとプロバイダー選択。 共有動画ツールパラメーターとプロバイダー選択。 MiniMax Token Plan 経由のウェブ検索設定。 一般的なトラブルシューティングと FAQ。