OpenClaw 使用 MiniMax 模型时默认采用 MiniMax M2.7。本文档覆盖 OAuth Coding Plan 和 API Key 两种接入方式，分别对应 minimax-portal 和 minimax 两个 Provider ID，并说明图像生成、视频生成、音乐生成、图像理解（MiniMax-VL-01）、TTS、网页搜索（Token Plan Search API）等能力。首次配置可运行 openclaw onboard --auth-choice minimax-global-oauth 或 openclaw configure，之后用 openclaw models list 验证模型是否可见。

OpenClaw 接入 MiniMax：MiniMax M2.7 配置与多模态完整指南

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

MiniMax 还提供了：

语音合成（T2A v2）
图像理解（MiniMax-VL-01）
音乐生成（music-2.6）
网页搜索（通过 MiniMax Token Plan Search API）

Provider 拆分：

Provider ID	认证方式	能力
`minimax`	API Key	文本、图像生成、音乐生成、视频生成、图像理解、语音、网页搜索
`minimax-portal`	OAuth	文本、图像生成、音乐生成、视频生成、图像理解、语音

内置模型目录

模型	类型	描述
`MiniMax-M2.7`	聊天（推理）	默认托管推理模型
`MiniMax-M2.7-highspeed`	聊天（推理）	更快的 M2.7 推理层
`MiniMax-VL-01`	视觉	图像理解模型
`image-01`	图像生成	文本生成图像及图像编辑
`music-2.6`	音乐生成	默认音乐模型
`music-2.5`	音乐生成	上一代音乐生成层
`music-2.0`	音乐生成	旧版音乐生成层
`MiniMax-Hailuo-2.3`	视频生成	文本转视频及图像参考流程

快速开始

根据你偏好的认证方式，选择下面的配置路径。

方式 A：OAuth（Coding Plan）— 推荐

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

国际用户

bash

openclaw onboard --auth-choice minimax-global-oauth

对 api.minimax.io 进行认证。

验证模型可用

bash

openclaw models list --provider minimax-portal

中国大陆用户

bash

openclaw onboard --auth-choice minimax-cn-oauth

对 api.minimaxi.com 进行认证。

验证模型可用

bash

openclaw models list --provider minimax-portal

TIP

OAuth 设置使用 Provider ID minimax-portal。模型引用格式为 minimax-portal/MiniMax-M2.7。

TIP

MiniMax Coding Plan 推荐链接（10% 优惠）：MiniMax Coding Plan

方式 B：API Key

适用场景：通过 Anthropic 兼容 API 直接访问 MiniMax 托管模型。

国际用户

bash

openclaw onboard --auth-choice minimax-global-api

将 api.minimax.io 配置为基础 URL。

验证模型可用

bash

openclaw models list --provider minimax

中国大陆用户

bash

openclaw onboard --auth-choice minimax-cn-api

将 api.minimaxi.com 配置为基础 URL。

验证模型可用

bash

openclaw models list --provider minimax

配置示例

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"],
            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"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

WARNING

在 Anthropic 兼容流式路径下，OpenClaw 默认禁用 MiniMax thinking，除非你显式设置 thinking。MiniMax 的流式端点以 OpenAI 风格 delta chunk 返回 reasoning_content，并非原生 Anthropic thinking 块，若未显式禁用可能导致内部推理泄露到可见输出中。

TIP

API Key 设置使用 Provider ID minimax。模型引用格式为 minimax/MiniMax-M2.7。

通过 `openclaw configure` 配置

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

启动向导
bash
```
openclaw configure
```
选择 Model/auth 从菜单中选择 Model/auth。
选择 MiniMax 认证选项 从可用的 MiniMax 选项中选取一个：
认证选项描述
minimax-global-oauth 国际 OAuth（Coding Plan）
minimax-cn-oauth 中国大陆 OAuth（Coding Plan）
minimax-global-api 国际 API Key
minimax-cn-api 中国大陆 API Key
选择默认模型 按提示选择你想要的默认模型。

