MiniMax

隨附的 minimax 外掛註冊了兩個提供者及五項功能：聊天、圖片生成、音樂生成、影片生成、圖片理解、語音（T2A v2）和網路搜尋。

提供者 ID	驗證方式	功能
minimax	API 金鑰	文字、圖片生成、音樂生成、影片生成、圖片理解、語音、網路搜尋
minimax-portal	OAuth	文字、圖片生成、音樂生成、影片生成、圖片理解、語音

MiniMax Coding Plan 推薦連結（享 9 折優惠）：MiniMax Coding Plan

​

內建目錄

模型	類型	說明
MiniMax-M3	聊天（推理）	預設的託管推理模型
MiniMax-M2.7	聊天（推理）	前一代託管推理模型
MiniMax-M2.7-highspeed	聊天（推理）	更快的 M2.7 推理層級
MiniMax-VL-01	視覺	圖片理解模型
image-01	圖片生成	文字轉圖片及圖片轉圖片編輯
music-2.6	音樂生成	預設音樂模型
MiniMax-Hailuo-2.3	影片生成	文字轉影片及圖片轉影片流程

模型參照會依循驗證路徑：API 金鑰設定使用 minimax/<model>，OAuth 設定使用 minimax-portal/<model>。

​

開始使用

OAuth（Coding Plan）

**最適合：**透過 OAuth 快速設定 MiniMax Coding Plan，無需 API 金鑰。

國際版

1. 執行初始設定

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

   產生的提供者基底 URL：api.minimax.io。

2. 確認模型可用

   openclaw models list --provider minimax-portal
   

中國版

1. 執行初始設定

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

   產生的提供者基底 URL：api.minimaxi.com。

2. 確認模型可用

   openclaw models list --provider minimax-portal
   

OAuth 設定使用 minimax-portal 提供者 ID。模型參照採用 minimax-portal/MiniMax-M3 格式。

API 金鑰

**最適合：**搭配 Anthropic 相容 API 的託管 MiniMax。

國際版

1. 執行初始設定

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

   這會將 api.minimax.io 設定為基底 URL。

2. 確認模型可用

   openclaw models list --provider minimax
   

中國版

1. 執行初始設定

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

   這會將 api.minimaxi.com 設定為基底 URL。

2. 確認模型可用

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

MiniMax-M2.x 的 Anthropic 相容串流端點會在 OpenAI 樣式的差異區塊中發出 reasoning_content，而非原生 Anthropic 思考區塊；若思考功能維持隱含啟用，內部推理便會洩漏至可見輸出。除非你自行明確設定 thinking，否則 OpenClaw 預設會停用 M2.x 的思考功能。MiniMax-M3（以及向前相容的 M3.x）不受此限制：M3 會發出正確的 Anthropic 思考區塊，且必須啟用思考功能才能產生可見內容，因此 OpenClaw 會讓 M3 繼續使用提供者的自適應思考路徑。請參閱下方「進階設定」中的「思考功能預設值」一節。

API 金鑰設定使用 minimax 提供者 ID。模型參照採用 minimax/MiniMax-M3 格式。

​

透過 openclaw configure 設定

1. 啟動精靈

   openclaw configure
   
2. 選取 Model/auth

   從選單中選擇 Model/auth。

3. 選擇 MiniMax 驗證選項

   驗證選項	說明
   minimax-global-oauth	國際版 OAuth（Coding Plan）
   minimax-cn-oauth	中國版 OAuth（Coding Plan）
   minimax-global-api	國際版 API 金鑰
   minimax-cn-api	中國版 API 金鑰

4. 選取預設模型

   系統提示時，選取你的預設模型。

​

功能

​

圖片生成

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 值的小數部分

設定	環境變數	預設值	說明
tts.providers.minimax.baseUrl	MINIMAX_API_HOST	https://api.minimax.io	MiniMax T2A API 主機。
tts.providers.minimax.model	MINIMAX_TTS_MODEL	speech-2.8-hd	TTS 模型 ID。
tts.providers.minimax.voiceId	MINIMAX_TTS_VOICE_ID	English_expressive_narrator	用於語音輸出的語音 ID。
tts.providers.minimax.speed		1.0	播放速度，0.5..2.0。
tts.providers.minimax.vol		1.0	音量，(0, 10]。
tts.providers.minimax.pitch		0	整數音高偏移，-12..12。

​

音樂生成

