minimax Plugin は、2 つのプロバイダーと 5 つの機能を登録します: チャット、画像生成、音楽生成、動画生成、画像理解、音声 (T2A v2)、Web 検索。
| プロバイダー 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 | 音楽生成 | デフォルトの音楽モデル |
MiniMax-Hailuo-2.3 | 動画生成 | テキストから動画、および画像から動画へのフロー |
minimax/<model>、OAuth 設定では minimax-portal/<model> です。
はじめに
- OAuth (Coding Plan)
- API キー
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 は、minimax と minimax-portal の両方で image_generate ツール用に image-01 モデルを登録し、テキストモデルと同じ MINIMAX_API_KEY または OAuth 認証を再利用します。
- テキストから画像生成、および画像から画像への編集(被写体参照)。どちらもアスペクト比制御に対応
- 1リクエストあたり最大9枚の出力画像、編集リクエストあたり参照画像1枚
- 対応アスペクト比:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
/v1/image_generation) を使用し、models.providers.minimax.baseUrl は無視します。このフィールドは代わりにチャット/Anthropic 互換のベース URL を設定するためです。画像生成を CN エンドポイント経由にルーティングするには、MINIMAX_API_HOST=https://api.minimaxi.com を設定します。デフォルトのグローバルエンドポイントは https://api.minimax.io です。
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、画像生成 を参照してください。
テキスト読み上げ
バンドルされたminimax plugin は、MiniMax T2A v2 を messages.tts 用の音声プロバイダーとして登録します。
- デフォルト 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-portalOAuth/トークン認証プロファイル、次に Token Plan 環境キー (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY)、次にMINIMAX_API_KEY - TTS ホストが設定されていない場合、OpenClaw は設定済みの
minimax-portalOAuth ホストを再利用し、/anthropicなどの Anthropic 互換パス接尾辞を取り除きます - 通常の音声添付は MP3 のままです。ボイスノート対象(Feishu、Telegram、およびボイスノート互換添付を要求するその他のチャンネル)は、MiniMax MP3 から 48kHz Opus に
ffmpegでトランスコードされます。たとえば 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.voiceId | 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) music-2.6-free、music-cover、music-cover-freeにも対応- プロンプト制御:
lyrics,instrumental - 出力形式:
mp3 - セッションに裏付けられた実行は、
action: "status"を含む共有タスク/ステータスフローを通じて切り離されます
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、音楽生成 を参照してください。
動画生成
バンドルされた 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(768Pまたは Hailuo 2.3/02 モデルの1080P) に対応。aspectRatioは未対応で、無視されます
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、動画生成を参照してください。
画像理解
MiniMax Plugin は、テキストカタログとは別に画像理解を登録します。| プロバイダー ID | デフォルト画像モデル | PDF テキスト抽出 |
|---|---|---|
minimax | MiniMax-VL-01 | MiniMax-M2.7 |
minimax-portal | MiniMax-VL-01 | MiniMax-M2.7 |
MiniMax-M2.7 を使用します。MiniMax は PDF から画像への変換パスを登録しません。
Web 検索
MiniMax Plugin は、MiniMax Token Plan 検索 API(/v1/coding_plan/search)経由で 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/global セットアップは、models.providers.minimax-portal.baseUrlを通じて間接的にリージョンを制御でき、MINIMAX_OAUTH_TOKENを通じて bearer 認証を提供できます
plugins.entries.minimax.config.webSearch.* 配下にあります。
Web 検索の完全な設定と使い方については、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 のままにします |
thinking のデフォルト
thinking のデフォルト
api: "anthropic-messages" では、以前のラッパーがペイロード内の thinking フィールドをすでに設定していない限り、OpenClaw は MiniMax M2.x モデルに thinking: { type: "disabled" } を注入します。これにより、M2.x のストリーミングエンドポイントが OpenAI スタイルのデルタチャンクで reasoning_content を出力し、内部推論が可視出力へ漏れることを防ぎます。MiniMax-M3(および M3.x)は例外です。thinking が無効な場合、M3 は stop_reason: "end_turn" 付きの空の content 配列を返すため、OpenClaw は M3 では暗黙の disabled デフォルトを削除し、thinking レベルが設定されている場合は代わりに thinking: { type: "adaptive" } を強制します。モデルファミリーごとに利用可能な thinking レベル:| モデルファミリー | レベル | デフォルト |
|---|---|---|
MiniMax-M3 | off, adaptive | adaptive |
MiniMax-M2.x | off, minimal, low, medium, high | off |
高速モード
高速モード
/fast on または params.fastMode: true は、Anthropic 互換ストリームパス(api: "anthropic-messages"、プロバイダー minimax または minimax-portal)で MiniMax-M2.7 を MiniMax-M2.7-highspeed に書き換えます。フォールバック例
フォールバック例
最適な用途: 最も強力な最新世代モデルをプライマリとして維持し、MiniMax M2.7 にフェイルオーバーします。以下の例では具体的なプライマリとして Opus を使用しています。好みの最新世代プライマリモデルに置き換えてください。
Coding Plan の使用詳細
Coding Plan の使用詳細
- 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を使用する global セットアップでは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-portal-cnを同じ MiniMax クォータサーフェスとして扱い、Coding Plan キーの env var にフォールバックする前に保存済みの MiniMax OAuth を優先します。
メモ
- デフォルトチャットモデル:
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で切り替えます
プロバイダールールについては、モデルプロバイダーを参照してください。
トラブルシューティング
"Unknown model: minimax/MiniMax-M3"
"Unknown model: minimax/MiniMax-M3"
これは通常、MiniMax プロバイダーが設定されていない(一致するプロバイダーエントリがなく、MiniMax 認証プロファイル/env キーも見つからない)ことを意味します。修正方法:
openclaw configureを実行して MiniMax 認証オプションを選択する、または- 一致する
models.providers.minimaxまたはmodels.providers.minimax-portalブロックを手動で追加する、または MINIMAX_API_KEY、MINIMAX_OAUTH_TOKEN、または MiniMax 認証プロファイルを設定して、一致するプロバイダーを注入できるようにする。
- 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
その他のヘルプ: トラブルシューティングおよび FAQ。
関連
モデル選択
プロバイダー、モデル参照、フェイルオーバー動作の選択。
画像生成
共有画像ツールパラメーターとプロバイダー選択。
音楽生成
共有音楽ツールパラメーターとプロバイダー選択。
動画生成
共有動画ツールパラメーターとプロバイダー選択。
MiniMax Search
MiniMax Token Plan による Web 検索設定。
トラブルシューティング
一般的なトラブルシューティングと FAQ。