认证选项	描述
`minimax-global-oauth`	国际 OAuth（Coding Plan）
`minimax-cn-oauth`	中国大陆 OAuth（Coding Plan）
`minimax-global-api`	国际 API Key
`minimax-cn-api`	中国大陆 API Key

能力详情

图像生成

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_API_KEY 或 OAuth 认证。如果 MiniMax 已配置完毕，无需额外设置。

minimax 和 minimax-portal 均注册了 image_generate，均使用 image-01 模型。API Key 设置使用 MINIMAX_API_KEY；OAuth 设置可使用内置的 minimax-portal 认证路径。

WARNING

图像生成始终使用 MiniMax 的专用图像端点（/v1/image_generation），并忽略 models.providers.minimax.baseUrl（该字段配置的是聊天/Anthropic 兼容基础 URL）。设置环境变量 MINIMAX_API_HOST=https://api.minimaxi.com 可将图像生成路由到中国大陆端点；默认全局端点是 https://api.minimax.io。

在使用 onboard 或 API Key 配置写入显式 models.providers.minimax 条目时，OpenClaw 会具体化 MiniMax-M2.7 和 MiniMax-M2.7-highspeed 为纯文本聊天模型。图像理解能力通过插件拥有的 MiniMax-VL-01 媒体提供商单独暴露。

TIP

参见图像生成了解共享工具参数、提供商选择和故障切换行为。

文本转语音 (TTS)

内置的 minimax 插件将 MiniMax T2A v2 注册为 messages.tts 的语音提供商。

默认 TTS 模型：speech-2.8-hd
默认语音：English_expressive_narrator
支持的内置模型 ID 包括：speech-2.8-hd、speech-2.8-turbo、speech-2.6-hd、speech-2.6-turbo、speech-02-hd、speech-02-turbo、speech-01-hd、speech-01-turbo
认证解析顺序：messages.tts.providers.minimax.apiKey → minimax-portal OAuth/token 认证 profile → Token Plan 环境密钥（MINIMAX_OAUTH_TOKEN、MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY）→ MINIMAX_API_KEY
如果未配置 TTS 主机，OpenClaw 会复用已配置的 minimax-portal OAuth 主机，并剥离 Anthropic 兼容路径后缀（如 /anthropic）
普通音频附件保持 MP3 格式
针对飞书和 Telegram 等语音消息目标，MiniMax MP3 会通过 ffmpeg 转码为 48kHz Opus，因为飞书/Lark 文件 API 只接受 file_type: "opus" 作为原生音频消息
MiniMax T2A 接受小数 speed 和 vol，但 pitch 需以整数形式发送；OpenClaw 在 API 请求前会截断小数 pitch 值

