MiniMax

OpenClaw 的 MiniMax 提供商默认使用 MiniMax M2.7。

模型列表

• MiniMax-M2.7：默认文本模型
• MiniMax-M2.7-highspeed：更快的 M2.7 文本档位

选择配置方式

MiniMax OAuth（Coding Plan）— 推荐

适用场景： 通过 OAuth 快速接入 MiniMax Coding Plan，无需 API Key。

启用内置 OAuth 插件并完成认证：

openclaw plugins enable minimax  # 如已加载可跳过
openclaw gateway restart         # 如 gateway 已在运行需重启
openclaw onboard --auth-choice minimax-portal

选择端点时会提示：

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

详情参见 MiniMax 插件 README。

MiniMax M2.7（API Key）

适用场景： 使用兼容 Anthropic 协议的托管 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：

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-messages；也可选 openai-completions。
• models.providers.minimax.apiKey：MiniMax API Key（MINIMAX_API_KEY）。
• models.providers.minimax.models：定义 id、name、reasoning、contextWindow、maxTokens、cost。
• agents.defaults.models：为需要加入允许列表的模型设置别名。
• models.mode：保持 merge 以在内置模型基础上追加 MiniMax。

注意事项

• 模型引用格式：minimax/<model>。
• 默认文本模型：MiniMax-M2.7。
• 快速文本模型：MiniMax-M2.7-highspeed。
• Coding Plan 用量 API：https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains（需要 Coding Plan Key）。
• 如需精确费用追踪，请在 models.json 中更新价格字段。
• MiniMax Coding Plan 优惠链接（9折）：https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
• 提供商规则参见 /openclaw/concepts/model-providers。
• 使用 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 分支运行），然后重启 gateway。
• 运行 openclaw configure 并选择 MiniMax 认证选项，或
• 手动添加 models.providers.minimax 配置块，或
• 设置 MINIMAX_API_KEY（或 MiniMax 认证配置），让提供商自动注入。

注意模型 ID 区分大小写：

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

然后用以下命令验证：

openclaw models list