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 Plugin 會為 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 金鑰設定會使用 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 金鑰設定寫入明確的 models.providers.minimax 項目時，OpenClaw 會將 MiniMax-M2.7 和 MiniMax-M2.7-highspeed 具體化為純文字聊天模型。圖像理解會透過此外掛程式擁有的 MiniMax-VL-01 媒體提供者另行公開。

# 文字轉語音

內建的 minimax Plugin 會將 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 Plugin 會透過共用的 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
• 以工作階段為基礎的執行會透過共用的工作/狀態流程分離，包括 action: "status"

若要將 MiniMax 作為預設音樂提供者：

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

# 影片生成

內建 MiniMax Plugin 會透過共用的 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 Plugin 會將圖像理解與文字目錄分開註冊：

這就是為什麼即使內建文字供應商目錄仍顯示僅限文字的 M2.7 聊天參照，自動媒體路由仍可使用 MiniMax 圖像理解。

# 網頁搜尋

MiniMax Plugin 也會透過 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/global 設定可透過 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 金鑰設定：minimax/<model>
  • OAuth 設定：minimax-portal/<model>
• 預設聊天模型：MiniMax-M2.7
• 替代聊天模型：MiniMax-M2.7-highspeed
• 入門設定與直接 API 金鑰設定會為兩個 M2.7 變體寫入僅限文字的模型定義
• 圖像理解使用 Plugin 擁有的 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

# 相關