MiniMax

MiniMax 是一家 AI 公司,開發了 M2/M2.5 模型系列。目前以程式碼為主的版本是 MiniMax M2.5(2025 年 12 月 23 日發布),專為實際的複雜任務打造。

來源:MiniMax M2.5 發布公告

模型概覽(M2.5)

MiniMax 強調 M2.5 的以下改進:

  • 更強的多語言程式碼能力(Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS)。
  • 更好的網頁/應用程式開發和視覺輸出品質(包含原生行動應用)。
  • 改進的複合指令處理能力,適用於辦公類工作流程,建立在交替思考和整合約束執行的基礎上。
  • 更精簡的回應,更少 token 使用量和更快的迭代循環。
  • 更強的工具/Agent 框架相容性和上下文管理(Claude Code、Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox)。
  • 更高品質的對話和技術寫作輸出。

MiniMax M2.5 vs MiniMax M2.5 Highspeed

  • 速度: MiniMax-M2.5-highspeed 是 MiniMax 文件中的官方快速層級。
  • 費用: MiniMax 定價顯示 highspeed 的輸入成本相同,輸出成本較高。
  • 目前模型 ID: 使用 MiniMax-M2.5MiniMax-M2.5-highspeed

選擇設定方式

MiniMax OAuth(Coding Plan)— 推薦

適用情境: 透過 OAuth 快速設定 MiniMax Coding Plan,不需要 API 金鑰。

啟用內建 OAuth 外掛並完成驗證:

openclaw plugins enable minimax-portal-auth  # 如果已載入則跳過
openclaw gateway restart  # 閘道已在執行時需重新啟動
openclaw onboard --auth-choice minimax-portal

系統會提示你選擇端點:

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

詳見 MiniMax OAuth plugin README

MiniMax M2.5(API 金鑰)

適用情境: 透過 Anthropic 相容 API 使用託管的 MiniMax。

透過 CLI 設定:

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

MiniMax M2.5 作為備援(範例)

適用情境: 保留最強的最新世代模型作為主要模型,MiniMax M2.5 作為備援。以下範例使用 Opus 作為具體的主要模型;可替換為你偏好的最新世代主要模型。

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "primary" },
        "minimax/MiniMax-M2.5": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.5"],
      },
    },
  },
}

選用:透過 LM Studio 本地執行(手動)

適用情境: 使用 LM Studio 進行本地推理。 我們在高效能硬體(如桌機/伺服器)上使用 LM Studio 的本地伺服器測試 MiniMax M2.5,獲得了很好的結果。

openclaw.json 中手動設定:

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.5-gs32" },
      models: { "lmstudio/minimax-m2.5-gs32": { alias: "Minimax" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      lmstudio: {
        baseUrl: "http://127.0.0.1:1234/v1",
        apiKey: "lmstudio",
        api: "openai-responses",
        models: [
          {
            id: "minimax-m2.5-gs32",
            name: "MiniMax M2.5 GS32",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

透過 openclaw configure 設定

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

  1. 執行 openclaw configure
  2. 選擇 Model/auth
  3. 選擇 MiniMax M2.5
  4. 依提示選擇預設模型。

設定選項

  • models.providers.minimax.baseUrl:建議使用 https://api.minimax.io/anthropic(Anthropic 相容);https://api.minimax.io/v1 為選用的 OpenAI 相容格式。
  • models.providers.minimax.api:建議使用 anthropic-messagesopenai-completions 為選用的 OpenAI 相容格式。
  • models.providers.minimax.apiKey:MiniMax API 金鑰(MINIMAX_API_KEY)。
  • models.providers.minimax.models:定義 idnamereasoningcontextWindowmaxTokenscost
  • agents.defaults.models:為你想要加入允許清單的模型設定別名。
  • models.mode:如果要在內建模型之外加入 MiniMax,請保持 merge

注意事項

  • 模型參考格式為 minimax/<model>
  • 建議使用的模型 ID:MiniMax-M2.5MiniMax-M2.5-highspeed
  • Coding Plan 用量 API:https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains(需要 coding plan 金鑰)。
  • 如需精確的費用追蹤,請更新 models.json 中的價格值。
  • MiniMax Coding Plan 推薦連結(九折優惠):https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
  • 詳見 /concepts/model-providers 了解供應商規則。
  • 使用 openclaw models listopenclaw models set minimax/MiniMax-M2.5 來切換。

疑難排解

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

這通常表示 MiniMax 供應商未設定(沒有供應商項目,也找不到 MiniMax 驗證設定檔/環境金鑰)。此偵測問題的修正在 2026.1.12 版本中(撰寫時尚未發布)。修正方式:

  • 升級到 2026.1.12(或從原始碼 main 分支執行),然後重新啟動閘道。
  • 執行 openclaw configure 並選擇 MiniMax M2.5,或
  • 手動加入 models.providers.minimax 區塊,或
  • 設定 MINIMAX_API_KEY(或 MiniMax 驗證設定檔)讓供應商可以被注入。

請注意模型 ID 區分大小寫

  • minimax/MiniMax-M2.5
  • minimax/MiniMax-M2.5-highspeed

然後再次確認:

openclaw models list