MiniMax

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

MiniMax 还提供：

• 通过 T2A v2 内置语音合成
• 通过 MiniMax-VL-01 内置图像理解
• 通过 music-2.6 内置音乐生成
• 通过 MiniMax Token Plan 搜索 API 内置 web_search

提供商拆分：

# 内置目录

# 入门指南

选择你偏好的凭证方式并按照设置步骤操作。

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider 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.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 配置

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

openclaw configure

# 能力

# 图像生成

MiniMax 插件为 image_generate 工具注册了 image-01 模型。它支持：

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

要使用 MiniMax 进行图像生成，请将它设为图像生成提供商：

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

该插件使用与文本模型相同的 MINIMAX_API_KEY 或 OAuth 身份验证。如果已设置 MiniMax，则不需要额外配置。

minimax 和 minimax-portal 都会使用相同的 image-01 模型注册 image_generate。API-key 设置使用 MINIMAX_API_KEY；OAuth 设置则可以改用内置的 minimax-portal 身份验证路径。

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

当新手引导或 API-key 设置写入显式的 models.providers.minimax 条目时，OpenClaw 会将 MiniMax-M2.7 和 MiniMax-M2.7-highspeed 物化为纯文本聊天模型。图像理解则通过插件拥有的 MiniMax-VL-01 媒体提供商单独暴露。

# 文本转语音

内置的 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 身份验证配置文件，然后是 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
• 也支持 minimax/music-2.5 和 minimax/music-2.0
• 提示控制项：lyrics、instrumental、durationSeconds
• 输出格式：mp3
• 基于会话的运行会通过共享任务/Status 流程分离，包括 action: "status"

要将 MiniMax 用作默认音乐提供商：

{
  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
• 模式：文生视频和单图参考流程
• 支持 aspectRatio 和 resolution

要将 MiniMax 用作默认视频提供商：

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

# 图像理解

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

因此，即使内置文本提供商目录仍显示仅文本的 M2.7 聊天引用，自动媒体路由也可以使用 MiniMax 图像理解。

# Web 搜索

MiniMax 插件还通过 MiniMax Token Plan 搜索 API 注册 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 CN/全球设置可以通过 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"],
      },
    },
  },
}

# 说明

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

# 故障排除

openclaw models list

# 相关内容