OpenClawでMiniMax M2.1をセットアップ：3分で接続完了

開発を進める中で、新しいAIモデルを試すたびに複雑な設定に頭を悩ませることはありませんか？特にテキスト生成と画像生成を一つのワークフローにまとめようとすると、認証やAPIの管理が煩雑になりがちです。

OpenClawを使えば、MiniMaxのような強力なプロバイダーもスムーズに導入できます。ここでは、MiniMaxを最大限に活用するための設定方法を分かりやすく解説します。

MiniMax

OpenClawのMiniMaxプロバイダーは、デフォルトで MiniMax M2.7 を使用します。

モデルラインナップ

MiniMax-M2.7: デフォルトのホスト型テキストモデルです。
MiniMax-M2.7-highspeed: より高速なM2.7テキスト層です。
image-01: 画像生成モデル（生成およびImage-to-Image編集）です。

画像生成

MiniMaxプラグインは、image_generate ツール用に image-01 モデルを登録します。以下の機能をサポートしています。

アスペクト比の制御が可能な Text-to-Image生成。
アスペクト比の制御が可能な Image-to-Image編集（被写体参照）。
サポートされているアスペクト比: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9。

MiniMaxを画像生成に使用するには、画像生成プロバイダーとして設定してください。

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

このプラグインは、テキストモデルと同じ MINIMAX_API_KEY または OAuth認証を使用します。MiniMaxが既にセットアップされている場合、追加の設定は不要です。

セットアップ方法の選択

MiniMax OAuth (Coding Plan) - 推奨

最適: OAuth経由でMiniMax Coding Planを素早くセットアップしたい場合。APIキーは不要です。

同梱されている OAuthプラグインを有効にして認証を行います。

openclaw plugins enable minimax  # skip if already loaded.
openclaw gateway restart  # restart if gateway is already running
openclaw onboard --auth-choice minimax-portal

エンドポイントの選択を求められます。

Global - 国際ユーザー向け (api.minimax.io)
CN - 中国国内のユーザー向け (api.minimaxi.com)

詳細は、OpenClawリポジトリ内のMiniMaxプラグインパッケージのREADMEを参照してください。

MiniMax M2.7 (APIキー)

最適: Anthropic互換APIを使用してホスト型MiniMaxを利用したい場合。

CLIで設定します。

openclaw configure を実行
Model/auth を選択
MiniMax の認証オプションを選択

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.7",
            name: "MiniMax M2.7",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.03, cacheWrite: 0.12 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

フォールバックとしての MiniMax M2.7 (例)

最適: 最新世代の強力なモデルをメインで使用し、エラー時の予備として 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"],
      },
    },
  },
}

`openclaw configure` による設定

JSONを直接編集せずに、対話型の設定ウィザードを使用してMiniMaxを設定できます。

openclaw configure を実行します。
Model/auth を選択します。
MiniMax の認証オプションを選択します。
プロンプトが表示されたら、デフォルトのモデルを選択します。

設定オプション

models.providers.minimax.baseUrl: https://api.minimax.io/anthropic (Anthropic互換) を推奨します。OpenAI互換のペイロードを使用する場合は https://api.minimax.io/v1 も選択可能です。
models.providers.minimax.api: anthropic-messages を推奨します。OpenAI互換のペイロードを使用する場合は openai-completions も選択可能です。
models.providers.minimax.apiKey: MiniMaxのAPIキー (MINIMAX_API_KEY) です。
models.providers.minimax.models: id, name, reasoning, contextWindow, maxTokens, cost を定義します。
agents.defaults.models: 許可リストに入れたいモデルのエイリアスを設定します。
models.mode: 組み込みモデルと一緒にMiniMaxを追加したい場合は merge のままにしてください。

注意事項

モデルの参照形式は minimax/<model> です。
デフォルトのテキストモデル: MiniMax-M2.7
代替テキストモデル: MiniMax-M2.7-highspeed
Coding Planの使用状況確認API: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (Coding Planキーが必要です)。
正確なコスト追跡が必要な場合は、models.json の価格設定を更新してください。
MiniMax Coding Planの紹介リンク (10% OFF): https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
プロバイダーのルールについては /concepts/model-providers を参照してください。
モデルの切り替えには openclaw models list と openclaw models set minimax/MiniMax-M2.7 を使用してください。

トラブルシューティング

”Unknown model: minimax/MiniMax-M2.7”

このエラーは通常、MiniMaxプロバイダーが設定されていない（プロバイダーのエントリがなく、MiniMaxの認証プロファイルや環境変数キーも見つからない）ことを意味します。この検出に関する修正は 2026.1.12 で行われています。以下の方法で解決してください。

2026.1.12 以降にアップグレード（またはソースの main から実行）し、Gatewayを再起動する。
openclaw configure を実行して MiniMax の認証オプションを選択する。
models.providers.minimax ブロックを手動で追加する。
MINIMAX_API_KEY（または MiniMax認証プロファイル）を設定して、プロバイダーが注入されるようにする。

モデルIDの 大文字・小文字 が正確であることを確認してください。

minimax/MiniMax-M2.7
minimax/MiniMax-M2.7-highspeed

その後、以下で再度確認してください。

openclaw models list

設定でお困りの際は、AI Setup Assistant がお手伝いします。

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。