本页介绍如何在 OpenClaw 中配置 MiniMax 提供商。MiniMax 支持 OAuth Coding Plan（推荐）和 API Key 两种接入方式，分别对应 minimax-portal 和 minimax 两个 Provider ID。默认聊天模型为 MiniMax M2.7，另有图像生成（image-01）、视频生成（MiniMax-Hailuo-2.3）、音乐生成（music-2.5+）、图像理解（MiniMax-VL-01）和网页搜索（Coding Plan Search API）能力。

MiniMax

OpenClaw 内置 MiniMax 提供商，默认模型为 MiniMax M2.7。

MiniMax 提供了丰富的能力套件：

语音合成（T2A v2）
图像理解（MiniMax-VL-01）
音乐生成（music-2.5+）
网页搜索（Coding Plan Search API）

Provider 拆分：

minimax：API Key 文本提供商 + 图像生成、图像理解、语音和网页搜索
minimax-portal：OAuth 文本提供商 + 图像生成和图像理解

模型目录

MiniMax-M2.7：默认推理模型
MiniMax-M2.7-highspeed：更快的 M2.7 推理层
image-01：图像生成模型（支持生成和图像编辑）

选择接入方式

方式 A：MiniMax OAuth（Coding Plan）- 推荐

适用于通过 MiniMax Coding Plan 进行 OAuth 快速接入，无需 API Key。

bash

openclaw onboard --auth-choice minimax-global-oauth
# 或中国大陆用户
openclaw onboard --auth-choice minimax-cn-oauth

minimax-global-oauth：国际用户（api.minimax.io）
minimax-cn-oauth：中国用户（api.minimaxi.com）

方式 B：MiniMax API Key

适用于直接通过 Anthropic 兼容 API 访问的用法。

bash

openclaw onboard --auth-choice minimax-global-api
# 或中国大陆用户
openclaw onboard --auth-choice minimax-cn-api

配置示例：

json5

{
  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", "image"],
            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
          {
            id: "MiniMax-M2.7-highspeed",
            name: "MiniMax M2.7 Highspeed",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

注意：使用 Anthropic 兼容流式路径时，OpenClaw 默认禁用 MiniMax thinking，除非你显式设置 thinking 参数。MiniMax 的流式端点以 OpenAI 风格 delta chunk 返回 reasoning_content，未禁用时可能将内部推理泄露到可见输出中。

MiniMax M2.7 作为 Fallback 示例

json5

{
  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"],
      },
    },
  },
}

图像生成

MiniMax 通过共享 image_generate 工具注册 image-01 模型：

支持文本转图像，可控宽高比
支持图像编辑（主体参考），可控宽高比
每次最多生成 9 张图像
每次编辑最多 1 张参考图
支持宽高比：1:1、16:9、4:3、3:2、2:3、3:4、9:16、21:9

设置 MiniMax 为默认图像提供商：

json5

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

视频生成

MiniMax 通过共享 video_generate 工具注册视频生成：

默认视频模型：minimax/MiniMax-Hailuo-2.3
支持文本转视频和单图参考流程
支持 aspectRatio 和 resolution

设置 MiniMax 为默认视频提供商：

json5

{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },
    },
  },
}

音乐生成

MiniMax 通过共享 music_generate 工具注册音乐生成：

默认音乐模型：minimax/music-2.5+
也支持 minimax/music-2.5 和 minimax/music-2.0
支持控制：lyrics（歌词）、instrumental（纯器乐）、durationSeconds（时长）
输出格式：mp3

设置 MiniMax 为默认音乐提供商：

json5

{
  agents: {
    defaults: {
      musicGenerationModel: { primary: "minimax/music-2.5+" },
    },
  },
}

图像理解

MiniMax 单独注册图像理解能力（与文本目录分开）：

minimax：默认图像模型 MiniMax-VL-01
minimax-portal：默认图像模型 MiniMax-VL-01

因此即使内置文本目录只显示文本类 M2.7 条目，媒体路由仍可使用 MiniMax 图像理解。

网页搜索

MiniMax 通过 Coding Plan Search API 提供 web_search 能力：

Provider ID：minimax
返回结构化结果：标题、URL、摘要、相关查询
优先使用环境变量：MINIMAX_CODE_PLAN_KEY
兼容别名：MINIMAX_CODING_API_KEY
降级回退：当 MINIMAX_API_KEY 已指向 Coding Plan token 时也可用

配置项位于 plugins.entries.minimax.config.webSearch.*。

通过 `openclaw configure` 配置

运行 openclaw configure，在 Model/auth 选项中选择 MiniMax，然后按提示操作。

当前支持的 MiniMax auth 选项：

minimax-global-oauth
minimax-cn-oauth
minimax-global-api
minimax-cn-api

配置注意事项

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 兼容
模型 ID 区分大小写：API Key 路径用 minimax/MiniMax-M2.7；OAuth 路径用 minimax-portal/MiniMax-M2.7
/fast on 或 params.fastMode: true 自动将 MiniMax-M2.7 切换为 MiniMax-M2.7-highspeed

常见问题

Q: "Unknown model: minimax/MiniMax-M2.7" 错误怎么解决？

A: 通常是 MiniMax Provider 未配置（没有匹配的 provider 条目，也没有找到 MiniMax auth profile 或环境变量 key）。修复方法：升级到 2026.1.12 或更新版本，然后运行 openclaw configure 选择 MiniMax auth 选项，或手动添加 models.providers.minimax 配置块，再设置 MINIMAX_API_KEY 或 MINIMAX_OAUTH_TOKEN，最后用 openclaw models list 验证。

Q: MiniMax API Key 和 OAuth Coding Plan 两种方式有什么区别，我该用哪种？

A: OAuth Coding Plan 无需手动管理 API Key，适合个人开发者快速上手；API Key 方式计费更透明，适合生产环境。如果你是中国大陆用户，分别对应 minimax-cn-oauth 和 minimax-cn-api。注意两种方式的模型 ID 前缀不同：OAuth 用 minimax-portal/...，API Key 用 minimax/...。

Q: MiniMax Coding Plan 的用量怎么看？

A: 运行 openclaw models status 即可查看当前配额剩余百分比。OpenClaw 会自动将 MiniMax 返回的原始 usage_percent（剩余配额）取反转换为已消耗配额显示，与其他 Provider 展示格式保持一致。

MiniMax ​

模型目录 ​

选择接入方式 ​

方式 A：MiniMax OAuth（Coding Plan）- 推荐 ​

方式 B：MiniMax API Key ​

MiniMax M2.7 作为 Fallback 示例 ​

图像生成 ​

视频生成 ​

音乐生成 ​

图像理解 ​

网页搜索 ​

通过 openclaw configure 配置 ​

配置注意事项 ​

常见问题 ​

MiniMax

模型目录

选择接入方式

方式 A：MiniMax OAuth（Coding Plan）- 推荐

方式 B：MiniMax API Key

MiniMax M2.7 作为 Fallback 示例

图像生成

视频生成

音乐生成

图像理解

网页搜索

通过 `openclaw configure` 配置

配置注意事项

常见问题