MiniMax
MiniMax 是一家 AI 公司,開發了 M2/M2.5 模型系列。目前以程式碼為主的版本是 MiniMax M2.5(2025 年 12 月 23 日發布),專為實際的複雜任務打造。
模型概覽(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.5或MiniMax-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:
- 執行
openclaw configure。 - 選擇 Model/auth。
- 選擇 MiniMax M2.5。
- 依提示選擇預設模型。
設定選項
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 金鑰(MINIMAX_API_KEY)。models.providers.minimax.models:定義id、name、reasoning、contextWindow、maxTokens、cost。agents.defaults.models:為你想要加入允許清單的模型設定別名。models.mode:如果要在內建模型之外加入 MiniMax,請保持merge。
注意事項
- 模型參考格式為
minimax/<model>。 - 建議使用的模型 ID:
MiniMax-M2.5和MiniMax-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 list和openclaw 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.5minimax/MiniMax-M2.5-highspeed
然後再次確認:
openclaw models list