メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw の MiniMax プロバイダーは、デフォルトで MiniMax M2.7 を使用します。 MiniMax は次も提供します。
  • T2A v2 による同梱の音声合成
  • MiniMax-VL-01 による同梱の画像理解
  • music-2.6 による同梱の音楽生成
  • MiniMax Token Plan 検索 API による同梱の web_search
プロバイダーの分割:
Provider ID認証機能
minimaxAPI keyテキスト、画像生成、音楽生成、動画生成、画像理解、音声、ウェブ検索
minimax-portalOAuthテキスト、画像生成、音楽生成、動画生成、画像理解、音声

​
組み込みカタログ

モデル種類説明
MiniMax-M2.7チャット (推論)デフォルトのホスト型推論モデル
MiniMax-M2.7-highspeedチャット (推論)より高速な M2.7 推論ティア
MiniMax-VL-01Vision画像理解モデル
image-01画像生成テキストから画像、画像から画像への編集
music-2.6音楽生成デフォルトの音楽モデル
music-2.5音楽生成以前の音楽生成ティア
music-2.0音楽生成レガシーな音楽生成ティア
MiniMax-Hailuo-2.3動画生成テキストから動画、画像参照フロー

​
はじめに

希望する認証方法を選び、セットアップ手順に従います。
最適な用途: OAuth 経由の MiniMax Coding Plan によるクイックセットアップ。API key は不要です。
1

オンボーディングを実行

openclaw onboard --auth-choice minimax-global-oauth
これにより api.minimax.io に対して認証します。
2

モデルが利用可能であることを確認

openclaw models list --provider minimax-portal
OAuth セットアップでは minimax-portal プロバイダー ID を使用します。モデル参照は minimax-portal/MiniMax-M2.7 の形式に従います。
MiniMax Coding Plan の紹介リンク (10% オフ): MiniMax Coding Plan

​
openclaw configure で設定

JSON を編集せずに MiniMax を設定するには、対話型の設定ウィザードを使用します。
1

ウィザードを起動する

openclaw configure
2

モデル/認証を選択する

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

MiniMax の認証オプションを選ぶ

利用可能な MiniMax オプションのいずれかを選びます。
認証の選択肢説明
minimax-global-oauth国際 OAuth (Coding Plan)
minimax-cn-oauth中国 OAuth (Coding Plan)
minimax-global-api国際 API キー
minimax-cn-api中国 API キー
4

デフォルトモデルを選ぶ

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

​
機能

​
画像生成

MiniMax plugin は、image_generate ツール用に image-01 モデルを登録します。次をサポートします。
  • アスペクト比制御付きのテキストから画像の生成
  • アスペクト比制御付きの画像から画像の編集 (被写体参照)
  • リクエストごとに最大 9 枚の出力画像
  • 編集リクエストごとに最大 1 枚の参照画像
  • サポートされるアスペクト比: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
MiniMax を画像生成に使用するには、画像生成プロバイダーとして設定します。 
{
  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-M2.7 と MiniMax-M2.7-highspeed をテキスト専用チャットモデルとして実体化します。画像理解は plugin 所有の MiniMax-VL-01 メディアプロバイダーを通じて別途公開されます。
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については 画像生成 を参照してください。

​
テキスト読み上げ

同梱の 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 などの音声メモターゲットは、Feishu/Lark ファイル API が ネイティブ音声メッセージに対して file_type: "opus" のみを受け付けるため、 ffmpeg で MiniMax MP3 から 48kHz Opus にトランスコードされます。
  • MiniMax T2A は小数の speed と vol を受け付けますが、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 は、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, durationSeconds
  • 出力形式: mp3
  • セッションに基づく実行は、action: "status" を含む共有タスク/ステータスフローを通じて切り離されます
MiniMax をデフォルトの音楽プロバイダーとして使用するには: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については 音楽生成 を参照してください。

​
動画生成

同梱の MiniMax plugin は、minimax と minimax-portal の両方に対して、共有 video_generate ツールを通じた動画生成を登録します。
  • デフォルト動画モデル: minimax/MiniMax-Hailuo-2.3
  • OAuth 動画モデル: minimax-portal/MiniMax-Hailuo-2.3
  • モード: テキストから動画、および単一画像参照フロー
  • aspectRatio と resolution をサポートします
MiniMax をデフォルトの動画プロバイダーとして使用するには: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
共有ツールパラメーター、プロバイダー選択、フェイルオーバー動作については、動画生成を参照してください。

​
画像理解

MiniMax Plugin は、画像理解をテキストカタログとは別に登録します。
プロバイダー IDデフォルトの画像モデル
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
そのため、バンドルされたテキストプロバイダーカタログにテキスト専用の M2.7 チャット参照がまだ表示されている場合でも、自動メディアルーティングで MiniMax の画像理解を使用できます。

​
Web 検索

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.* の下にあります。
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.modelsid、name、reasoning、contextWindow、maxTokens、cost を定義します
agents.defaults.models許可リストに入れたいモデルにエイリアスを設定します
models.modeビルトインと並べて MiniMax を追加したい場合は merge のままにします
api: "anthropic-messages" では、params/config で思考がすでに明示的に設定されていない限り、OpenClaw は thinking: { type: "disabled" } を注入します。これにより、MiniMax のストリーミングエンドポイントが OpenAI 形式のデルタチャンクで reasoning_content を出力し、内部推論が表示出力に漏れることを防ぎます。
/fast on または params.fastMode: true は、Anthropic 互換ストリームパスで MiniMax-M2.7 を MiniMax-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 を使用するグローバル設定は 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 vars にフォールバックする前に保存済みの MiniMax OAuth を優先します。

​
注記

  • モデル参照は認証パスに従います。
    • API キー設定: minimax/<model>
    • OAuth 設定: minimax-portal/<model>
  • デフォルトのチャットモデル: MiniMax-M2.7
  • 代替チャットモデル: MiniMax-M2.7-highspeed
  • オンボーディングと直接の API キー設定は、両方の M2.7 バリアントに対してテキスト専用モデル定義を書き込みます
  • 画像理解は、Plugin 所有の MiniMax-VL-01 メディアプロバイダーを使用します
  • 正確なコスト追跡が必要な場合は、models.json の価格値を更新してください
  • openclaw models list を使用して現在のプロバイダー ID を確認し、その後 openclaw models set minimax/MiniMax-M2.7 または openclaw models set minimax-portal/MiniMax-M2.7 で切り替えてください
MiniMax Coding Plan の紹介リンク（10% オフ）: MiniMax Coding Plan
プロバイダールールについては、モデルプロバイダーを参照してください。

​
トラブルシューティング

これは通常、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-M2.7 または minimax/MiniMax-M2.7-highspeed
  • OAuth パス: minimax-portal/MiniMax-M2.7 または minimax-portal/MiniMax-M2.7-highspeed
その後、次で再確認してください。
openclaw models list
さらに詳しいヘルプ: トラブルシューティングとFAQ。

​
関連

モデル選択

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

画像生成

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

音楽生成

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

動画生成

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

MiniMax Search

MiniMax Token Plan 経由の Web 検索設定。

トラブルシューティング

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