配置项	环境变量	默认值	描述
`messages.tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	MiniMax T2A API 主机
`messages.tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	TTS 模型 ID
`messages.tts.providers.minimax.voiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	用于语音输出的语音 ID
`messages.tts.providers.minimax.speed`		`1.0`	播放速度，范围 `0.5..2.0`
`messages.tts.providers.minimax.vol`		`1.0`	音量，范围 `(0, 10]`
`messages.tts.providers.minimax.pitch`		`0`	整数音高偏移，范围 `-12..12`

音乐生成

内置的 MiniMax 插件通过共享的 music_generate 工具注册音乐生成，同时支持 minimax 和 minimax-portal。

默认音乐模型：minimax/music-2.6
OAuth 音乐模型：minimax-portal/music-2.6
也支持 minimax/music-2.5 和 minimax/music-2.0
提示控制：lyrics（歌词）、instrumental（纯器乐）
输出格式：mp3
基于会话的运行通过共享的任务/状态流（包括 action: "status"）分离

若要使用 MiniMax 作为默认音乐提供商：

json5

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

TIP

参见音乐生成了解共享工具参数、提供商选择和故障切换行为。

视频生成

内置的 MiniMax 插件通过共享的 video_generate 工具注册视频生成，同时支持 minimax 和 minimax-portal。

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

若要使用 MiniMax 作为默认视频提供商：

json5

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

TIP

参见视频生成了解共享工具参数、提供商选择和故障切换行为。

图像理解

MiniMax 插件将与文本目录分离地注册图像理解能力：

Provider ID	默认图像模型
`minimax`	`MiniMax-VL-01`
`minimax-portal`	`MiniMax-VL-01`

这就是为什么自动媒体路由可以使用 MiniMax 图像理解，即使内置文本目录仍然显示纯文本的 M2.7 聊天引用。

网页搜索

MiniMax 插件还通过 MiniMax Token Plan Search API 注册了 web_search 能力：

Provider ID：minimax
结构化结果：标题、URL、片段、相关查询
首选环境变量：MINIMAX_CODE_PLAN_KEY
接受的别名：MINIMAX_CODING_API_KEY、MINIMAX_OAUTH_TOKEN
兼容回退：如果 MINIMAX_API_KEY 已指向 Token Plan 凭证，也可使用
区域复用：plugins.entries.minimax.config.webSearch.region → MINIMAX_API_HOST → MiniMax provider 基础 URL
搜索始终使用 Provider ID minimax；OAuth CN/全局设置可通过 models.providers.minimax-portal.baseUrl 间接控制区域，并通过 MINIMAX_OAUTH_TOKEN 提供 Bearer 认证

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

TIP

参见MiniMax 搜索了解完整的网页搜索配置和用法。

高级配置

配置选项

配置选项	描述
`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 Key（`MINIMAX_API_KEY`）
`models.providers.minimax.models`	定义 `id`、`name`、`reasoning`、`contextWindow`、`maxTokens`、`cost`
`agents.defaults.models`	别名你想要加入允许列表的模型
`models.mode`	保持 `merge` 以便将 MiniMax 添加到内置模型旁边

Thinking 默认行为

在使用 api: "anthropic-messages" 时，OpenClaw 会注入 thinking: { type: "disabled" }，除非已经在参数/配置中显式设置了 thinking。

这可以防止 MiniMax 的流式端点以 OpenAI 风格 delta chunk 发送 reasoning_content，避免内部推理泄露到可见输出中。

Fast 模式

/fast on 或 params.fastMode: true 会在 Anthropic 兼容流式路径上将 MiniMax-M2.7 重写为 MiniMax-M2.7-highspeed。

故障切换示例

适用场景：保持最强的最新模型作为主要模型，故障切换到 MiniMax M2.7。以下示例使用 Opus 作为具体主要模型，你可以替换为你偏好的最新一代主要模型。

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

Coding Plan 用量详情

Coding Plan 用量 API：https://api.minimaxi.com/v1/token_plan/remains 或 https://api.minimax.io/v1/token_plan/remains（需要 Coding Plan Key）
用量轮询根据 models.providers.minimax-portal.baseUrl 或 models.providers.minimax.baseUrl 得出主机（如果已配置），因此使用 https://api.minimax.io/anthropic 的全局设置会轮询 api.minimax.io。缺失或格式错误的 URL 会保持 CN 回退以保持兼容性。
OpenClaw 将 MiniMax Coding Plan 用量规范化为其他提供商使用的 % left 显示。MiniMax 原始 usage_percent / usagePercent 字段是剩余配额，不是已消耗配额，因此 OpenClaw 会反转它。当存在基于计数的字段时，优先使用。
当 API 返回 model_remains 时，OpenClaw 优先选择聊天模型条目，在需要时从 start_time / end_time 派生窗口标签，并在计划标签中包含所选模型名称，以便更容易区分 Coding Plan 窗口。
用量快照将 minimax、minimax-cn 和 minimax-portal 视为同一个 MiniMax 配额面，并在回退到 Coding Plan Key 环境变量之前优先使用存储的 MiniMax OAuth。

注意事项

模型引用遵循认证路径：
- API Key 设置：minimax/<model>
- OAuth 设置：minimax-portal/<model>
默认聊天模型：MiniMax-M2.7
备选聊天模型：MiniMax-M2.7-highspeed
Onboard 和直接 API Key 设置为两个 M2.7 变体写入纯文本模型定义
图像理解使用插件拥有的 MiniMax-VL-01 媒体提供商
如果需要精确成本追踪，更新 models.json 中的定价值
使用 openclaw models list 确认当前 Provider ID，然后使用 openclaw models set minimax/MiniMax-M2.7 或 openclaw models set minimax-portal/MiniMax-M2.7 切换

