MiniMax

内置的 minimax 插件注册了两个提供商以及七项能力：聊天、图像生成、音乐生成、视频生成、图像理解、语音（T2A v2）和 Web 搜索。

内置目录

模型引用遵循身份验证路径：API 密钥设置使用 minimax/<model>，OAuth 设置使用 minimax-portal/<model>。

入门指南

OAuth（Coding Plan）

**最适合：**通过 OAuth 快速设置 MiniMax Coding Plan，无需 API 密钥。

国际版

运行新手引导

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

最终的提供商基础 URL：api.minimax.io。

验证模型是否可用

openclaw models list --provider minimax-portal

中国版

运行新手引导

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

最终的提供商基础 URL：api.minimaxi.com。

验证模型是否可用

openclaw models list --provider minimax-portal

API 密钥

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

国际版

运行新手引导

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

此操作会将 api.minimax.io 配置为基础 URL。

验证模型是否可用

openclaw models list --provider minimax

中国版

运行新手引导

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

此操作会将 api.minimaxi.com 配置为基础 URL。

验证模型是否可用

openclaw models list --provider minimax

配置示例

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M3",
            name: "MiniMax M3",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
            contextWindow: 1000000,
            maxTokens: 131072,
          },
          {
            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,
          },
        ],
      },
    },
  },
}

通过 openclaw configure 配置

启动向导

openclaw configure

选择模型/身份验证

从菜单中选择 模型/身份验证。

选择 MiniMax 身份验证选项

选择默认模型

出现提示时选择你的默认模型。

能力

图像生成

MiniMax 插件在 minimax 和 minimax-portal 上为 image_generate 工具注册 image-01 模型，并复用与文本模型相同的 MINIMAX_API_KEY 或 OAuth 身份验证。

• 文生图和图生图编辑（主体参考），两者均支持宽高比控制
• 每个请求最多输出 9 张图像，每个编辑请求最多使用 1 张参考图像
• 支持的宽高比：1:1、16:9、4:3、3:2、2:3、3:4、9:16、21:9

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

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

文本转语音

内置的 minimax 插件将 MiniMax T2A v2 注册为 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
• 身份验证解析顺序：tts.providers.minimax.apiKey，然后是 minimax-portal OAuth/令牌身份验证配置文件，接着是 Token Plan 环境变量密钥（MINIMAX_OAUTH_TOKEN、MINIMAX_CODE_PLAN_KEY、MINIMAX_CODING_API_KEY），最后是 MINIMAX_API_KEY
• 如果未配置 TTS 主机，OpenClaw 会复用已配置的 minimax-portal OAuth 主机，并移除 /anthropic 等 Anthropic 兼容路径后缀
• 普通音频附件保持为 MP3。语音消息目标（Feishu、Telegram 以及其他请求兼容语音消息附件的渠道）会使用 ffmpeg 将 MiniMax MP3 转码为 48kHz Opus，因为例如 Feishu/Lark 文件 API 仅接受 file_type: "opus" 作为原生音频消息
• MiniMax T2A 接受小数形式的 speed 和 vol，但 pitch 会以整数发送；OpenClaw 会在 API 请求前截断 pitch 的小数值

音乐生成

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

• 默认音乐模型：minimax/music-2.6（OAuth：minimax-portal/music-2.6）
• 还支持 music-2.6-free、music-cover 和 music-cover-free
• 提示词控制项：lyrics、instrumental
• 输出格式：mp3
• 由会话支持的运行会通过共享任务/状态流程分离执行，其中包括 action: "status"

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

视频生成

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

• 默认视频模型：minimax/MiniMax-Hailuo-2.3（OAuth：minimax-portal/MiniMax-Hailuo-2.3）
• 还支持 MiniMax-Hailuo-2.3-Fast、MiniMax-Hailuo-02、I2V-01-Director、I2V-01-live 和 I2V-01
• 模式：文生视频和单图参考流程
• 支持 resolution（Hailuo 2.3/02 模型上为 768P 或 1080P）；不支持 aspectRatio，该参数会被忽略

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

图像理解

MiniMax 插件将图像理解与文本目录分开注册：

因此，即使内置文本提供商目录也包含支持图像的 M3 聊天引用，自动媒体路由仍可使用 MiniMax 图像理解。PDF 理解仅使用 MiniMax-M2.7 提取文本；MiniMax 未注册 PDF 转图像路径。

Web 搜索

MiniMax 插件还通过 MiniMax Token Plan 搜索 API（/v1/coding_plan/search）注册 web_search。

• 提供商 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 提供商基础 URL
• 搜索仍使用提供商 ID minimax；OAuth 中国区/全球设置可通过 models.providers.minimax-portal.baseUrl 间接引导区域，并可通过 MINIMAX_OAUTH_TOKEN 提供 Bearer 身份验证

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

高级配置

{
  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-M3。其他聊天模型：MiniMax-M2.7、MiniMax-M2.7-highspeed
• 新手引导和直接 API 密钥设置会写入 M3 以及两个 M2.7 变体的模型定义
• 图像理解使用插件自有的 MiniMax-VL-01 媒体提供商
• 如果需要精确跟踪成本，请更新 models.json 中的定价值
• 使用 openclaw models list 确认当前提供商 ID，然后使用 openclaw models set minimax/MiniMax-M3 或 openclaw models set minimax-portal/MiniMax-M3 切换

故障排查

openclaw models list

相关内容

• 模型选择：选择提供商、模型引用和故障转移行为。
• 图像生成：共享图像工具参数和提供商选择。
• 音乐生成：共享音乐工具参数和提供商选择。
• 视频生成：共享视频工具参数和提供商选择。
• MiniMax 搜索：通过 MiniMax Token Plan 配置 Web 搜索。
• 故障排查：常规故障排查和常见问题。