跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 的 MiniMax 提供商默认使用 MiniMax M2.7。 MiniMax 还提供：
  • 通过 T2A v2 内置语音合成
  • 通过 MiniMax-VL-01 内置图像理解
  • 通过 music-2.6 内置音乐生成
  • 通过 MiniMax Token Plan 搜索 API 内置 web_search
提供商拆分：
提供商 ID凭证能力
minimaxAPI key文本、图像生成、音乐生成、视频生成、图像理解、语音、Web 搜索
minimax-portalOAuth文本、图像生成、音乐生成、视频生成、图像理解、语音

​
内置目录

模型类型描述
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视频生成文生视频和图像参考流程

​
入门指南

选择你偏好的凭证方式并按照设置步骤操作。
最适合： 通过 OAuth 快速设置 MiniMax Coding Plan，无需 API key。
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
这会针对 api.minimax.io 进行身份验证。
2

Verify the model is available

openclaw models list --provider minimax-portal
OAuth 设置使用 minimax-portal 提供商 ID。模型引用遵循 minimax-portal/MiniMax-M2.7 格式。
MiniMax Coding Plan 推荐链接（九折）：MiniMax Coding Plan

​
通过 openclaw configure 配置

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

启动向导

openclaw configure
2

选择模型/身份验证

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

选择一个 MiniMax 身份验证选项

选择一个可用的 MiniMax 选项：
身份验证选项说明
minimax-global-oauth国际 OAuth（Coding Plan）
minimax-cn-oauth中国 OAuth（Coding Plan）
minimax-global-api国际 API key
minimax-cn-api中国 API key
4

选择你的默认模型

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

​
能力

​
图像生成

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 值。
设置环境变量默认值说明
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax T2A API 主机。
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS 模型 ID。
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narrator用于语音输出的语音 ID。
messages.tts.providers.minimax.speed1.0播放速度，0.5..2.0。
messages.tts.providers.minimax.vol1.0音量，(0, 10]。
messages.tts.providers.minimax.pitch0整数音高偏移，-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、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 插件会将图像理解与文本目录分开注册：
提供商 ID默认图像模型
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
因此，即使内置文本提供商目录仍显示仅文本的 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.* 下。
参见 MiniMax Search，了解完整的 Web 搜索配置和用法。

​
高级配置

选项说明
models.providers.minimax.baseUrl优先使用 https://api.minimax.io/anthropic（Anthropic 兼容）；https://api.minimax.io/v1 可选，用于 OpenAI 兼容 payload
models.providers.minimax.api优先使用 anthropic-messages；openai-completions 可选，用于 OpenAI 兼容 payload
models.providers.minimax.apiKeyMiniMax API key（MINIMAX_API_KEY）
models.providers.minimax.models定义 id、name、reasoning、contextWindow、maxTokens、cost
agents.defaults.models为你希望加入允许列表的模型设置别名
models.mode如果你想在内置项旁添加 MiniMax，请保持 merge
在 api: "anthropic-messages" 上，除非已在 params/config 中显式设置 thinking，否则 OpenClaw 会注入 thinking: { type: "disabled" }。这会防止 MiniMax 的流式端点在 OpenAI 风格的 delta 分块中发出 reasoning_content，从而避免内部推理泄露到可见输出中。
/fast on 或 params.fastMode: true 会在 Anthropic 兼容流路径上将 MiniMax-M2.7 重写为 MiniMax-M2.7-highspeed。
**最适合：**将你最强的最新一代模型保留为主模型，并故障转移到 MiniMax M2.7。下面示例使用 Opus 作为具体主模型；请替换为你偏好的最新一代主模型。
{
  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 用量 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 额度表面，并优先使用已存储的 MiniMax OAuth，然后再回退到 Coding Plan key 环境变量。

​
说明

  • 模型引用遵循认证路径：
    • 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 切换
MiniMax Coding Plan 推荐链接（九折）：MiniMax Coding Plan
参见模型提供商，了解提供商规则。

​
故障排除

这通常表示 MiniMax 提供商未配置（没有匹配的提供商条目，也没有找到 MiniMax auth profile/env key）。此检测问题的修复包含在 2026.1.12 中。修复方式：
  • 升级到 2026.1.12（或从源码 main 运行），然后重启 gateway。
  • 运行 openclaw configure 并选择一个 MiniMax 认证选项，或
  • 手动添加匹配的 models.providers.minimax 或 models.providers.minimax-portal 块，或
  • 设置 MINIMAX_API_KEY、MINIMAX_OAUTH_TOKEN，或 MiniMax auth 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
然后用以下命令重新检查：
openclaw models list
更多帮助：故障排除和常见问题。

​
相关内容

模型选择

选择提供商、模型引用和故障转移行为。

图像生成

共享图像工具参数和提供商选择。

音乐生成

共享音乐工具参数和提供商选择。

视频生成

共享视频工具参数和提供商选择。

MiniMax Search

通过 MiniMax Token Plan 配置 Web 搜索。

故障排除

常规故障排除和常见问题。