OpenClaw 🦞

MiniMax

MiniMax

MiniMax 是一家构建 M2/M2.5 模型家族的 AI 公司。当前的编码聚焦版本是 MiniMax M2.5（2025 年 12 月 23 日），专为现实世界复杂任务构建。

来源：MiniMax M2.5 发布说明

模型概述（M2.5）

MiniMax 在 M2.5 中强调了这些改进：

  • 更强的多语言编码（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。
  • 更好的Web/应用开发和美学输出质量（包括原生移动）。
  • 改进的复合指令处理，适用于办公室风格工作流，建立在交错思考和集成约束执行之上。
  • 更简洁的响应，令牌使用量更低，迭代循环更快。
  • 更强的工具/代理框架兼容性和上下文管理（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。
  • 兼容性： OpenClaw 仍然接受遗留 MiniMax-M2.5-Lightning 配置，但新设置更喜欢 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 插件 README。

MiniMax M2.5（API 密钥）

最适合： 托管 MiniMax 与 Anthropic 兼容 API。

通过 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: false,
            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-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 推荐链接（9 折优惠）：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 身份验证 profile/环境密钥）。此检测的修复在 2026.1.12 中（撰写时未发布）。修复方法：

  • 升级到 2026.1.12（或从源代码 main 运行），然后重启网关。
  • 运行 openclaw configure 并选择 MiniMax M2.5，或
  • 手动添加 models.providers.minimax 块，或
  • 设置 MINIMAX_API_KEY（或 MiniMax 身份验证 profile）以便可以注入提供商。

确保模型 id 是区分大小写的：

  • minimax/MiniMax-M2.5
  • minimax/MiniMax-M2.5-highspeed
  • minimax/MiniMax-M2.5-Lightning（遗留）

然后重新检查：

openclaw models list