在 OpenClaw 中配置 MiniMax M2.1：快速提升編碼效能

想要在你的專案中整合強大的大模型，但又不想被複雜的 API 設定搞得頭大嗎？MiniMax 在推理能力和圖片生成上的表現都非常出色，這篇教學會教你如何在 OpenClaw 中快速搞定 MiniMax 的配置。

無論你是想使用最新的文字模型，還是需要高品質的圖片生成功能，OpenClaw 都能讓你透過簡單的指令或設定檔輕鬆完成整合。

MiniMax

OpenClaw 的 MiniMax provider 預設使用 MiniMax M2.7。

模型陣容

MiniMax-M2.7: 預設的託管文字模型。
MiniMax-M2.7-highspeed: 更快的 M2.7 文字層級。
image-01: 圖片生成模型（支援生成與圖生圖編輯）。

圖片生成

MiniMax 插件為 image_generate 工具註冊了 image-01 模型。它支援：

文字生成圖片，具備長寬比控制功能。
圖生圖編輯（主體參考），具備長寬比控制功能。
支援的長寬比：1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9。

若要使用 MiniMax 進行圖片生成，請將其設定為圖片生成 provider：

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

該插件使用與文字模型相同的 MINIMAX_API_KEY 或 OAuth 認證。如果已經設定好 MiniMax，則不需要額外的配置。

選擇設定方式

MiniMax OAuth (Coding Plan) - 推薦

最適合： 透過 OAuth 快速設定 MiniMax Coding Plan，不需要 API key。

啟用內建的 OAuth 插件並進行認證：

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

系統會提示你選擇一個 endpoint：

Global - 國際用戶 (api.minimax.io)
CN - 中國用戶 (api.minimaxi.com)

詳細資訊請參閱 OpenClaw 儲存庫中 MiniMax 插件套件的 README。

MiniMax M2.7 (API key)

最適合： 使用與 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` 進行設定

使用互動式設定精靈來設定 MiniMax，無需手動編輯 JSON：

執行 openclaw configure。
選擇 Model/auth。
選擇一個 MiniMax 認證選項。
根據提示挑選你的預設模型。

設定選項

models.providers.minimax.baseUrl: 建議使用 https://api.minimax.io/anthropic (Anthropic 相容)；https://api.minimax.io/v1 可用於 OpenAI 相容的內容。
models.providers.minimax.api: 建議使用 anthropic-messages；openai-completions 可用於 OpenAI 相容的內容。
models.providers.minimax.apiKey: MiniMax API key (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 key)。
如果你需要精確的成本追蹤，請更新 models.json 中的價格數值。
MiniMax Coding Plan 推薦連結 (10% 折扣)：https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
關於 provider 規則，請參閱 /concepts/model-providers。
使用 openclaw models list 和 openclaw models set minimax/MiniMax-M2.7 來進行切換。

疑難排解

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

這通常表示 MiniMax provider 尚未設定（找不到 provider 項目，也沒有 MiniMax 認證設定檔或環境變數金鑰）。針對此偵測問題的修復已包含在 2026.1.12 版本中。修復方法如下：

升級到 2026.1.12 (或從原始碼 main 分支執行)，然後重啟 gateway。
執行 openclaw configure 並選擇一個 MiniMax 認證選項，或者
手動添加 models.providers.minimax 區塊，或者
設定 MINIMAX_API_KEY (或 MiniMax 認證設定檔)，以便注入 provider。

請確保模型 ID 區分大小寫：

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

然後使用以下指令重新檢查：

openclaw models list

下一步

想要獲得更個人化的設定建議嗎？試試我們的 AI Setup Assistant。

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。