---
summary: "在 OpenClaw 中使用 MiniMax M2.1"
read_when:
  - 您想要在 OpenClaw 中使用 MiniMax 模型
  - 您需要 MiniMax 设置指导
---
# MiniMax

MiniMax 是一家构建 **M2/M2.1** 模型系列的 AI 公司。当前专注于编码的版本是 **MiniMax M2.1**（2025年12月23日发布），专为现实世界的复杂任务而构建。

来源：[MiniMax M2.1 发布说明](https://www.minimax.io/news/minimax-m21)

## 模型概览 (M2.1)

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

- 更强的**多语言编码**能力（Rust、Java、Go、C++、Kotlin、Objective-C、TS/JS）。
- 更好的**网页/应用开发**和美学输出质量（包括原生移动应用）。
- 改进的**复合指令**处理，适用于办公风格的工作流程，基于交错思维和集成约束执行。
- **更简洁的响应**，降低令牌使用量和更快的迭代循环。
- 更强的**工具/代理框架**兼容性和上下文管理（Claude Code、Droid/Factory AI、Cline、Kilo Code、Roo Code、BlackBox）。
- 更高质量的**对话和技术写作**输出。

## MiniMax M2.1 vs MiniMax M2.1 Lightning

- **速度：** Lightning 是 MiniMax 定价文档中的"快速"变体。
- **成本：** 定价显示相同的输入成本，但 Lightning 的输出成本更高。
- **编码计划路由：** Lightning 后端在 MiniMax
  编码计划中无法直接使用。MiniMax 自动将大多数请求路由到 Lightning，但在流量高峰期间会回退到常规的 M2.1 后端。

## 选择设置

### MiniMax OAuth（编码计划）— 推荐

**最适合：** 通过 OAuth 快速设置 MiniMax 编码计划，无需 API 密钥。

启用捆绑的 OAuth 插件并进行身份验证：

```bash
openclaw-cn plugins enable minimax-portal-auth  # 如果已加载则跳过。
openclaw-cn gateway restart  # 如果网关已在运行则重启
openclaw-cn onboard --auth-choice minimax-portal
```
系统将提示您选择端点：
- **Global** - 国际用户 (`api.minimax.io`)
- **CN** - 中国用户 (`api.minimaxi.com`)

详情请参见 [MiniMax OAuth 插件 README](https://github.com/moltbot/moltbot/tree/main/extensions/minimax-portal-auth)。

### MiniMax M2.1（API 密钥）

**最适合：** 使用与 Anthropic 兼容 API 的托管 MiniMax。

通过 CLI 配置：
- 运行 `clawdbot-cn configure`
- 选择 **模型/认证**
- 选择 **MiniMax M2.1**

```json5
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.1" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M2.1",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 15, output: 60, cacheRead: 2, cacheWrite: 10 },
            contextWindow: 200000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}
```

### MiniMax M2.1 作为备选（Opus 为主）

**最适合：** 保持 Opus 4.5 为主要模型，故障转移到 MiniMax M2.1。

```json5
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "minimax/MiniMax-M2.1": { alias: "minimax" }
      },
      model: {
        primary: "anthropic/claude-opus-4-5",
        fallbacks: ["minimax/MiniMax-M2.1"]
      }
    }
  }
}
```

### 可选：通过 LM Studio 本地运行（手动）

**最适合：** 使用 LM Studio 进行本地推理。
我们在强大的硬件上（例如桌面/服务器）使用 LM Studio 的本地服务器看到了 MiniMax M2.1 的强劲结果。

通过 `openclaw.json` 手动配置：

```json5
{
  agents: {
    defaults: {
      model: { primary: "lmstudio/minimax-m2.1-gs32" },
      models: { "lmstudio/minimax-m2.1-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.1-gs32",
            name: "MiniMax M2.1 GS32",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}
```

## 通过 `clawdbot-cn configure` 配置

使用交互式配置向导设置 MiniMax 而无需编辑 JSON：

1) 运行 `clawdbot-cn configure`。
2) 选择 **模型/认证**。
3) 选择 **MiniMax M2.1**。
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>`。
- 编码计划使用 API：`https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains`（需要编码计划密钥）。
- 如果需要精确的成本跟踪，请更新 `models.json` 中的定价值。
- MiniMax 编码计划推荐链接（享受 10% 折扣）：https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link
- 请参见 [/concepts/model-providers](/concepts/model-providers) 了解提供商规则。
- 使用 `openclaw-cn models list` 和 `openclaw-cn models set minimax/MiniMax-M2.1` 进行切换。

## 故障排除

### "未知模型：minimax/MiniMax-M2.1"

这通常意味着**MiniMax 提供商未配置**（未找到提供商条目和 MiniMax 认证配置文件/环境密钥）。此检测的修复程序在**2026.1.12**中（撰写时未发布）。修复方法：
- 升级到 **2026.1.12**（或从源码 `main` 运行），然后重启网关。
- 运行 `clawdbot-cn configure` 并选择 **MiniMax M2.1**，或
- 手动添加 `models.providers.minimax` 块，或
- 设置 `MINIMAX_API_KEY`（或 MiniMax 认证配置文件）以便可以注入提供商。

确保模型 ID 是**区分大小写**的：
- `minimax/MiniMax-M2.1`
- `minimax/MiniMax-M2.1-lightning`

然后重新检查：
```bash
openclaw-cn models list
```