TIP

MiniMax Coding Plan 推荐链接（10% 优惠）：MiniMax Coding Plan

TIP

参见模型提供商了解提供商规则。

故障排除

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

这通常意味着 MiniMax 提供商未配置（没有匹配的提供商条目，也没有找到 MiniMax 认证 profile 或环境密钥）。此问题的检测修复位于 2026.1.12。

修复方法：

升级到 2026.1.12（或从源码 main 运行），然后重启网关
运行 openclaw configure 并选择一个 MiniMax 认证选项
手动添加匹配的 models.providers.minimax 或 models.providers.minimax-portal 块
设置 MINIMAX_API_KEY、MINIMAX_OAUTH_TOKEN 或 MiniMax 认证 profile，以便注入匹配的提供商

确保模型 ID 区分大小写：

API Key 路径：minimax/MiniMax-M2.7 或 minimax/MiniMax-M2.7-highspeed
OAuth 路径：minimax-portal/MiniMax-M2.7 或 minimax-portal/MiniMax-M2.7-highspeed

然后用以下命令重新检查：

bash

openclaw models list

TIP

更多帮助：故障排除和FAQ。

常见问题

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

通常是因为 MiniMax 提供商未配置。请先运行 openclaw configure 选择 MiniMax 认证选项，或手动添加 models.providers.minimax 配置块，并设置对应的环境变量（MINIMAX_API_KEY 或 MINIMAX_OAUTH_TOKEN）。然后用 openclaw models list 验证模型是否出现在列表中。

OAuth Coding Plan 和 API Key 方式有什么不同？

OAuth Coding Plan 不需要手动管理 API Key，适合快速上手；API Key 计费更透明，适合生产环境。模型引用前缀不同：OAuth 用 minimax-portal/，API Key 用 minimax/。另外，OAuth 设置无需配置 baseUrl，而 API Key 需要指定 Anthropic 兼容的 baseUrl。

MiniMax Coding Plan 的剩余用量怎么看？

运行 openclaw models status 即可看到当前配额剩余百分比。OpenClaw 会自动将 MiniMax 返回的 usage_percent（剩余配额）反转显示为已消耗百分比，与其他提供商展示格式一致。

OpenClaw 接入 MiniMax：MiniMax M2.7 配置与多模态完整指南 ​

内置模型目录 ​

快速开始 ​

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

国际用户 ​

验证模型可用 ​

中国大陆用户 ​

验证模型可用 ​

方式 B：API Key ​

国际用户 ​

验证模型可用 ​

中国大陆用户 ​

验证模型可用 ​

配置示例 ​

通过 openclaw configure 配置 ​

能力详情 ​

图像生成 ​

文本转语音 (TTS) ​

音乐生成 ​

视频生成 ​

图像理解 ​

网页搜索 ​

高级配置 ​

注意事项 ​

故障排除 ​

相关页面 ​

常见问题 ​

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

OAuth Coding Plan 和 API Key 方式有什么不同？ ​

MiniMax Coding Plan 的剩余用量怎么看？ ​

OpenClaw 接入 MiniMax：MiniMax M2.7 配置与多模态完整指南

内置模型目录

快速开始

方式 A：OAuth（Coding Plan）— 推荐

国际用户

验证模型可用

中国大陆用户

验证模型可用

方式 B：API Key

国际用户

验证模型可用

中国大陆用户

验证模型可用

配置示例

通过 `openclaw configure` 配置

能力详情

图像生成

文本转语音 (TTS)

音乐生成

视频生成

图像理解

网页搜索

高级配置

注意事项

故障排除

相关页面

常见问题

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

OAuth Coding Plan 和 API Key 方式有什么不同？

MiniMax Coding Plan 的剩余用量怎么看？