メインコンテンツへスキップ
バンドルされた minimax Plugin は、2 つのプロバイダーと 5 つの機能を登録します: チャット、画像生成、音楽生成、動画生成、画像理解、音声 (T2A v2)、Web 検索。
プロバイダー ID認証機能
minimaxAPI キーテキスト、画像生成、音楽生成、動画生成、画像理解、音声、Web 検索
minimax-portalOAuthテキスト、画像生成、音楽生成、動画生成、画像理解、音声
MiniMax Coding Plan の紹介リンク (10% オフ): MiniMax Coding Plan

組み込みカタログ

モデル種類説明
MiniMax-M3チャット (推論)デフォルトのホスト型推論モデル
MiniMax-M2.7チャット (推論)以前のホスト型推論モデル
MiniMax-M2.7-highspeedチャット (推論)より高速な M2.7 推論ティア
MiniMax-VL-01ビジョン画像理解モデル
image-01画像生成テキストから画像、および画像から画像への編集
music-2.6音楽生成デフォルトの音楽モデル
MiniMax-Hailuo-2.3動画生成テキストから動画、および画像から動画へのフロー
モデル参照は認証パスに従います。API キー設定では minimax/<model>、OAuth 設定では minimax-portal/<model> です。

はじめに

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

オンボーディングを実行

openclaw onboard --auth-choice minimax-global-oauth
結果のプロバイダーベース URL: api.minimax.io
2

モデルが利用可能か確認

openclaw models list --provider minimax-portal
OAuth 設定では minimax-portal プロバイダー ID を使用します。モデル参照は minimax-portal/MiniMax-M3 形式に従います。

openclaw configure による設定

1

ウィザードを起動

openclaw configure
2

モデル/認証を選択

メニューから モデル/認証 を選択します。
3

MiniMax 認証オプションを選択

認証の選択肢説明
minimax-global-oauth国際 OAuth (Coding Plan)
minimax-cn-oauth中国 OAuth (Coding Plan)
minimax-global-api国際 API キー
minimax-cn-api中国 API キー
4

デフォルトモデルを選ぶ

プロンプトが表示されたら、デフォルトモデルを選択します。

機能

画像生成

MiniMax plugin は、minimaxminimax-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
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
画像生成は常に MiniMax 専用の画像エンドポイント (/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-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 から 48kHz Opus に ffmpeg でトランスコードされます。たとえば Feishu/Lark ファイル API は、ネイティブ音声メッセージに対して file_type: "opus" のみを受け付けるためです
  • MiniMax T2A は小数の speedvol を受け付けますが、pitch は整数として送信されます。OpenClaw は API リクエスト前に小数の pitch 値を切り捨てます
設定環境変数デフォルト説明
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax T2A API ホスト。
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS モデル ID。
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narrator音声出力に使用される音声 ID。
messages.tts.providers.minimax.speed1.0再生速度、0.5..2.0
messages.tts.providers.minimax.vol1.0音量、(0, 10]
messages.tts.providers.minimax.pitch0整数のピッチシフト、-12..12

音楽生成

バンドルされた MiniMax plugin は、minimaxminimax-portal の両方で共有 music_generate ツールを通じて音楽生成を登録します。
  • デフォルト音楽モデル: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
  • music-2.6-freemusic-covermusic-cover-free にも対応
  • プロンプト制御: lyrics, instrumental
  • 出力形式: mp3
  • セッションに裏付けられた実行は、action: "status" を含む共有タスク/ステータスフローを通じて切り離されます
{
  agents: {
    defaults: {
      musicGenerationModel: { primary: "minimax/music-2.6" },
    },
  },
}
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、音楽生成 を参照してください。

動画生成

バンドルされた 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 (768P または Hailuo 2.3/02 モデルの 1080P) に対応。aspectRatio は未対応で、無視されます
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },
    },
  },
}
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、動画生成を参照してください。

画像理解

MiniMax Plugin は、テキストカタログとは別に画像理解を登録します。
プロバイダー IDデフォルト画像モデルPDF テキスト抽出
minimaxMiniMax-VL-01MiniMax-M2.7
minimax-portalMiniMax-VL-01MiniMax-M2.7
そのため、バンドルされたテキストプロバイダーカタログに M3 の画像対応チャット参照も含まれている場合でも、自動メディアルーティングは MiniMax の画像理解を使用できます。PDF 理解はテキスト抽出にのみ 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_KEYMINIMAX_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.baseUrlhttps://api.minimax.io/anthropic(Anthropic 互換)を推奨します。https://api.minimax.io/v1 は OpenAI 互換ペイロード用の任意設定です
models.providers.minimax.apianthropic-messages を推奨します。openai-completions は OpenAI 互換ペイロード用の任意設定です
models.providers.minimax.apiKeyMiniMax API キー(MINIMAX_API_KEY
models.providers.minimax.modelsidnamereasoningcontextWindowmaxTokenscost を定義します
agents.defaults.modelsallowlist に入れたいモデルのエイリアスを設定します
models.mode組み込みに加えて MiniMax を追加したい場合は merge のままにします
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-M3off, adaptiveadaptive
MiniMax-M2.xoff, minimal, low, medium, highoff
/fast on または params.fastMode: true は、Anthropic 互換ストリームパス(api: "anthropic-messages"、プロバイダー minimax または minimax-portal)で MiniMax-M2.7MiniMax-M2.7-highspeed に書き換えます。
最適な用途: 最も強力な最新世代モデルをプライマリとして維持し、MiniMax M2.7 にフェイルオーバーします。以下の例では具体的なプライマリとして Opus を使用しています。好みの最新世代プライマリモデルに置き換えてください。
{
  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 を使用する 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 ウィンドウを区別しやすくなります。
  • 使用量スナップショットは、minimaxminimax-cnminimax-portalminimax-portal-cn を同じ MiniMax クォータサーフェスとして扱い、Coding Plan キーの env var にフォールバックする前に保存済みの MiniMax OAuth を優先します。

メモ

  • デフォルトチャットモデル: MiniMax-M3。代替チャットモデル: MiniMax-M2.7MiniMax-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 プロバイダーが設定されていない(一致するプロバイダーエントリがなく、MiniMax 認証プロファイル/env キーも見つからない)ことを意味します。修正方法:
  • 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
その後、次で再確認します:
openclaw models list
その他のヘルプ: トラブルシューティングおよび FAQ

関連

モデル選択

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

画像生成

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

音楽生成

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

動画生成

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

MiniMax Search

MiniMax Token Plan による Web 検索設定。

トラブルシューティング

一般的なトラブルシューティングと FAQ。