codecamp

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 配置:

  1. 运行 openclaw configure
  2. 选择 Model/auth
  3. 选择 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:

  1. 运行 openclaw configure
  2. 选择 Model/auth
  3. 选择 MiniMax 认证选项
  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:定义模型的 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 listopenclaw models set minimax/MiniMax-M2.7 来切换模型

故障排查

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

这通常意味着 MiniMax 提供商未完成配置(未找到提供商条目,也未找到 MiniMax 认证配置或环境变量)。该问题的修复方案已在 2026.1.12 版本中。你可以通过以下方式修复:

  1. 升级到 2026.1.12 版本(或从源码 main 分支运行),然后重启网关
  2. 运行 openclaw configure 并选择 MiniMax 认证选项,或者
  3. 手动添加 models.providers.minimax 配置块,或者
  4. 设置 MINIMAX_API_KEY(或 MiniMax 认证配置),让提供商可以自动注入

请注意模型 ID 是区分大小写的:

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

完成后可以通过以下命令重新检查:

openclaw models list
OpenClaw LiteLLM 提供商配置指南
OpenClaw Mistral 提供商配置指南
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

OpenClaw 消息渠道

OpenClaw 工具

OpenClaw 模型

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }