MiniMax

MiniMax 是一家 AI 公司，开发了 M2/M2.5 系列模型。当前面向编码的最新版本是 MiniMax M2.5（2025 年 12 月 23 日发布），专为真实世界的复杂任务打造。

来源：MiniMax M2.5 发布说明

模型概览（M2.5）

MiniMax 在 M2.5 中强调了以下改进：

更强的多语言编码能力（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。
更好的 Web/App 开发和审美输出质量（包括原生移动端）。
改进的复合指令处理能力，适用于办公风格工作流，基于交替思考和集成约束执行。
更简洁的回复，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  # Gateway 已在运行时需要重启
openclaw onboard --auth-choice minimax-portal

会提示你选择端点：

Global - 国际用户（api.minimax.io）
CN - 中国用户（api.minimaxi.com）

详见 MiniMax OAuth 插件 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：保持 merge 即可在内置模型基础上添加 MiniMax。

补充说明

模型引用格式为 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 provider 未配置（没有 provider 条目，也没找到 MiniMax 认证 profile 或环境变量密钥）。相关修复在 2026.1.12 中（编写时尚未发布）。解决方法：

升级到 2026.1.12（或从源码 main 分支运行），然后重启 Gateway。
运行 openclaw configure 并选择 MiniMax M2.5，或者
手动添加 models.providers.minimax 配置块，或者
设置 MINIMAX_API_KEY（或 MiniMax 认证 profile）让 provider 可以被注入。

注意模型 ID 区分大小写：

minimax/MiniMax-M2.5
minimax/MiniMax-M2.5-highspeed

然后重新检查：

openclaw models list