MiniMax
MiniMax 是一家构建 M2/M2.5 模型家族的 AI 公司。当前聚焦编码的版本是 MiniMax M2.5（2025 年 12 月 23 日发布），专为现实世界的复杂任务设计。
MiniMax M2.5 在多语言编码、Web/应用开发、复合指令处理等方面表现出色。
模型概览
MiniMax M2.5 核心能力
多语言编码
支持 Rust、Java、Go、C++、Kotlin、Objective-C、TypeScript/JavaScript 等主流编程语言
Web/应用开发
优化的 Web 和移动应用开发能力，包括原生移动端开发
复合指令处理
基于交叉式思维和集成约束执行，支持办公类工作流
模型对比
| 特性 | MiniMax-M2.5 | MiniMax-M2.5-highspeed |
|---|
| 速度 | 标准 | 高速（官方高速等级） |
| 输入成本 | 0.3 / 1M tokens | 0.3 / 1M tokens |
| 输出成本 | 1.2 / 1M tokens | 1.2 / 1M tokens（更高） |
| 上下文窗口 | 200,000 tokens | 200,000 tokens |
| 最大输出 | 8,192 tokens | 8,192 tokens |
OpenClaw 仍支持旧版的 MiniMax-M2.5-Lightning 配置，但新建设置建议使用 MiniMax-M2.5-highspeed。
配置方式
OAuth（推荐）
API 密钥
本地运行（LM Studio）
MiniMax OAuth（编码计划）
通过 OAuth 快速设置 MiniMax 编码计划，无需手动管理 API 密钥。启用插件
openclaw plugins enable minimax-portal-auth
运行认证
openclaw onboard --auth-choice minimax-portal
- Global - 国际用户（
api.minimax.io）
- CN - 中国用户（
api.minimaxi.com）
完成 OAuth
按照提示在浏览器中完成 OAuth 认证流程。
MiniMax API 密钥
使用支持 Anthropic 兼容 API 的托管 MiniMax。运行配置向导
选择 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 高速版",
"reasoning": true,
"input": ["text"],
"cost": {
"input": 0.3,
"output": 1.2,
"cacheRead": 0.03,
"cacheWrite": 0.12
},
"contextWindow": 200000,
"maxTokens": 8192
}
]
}
}
}
}
通过 LM Studio 本地运行
适用于在高性能硬件上本地运行 MiniMax M2.5。加载 MiniMax 模型
在 LM Studio 中搜索并加载 MiniMax M2.5 模型。
启动本地服务器
在 LM Studio 中启动本地 API 服务器（默认端口 1234）。
配置 OpenClaw
{
"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": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 196608,
"maxTokens": 8192
}
]
}
}
}
}
故障切换配置
将 MiniMax M2.5 作为主模型的故障切换选项：
{
"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"]
}
}
}
}
配置选项说明
提供商配置
| 参数 | 说明 | 推荐值 |
|---|
baseUrl | API 端点 | https://api.minimax.io/anthropic（Anthropic 兼容）或 https://api.minimax.io/v1（OpenAI 兼容） |
api | API 类型 | anthropic-messages（推荐）或 openai-completions |
apiKey | API 密钥 | ${MINIMAX_API_KEY} |
模型配置
| 参数 | 说明 | 示例值 |
|---|
id | 模型 ID | MiniMax-M2.5 或 MiniMax-M2.5-highspeed |
name | 显示名称 | MiniMax M2.5 |
reasoning | 推理能力 | true |
contextWindow | 上下文窗口 | 200000 |
maxTokens | 最大输出 | 8192 |
Agent 配置
| 参数 | 说明 |
|---|
agents.defaults.models | 为允许使用的模型设置别名 |
models.mode | 设置为 merge 以在内置模型旁添加 MiniMax |
命令行工具
# 列出所有可用模型
openclaw models list
# 切换到 MiniMax M2.5
openclaw models set minimax/MiniMax-M2.5
# 切换到高速版
openclaw models set minimax/MiniMax-M2.5-highspeed
# 查看当前认证状态
openclaw models status
故障排除
Unknown model: minimax/MiniMax-M2.5
问题： OpenClaw 无法识别 MiniMax 模型。
原因： MiniMax 提供商未配置（无提供商条目，且未找到 MiniMax 认证配置或环境变量）。
解决方案：
配置提供商
运行配置向导：openclaw configure
# 选择 Model/auth → MiniMax M2.5
export MINIMAX_API_KEY="sk-..."
模型 ID 区分大小写：
minimax/MiniMax-M2.5 ✓minimax/MiniMax-M2.5-highspeed ✓minimax/MiniMax-M2.5-Lightning ✓（旧版）minimax/minimax-m2.5 ✗（错误）
API 密钥无效
问题： 收到 401 Unauthorized 错误。
解决方案：
- 验证 API 密钥是否正确：
- 检查 API 密钥是否在 MiniMax 平台有效
- 重新生成 API 密钥并更新配置
OAuth 认证失败
问题： OAuth 流程无法完成。
解决方案：
- 确认插件已启用：
openclaw plugins list | grep minimax
- 重启网关：
- 重新运行认证：
openclaw onboard --auth-choice minimax-portal
速率限制错误
问题： 超过 API 速率限制。
解决方案：
- 升级 MiniMax 账户计划
- 配置故障切换模型
- 实现请求速率控制
完整配置示例
{
"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"
}
}
}
}
相关资源
