Skip to main content
バンドルされている minimax Plugin は、2 つのプロバイダーと、チャット、画像生成、音楽生成、動画生成、画像理解、音声(T2A v2)、ウェブ検索の 7 つの機能を登録します。
MiniMax Coding Plan の紹介リンク(10% 割引):MiniMax Coding Plan

組み込みカタログ

モデル参照は認証パスに従います。API キー設定では minimax/<model>、OAuth 設定では minimax-portal/<model> です。

はじめに

最適な用途: OAuth 経由で MiniMax Coding Plan をすばやく設定する場合。API キーは不要です。
1

オンボーディングを実行

設定されるプロバイダーのベース URL: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 は、minimaxminimax-portal の両方で image_generate ツール用の image-01 モデルを登録し、テキストモデルと同じ MINIMAX_API_KEY または OAuth 認証を再利用します。
  • アスペクト比制御に対応した、テキストからの画像生成と画像から画像への編集(対象参照)
  • リクエストごとに最大 9 枚の出力画像、編集リクエストごとに 1 枚の参照画像
  • 対応アスペクト比:1:116:94:33:22:33:49:1621:9
画像生成では常に 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-hdspeech-2.8-turbospeech-2.6-hdspeech-2.6-turbospeech-02-hdspeech-02-turbospeech-01-hdspeech-01-turbo
  • 認証の解決順序:tts.providers.minimax.apiKey、次に minimax-portal の OAuth/トークン認証プロファイル、次に Token Plan の環境キー(MINIMAX_OAUTH_TOKENMINIMAX_CODE_PLAN_KEYMINIMAX_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 は小数の speedvol を受け付けますが、pitch は整数として送信されます。OpenClaw は API リクエストの前に、小数の pitch 値を切り捨てます

音楽生成

バンドルされている MiniMax Plugin は、minimaxminimax-portal の両方で、共通の music_generate ツールを通じて音楽生成を登録します。
  • デフォルトの音楽モデル:minimax/music-2.6(OAuth:minimax-portal/music-2.6
  • music-2.6-freemusic-covermusic-cover-free にも対応
  • プロンプト制御:lyricsinstrumental
  • 出力形式:mp3
  • セッションを使用する実行は、action: "status" を含む共通のタスク/ステータスフローを通じてデタッチされます
共通ツールのパラメーター、プロバイダーの選択、フェイルオーバーの動作については、音楽生成を参照してください。

動画生成

バンドルされている MiniMax Plugin は、minimaxminimax-portal の両方で、共通の video_generate ツールを通じて動画生成を登録します。
  • デフォルトの動画モデル: minimax/MiniMax-Hailuo-2.3(OAuth: minimax-portal/MiniMax-Hailuo-2.3
  • MiniMax-Hailuo-2.3-FastMiniMax-Hailuo-02I2V-01-DirectorI2V-01-liveI2V-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_KEYMINIMAX_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.7MiniMax-M2.7-highspeedに書き換えます。
最適な用途: 最も強力な最新世代モデルをプライマリとして維持し、MiniMax M2.7へフェイルオーバーします。以下の例では具体的なプライマリとしてOpusを使用しています。任意の最新世代プライマリモデルに置き換えてください。
  • 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の期間を区別しやすくするため、選択されたモデル名をプランラベルに含めます。
  • 使用量スナップショットでは、minimaxminimax-cnminimax-portalminimax-portal-cnを同じMiniMaxクォータサーフェスとして扱い、Coding Planキーの環境変数にフォールバックする前に、保存済みのMiniMax OAuthを優先します。

注記

  • デフォルトのチャットモデル: MiniMax-M3。代替チャットモデル: MiniMax-M2.7MiniMax-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の認証プロファイルまたは環境変数キーも見つかりません)。次のいずれかの方法で修正してください。
  • openclaw configureを実行してMiniMax認証オプションを選択する、または
  • 一致するmodels.providers.minimaxまたはmodels.providers.minimax-portalブロックを手動で追加する、または
  • MINIMAX_API_KEYMINIMAX_OAUTH_TOKEN、またはMiniMax認証プロファイルを設定し、一致するプロバイダーを挿入できるようにします。
モデルIDでは大文字と小文字が区別されることに注意してください。
  • APIキーパス: minimax/MiniMax-M3minimax/MiniMax-M2.7、またはminimax/MiniMax-M2.7-highspeed
  • OAuthパス: minimax-portal/MiniMax-M3minimax-portal/MiniMax-M2.7、またはminimax-portal/MiniMax-M2.7-highspeed
次のコマンドで再確認してください。
詳細なヘルプについては、トラブルシューティングおよびよくある質問を参照してください。

関連項目

モデルの選択

プロバイダー、モデル参照、フェイルオーバー動作の選択。

画像生成

共通の画像ツールパラメーターとプロバイダーの選択。

音楽生成

共通の音楽ツールパラメーターとプロバイダーの選択。

動画生成

共通の動画ツールパラメーターとプロバイダーの選択。

MiniMax Search

MiniMax Token Planを介したWeb検索の設定。

トラブルシューティング

一般的なトラブルシューティングとよくある質問。