隨附的 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 外掛會將圖片理解功能與文字目錄分開註冊：

供應商 ID	預設圖片模型	PDF 文字擷取
minimax	MiniMax-VL-01	MiniMax-M2.7
minimax-portal	MiniMax-VL-01	MiniMax-M2.7

因此，即使隨附的文字供應商目錄也包含支援圖片的 M3 聊天參照，自動媒體路由仍可使用 MiniMax 圖片理解功能。PDF 理解僅使用 MiniMax-M2.7 擷取文字；MiniMax 並未註冊 PDF 轉圖片的轉換路徑。

​

網頁搜尋

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.* 下。

完整的網頁搜尋設定與使用方式請參閱 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 金鑰（MINIMAX_API_KEY）
models.providers.minimax.models	定義 id、name、reasoning、contextWindow、maxTokens、cost
agents.defaults.models	各模型的別名、參數和中繼資料
agents.defaults.modelPolicy.allow	選用的明確模型允許清單
models.mode	若要在內建項目之外加入 MiniMax，請保留 merge

思考預設值

在 api: "anthropic-messages" 上，除非先前的包裝器已在承載資料中設定 thinking 欄位，否則 OpenClaw 會為 MiniMax M2.x 模型注入 thinking: { type: "disabled" }。這可避免 M2.x 的串流端點在 OpenAI 樣式的差異區塊中輸出 reasoning_content，以免內部推理洩漏至可見輸出。

MiniMax-M3（以及 M3.x）不受此限制：停用思考時，M3 會傳回包含 stop_reason: "end_turn" 的空白 content 陣列，因此 OpenClaw 會移除 M3 隱含的停用預設值，並在設定思考等級時改為強制使用 thinking: { type: "adaptive" }。

各模型系列可用的思考等級：

模型系列	等級	預設值
MiniMax-M3	off、adaptive	adaptive
MiniMax-M2.x	off、minimal、low、medium、high	off

快速模式

/fast on 或 params.fastMode: true 會在與 Anthropic 相容的串流路徑（api: "anthropic-messages"，供應商為 minimax 或 minimax-portal）上，將 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 使用詳情

• Coding Plan 用量 API：https://api.minimaxi.com/v1/token_plan/remains 或 https://api.minimax.io/v1/token_plan/remains（需要 Coding Plan 金鑰）。
• 設定後，用量輪詢會從 models.providers.minimax-portal.baseUrl 或 models.providers.minimax.baseUrl 推導主機，因此使用 https://api.minimax.io/anthropic 的全球設定會輪詢 api.minimax.io。為維持相容性，基礎 URL 缺失或格式錯誤時會保留中國區備援。
• 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-portal-cn 視為相同的 MiniMax 配額介面，並優先使用已儲存的 MiniMax OAuth，之後才回退至 Coding Plan 金鑰環境變數。

​

注意事項

• 預設聊天模型：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 切換

供應商規則請參閱模型供應商。

​

疑難排解

"未知模型：minimax/MiniMax-M3"

這通常表示尚未設定 MiniMax 供應商（找不到相符的供應商項目，也找不到 MiniMax 驗證設定檔／環境金鑰）。修正方式如下：

• 執行 openclaw configure 並選擇 MiniMax 驗證選項，或
• 手動加入相符的 models.providers.minimax 或 models.providers.minimax-portal 區塊，或
• 設定 MINIMAX_API_KEY、MINIMAX_OAUTH_TOKEN 或 MiniMax 驗證設定檔，讓系統可注入相符的供應商。

請確認模型 ID 區分大小寫：

• API 金鑰路徑：minimax/MiniMax-M3、minimax/MiniMax-M2.7 或 minimax/MiniMax-M2.7-highspeed
• OAuth 路徑：minimax-portal/MiniMax-M3、minimax-portal/MiniMax-M2.7 或 minimax-portal/MiniMax-M2.7-highspeed

接著使用下列命令重新檢查：

openclaw models list

更多協助：疑難排解和常見問題。

​

相關內容

模型選擇

選擇供應商、模型參照和容錯移轉行為。

圖片生成

共用圖片工具參數和供應商選擇。

音樂生成

共用音樂工具參數和供應商選擇。

影片生成

共用影片工具參數和供應商選擇。

MiniMax 搜尋

透過 MiniMax Token Plan 設定網頁搜尋。

疑難排解

一般疑難排解和常見問題。