OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

隨附的 minimax 外掛會註冊兩個供應商，以及五項功能：聊天、影像生成、音樂生成、影片生成、影像理解、語音（T2A v2）和網路搜尋。

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

內建目錄

模型 類型 說明
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 金鑰。

國際版

  • 執行初始設定

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

    產生的供應商基礎 URL：api.minimax.io。

  • 驗證模型是否可用

    bash
    openclaw models list --provider minimax-portal

    • 中國版

  • 執行初始設定

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

    產生的供應商基礎 URL：api.minimaxi.com。

  • 驗證模型是否可用

    bash
    openclaw models list --provider minimax-portal

    • API 金鑰

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

    國際版

  • 執行初始設定

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

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

  • 驗證模型是否可用

    bash
    openclaw models list --provider minimax

    • 中國版

  • 執行初始設定

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

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

  • 驗證模型是否可用

    bash
    openclaw models list --provider minimax

    • 設定範例

    json5
    {  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 設定

  • 啟動精靈

    bash
    openclaw configure

  • 選取模型／驗證

    從選單中選擇 模型／驗證。

  • 選擇 MiniMax 驗證選項

    驗證選項 說明
    minimax-global-oauth 國際 OAuth（程式設計方案）
    minimax-cn-oauth 中國 OAuth（程式設計方案）
    minimax-global-api 國際 API 金鑰
    minimax-cn-api 中國 API 金鑰

  • 選擇預設模型

    出現提示時，選取預設模型。

    • 功能

    圖像生成

    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
    json5
    {  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 註冊為 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、speech-01-240228
    • 驗證解析順序：messages.tts.providers.minimax.apiKey，接著是 minimax-portal OAuth／權杖驗證設定檔，再來是權杖方案環境金鑰（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.baseUrl MINIMAX_API_HOST https://api.minimax.io MiniMax T2A API 主機。
    messages.tts.providers.minimax.model MINIMAX_TTS_MODEL speech-2.8-hd TTS 模型 ID。
    messages.tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator 語音輸出所使用的語音 ID。
    messages.tts.providers.minimax.speed 1.0 播放速度，0.5..2.0。
    messages.tts.providers.minimax.vol 1.0 音量，(0, 10]。
    messages.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"
    json5
    {  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，且會予以忽略
    json5
    {  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.* 下。

    進階設定

    設定選項
    選項 說明
    models.providers.minimax.baseUrl 建議使用 https://api.minimax.io/anthropic（與 Anthropic 相容）；如需與 OpenAI 相容的承載內容，可選用 https://api.minimax.io/v1
    models.providers.minimax.api 建議使用 anthropic-messages；如需與 OpenAI 相容的承載內容，可選用 openai-completions
    models.providers.minimax.apiKey MiniMax API 金鑰（MINIMAX_API_KEY）
    models.providers.minimax.models 定義 id、name、reasoning、contextWindow、maxTokens、cost
    agents.defaults.models 為要加入允許清單的模型設定別名
    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 會傳回空的 content 陣列及 stop_reason: "end_turn"，因此 OpenClaw 會移除 M3 隱含的停用預設值；若已設定思考層級，則會改為強制使用 thinking: { type: "adaptive" }。

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

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

    在與 Anthropic 相容的串流路徑（api: "anthropic-messages"，提供者為 minimax 或 minimax-portal）上，/fast on 或 params.fastMode: true 會將 MiniMax-M2.7 改寫為 MiniMax-M2.7-highspeed。

    容錯移轉範例

    **最適合：**將功能最強的最新世代模型保留為主要模型，並在失敗時切換至 MiniMax M2.7。以下使用 Opus 作為具體的主要模型範例；請替換為你偏好的最新世代主要模型。

    json5
    {  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 用量正規化為其他提供者所使用的相同 % 剩餘 顯示方式。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

    然後使用以下指令重新檢查：

    bash
    openclaw models list

    相關內容

    模型選擇

    選擇提供者、模型參照與容錯移轉行為。
    圖片生成

    共用圖片工具參數與提供者選擇。
    音樂生成

    共用音樂工具參數與提供者選擇。
    影片生成

    共用影片工具參數與提供者選擇。
    MiniMax 搜尋

    透過 MiniMax Token Plan 設定網頁搜尋。
    疑難排解

    一般疑難排解與常見問題。
    Was this useful?
    On this page

    On this page