minimax Plugin は、2 つのプロバイダーと、チャット、画像生成、音楽生成、動画生成、画像理解、音声(T2A v2)、ウェブ検索の 7 つの機能を登録します。
組み込みカタログ
モデル参照は認証パスに従います。API キー設定では
minimax/<model>、OAuth 設定では minimax-portal/<model> です。
はじめに
- OAuth(Coding Plan)
- API キー
最適な用途: OAuth 経由で MiniMax Coding Plan をすばやく設定する場合。API キーは不要です。設定されるプロバイダーのベース URL:
- 国際版
- 中国版
1
オンボーディングを実行
api.minimax.io。2
モデルが利用可能か確認
OAuth 設定では
minimax-portal プロバイダー ID を使用します。モデル参照は minimax-portal/MiniMax-M3 の形式に従います。openclaw configure を使用して設定
1
ウィザードを起動
2
Model/auth を選択
メニューから Model/auth を選択します。
3
MiniMax の認証オプションを選択
4
デフォルトモデルを選択
プロンプトが表示されたら、デフォルトモデルを選択します。
機能
画像生成
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
/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-portalOAuth ホストを再利用し、/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"を含む共通のタスク/ステータスフローを通じてデタッチされます
共通ツールのパラメーター、プロバイダーの選択、フェイルオーバーの動作については、音楽生成を参照してください。
動画生成
バンドルされている 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には対応しておらず、無視されます
共通ツールのパラメーター、プロバイダーの選択、フェイルオーバーの動作については、動画生成を参照してください。
画像理解
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.*以下にあります。
Web検索の完全な設定と使用方法については、MiniMax Searchを参照してください。
詳細設定
設定オプション
設定オプション
思考のデフォルト
思考のデフォルト
api: "anthropic-messages"では、以前のラッパーがペイロードのthinkingフィールドをすでに設定していない限り、OpenClawはMiniMax M2.xモデルにthinking: { type: "disabled" }を挿入します。これにより、M2.xのストリーミングエンドポイントがOpenAI形式の差分チャンクにreasoning_contentを出力し、内部推論が表示される出力に漏れるのを防ぎます。MiniMax-M3(およびM3.x)は対象外です。思考を無効にすると、M3はstop_reason: "end_turn"とともに空のcontent配列を返します。そのため、OpenClawはM3に対する暗黙の無効化デフォルトを削除し、思考レベルが設定されている場合は代わりにthinking: { type: "adaptive" }を強制します。モデルファミリーごとに使用可能な思考レベル:高速モード
高速モード
/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を使用するグローバル設定ではapi.minimax.ioをポーリングします。ベースURLがない場合や不正な場合は、互換性のため中国リージョンへのフォールバックを維持します。 - 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キーの環境変数にフォールバックする前に、保存済みのMiniMax OAuthを優先します。
注記
- デフォルトのチャットモデル:
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で切り替えてください
プロバイダーのルールについては、モデルプロバイダーを参照してください。
トラブルシューティング
"不明なモデル: minimax/MiniMax-M3"
"不明なモデル: minimax/MiniMax-M3"
通常、これはMiniMaxプロバイダーが設定されていないことを意味します(一致するプロバイダーエントリがなく、MiniMaxの認証プロファイルまたは環境変数キーも見つかりません)。次のいずれかの方法で修正してください。
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
詳細なヘルプについては、トラブルシューティングおよびよくある質問を参照してください。
関連項目
モデルの選択
プロバイダー、モデル参照、フェイルオーバー動作の選択。
画像生成
共通の画像ツールパラメーターとプロバイダーの選択。
音楽生成
共通の音楽ツールパラメーターとプロバイダーの選択。
動画生成
共通の動画ツールパラメーターとプロバイダーの選択。
MiniMax Search
MiniMax Token Planを介したWeb検索の設定。
トラブルシューティング
一般的なトラブルシューティングとよくある質問。