OpenClaw MiniMax 提供商配置指南
MiniMax 是一家专注于打造高性能 AI 模型的公司,OpenClaw 的 MiniMax 提供商默认适配 MiniMax M2.7 模型。
模型系列
当前 MiniMax 提供了两个托管文本模型:
- MiniMax-M2.7:默认托管文本模型,面向复杂编码任务优化
- MiniMax-M2.7-highspeed:M2.7 的极速版本,提供更快的推理速度
选择配置方式
MiniMax OAuth(编码计划)—— 推荐
适用场景:通过 OAuth 快速配置 MiniMax 编码计划,无需手动输入 API 密钥。
启用内置的 OAuth 插件并完成认证:
openclaw plugins enable minimax # 若已加载可跳过
openclaw gateway restart # 若网关已运行,需重启
openclaw onboard --auth-choice minimax-portal
你会被提示选择接入端点:
- Global - 国际用户(
api.minimax.io) - CN - 中国区用户(
api.minimaxi.com)
详情可参考: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 配置
你可以使用交互式配置向导来设置 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 密钥(对应环境变量MINIMAX_API_KEY)models.providers.minimax.models:定义模型的 id、名称、推理能力、上下文窗口、最大 Token、成本agents.defaults.models:为你想要加入白名单的模型设置别名models.mode:如果你想要将 MiniMax 与内置模型合并,保持为merge
注意事项
- 模型引用格式为
minimax/<model> - 默认文本模型:
MiniMax-M2.7 - 备选文本模型:
MiniMax-M2.7-highspeed - 编码计划用量 API:
https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains(需要编码计划密钥) - 如果你需要精确的成本追踪,请更新
models.json中的定价数值 - MiniMax 编码计划推荐链接(享 9 折):
https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link - 更多提供商规则可参考:模型提供商概念
- 你可以使用
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 分支运行),然后重启网关
- 运行
openclaw configure并选择 MiniMax 认证选项,或者 - 手动添加
models.providers.minimax配置块,或者 - 设置
MINIMAX_API_KEY(或 MiniMax 认证配置),让提供商可以自动注入
请注意模型 ID 是区分大小写的:
minimax/MiniMax-M2.7minimax/MiniMax-M2.7-highspeed
完成后可以通过以下命令重新检查:
openclaw models list