> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax 隨附的 `minimax` 外掛會註冊兩個提供者，以及五項能力：聊天、圖片生成、音樂生成、影片生成、圖片理解、語音（T2A v2）與網頁搜尋。 | 提供者 ID | 驗證 | 能力 | | ---------------- | ------ | ------------------------------ | | `minimax` | API 金鑰 | 文字、圖片生成、音樂生成、影片生成、圖片理解、語音、網頁搜尋 | | `minimax-portal` | OAuth | 文字、圖片生成、音樂生成、影片生成、圖片理解、語音 | MiniMax Coding Plan 推薦連結（9 折）：[MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb\&source=link) ## 內建目錄 | 模型 | 類型 | 說明 | | ------------------------ | ------ | ------------- | | `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/`，OAuth 設定使用 `minimax-portal/`。 ## 開始使用 \*\*最適合：\*\*透過 OAuth 快速設定 MiniMax Coding Plan，不需要 API 金鑰。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-global-oauth ``` 產生的提供者基底 URL：`api.minimax.io`。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax-portal ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-cn-oauth ``` 產生的提供者基底 URL：`api.minimaxi.com`。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax-portal ``` OAuth 設定使用 `minimax-portal` 提供者 ID。模型參照採用 `minimax-portal/MiniMax-M3` 形式。 \*\*最適合：\*\*搭配 Anthropic 相容 API 的託管 MiniMax。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-global-api ``` 這會將 `api.minimax.io` 設定為基底 URL。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice minimax-cn-api ``` 這會將 `api.minimaxi.com` 設定為基底 URL。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list --provider minimax ``` ### 設定範例 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 風格的 delta 區塊發出 `reasoning_content`，而不是原生 Anthropic thinking 區塊；如果 thinking 以隱含方式保持啟用，內部推理會外洩到可見輸出中。除非你明確自行設定 `thinking`，否則 OpenClaw 預設會停用 M2.x thinking。MiniMax-M3（以及向前相容的 M3.x）不受此限制：M3 會發出正確的 Anthropic thinking 區塊，且需要啟用 thinking 才能產生可見內容，因此 OpenClaw 會讓 M3 保持在提供者的自適應 thinking 路徑上。請參閱下方進階設定中的 Thinking 預設值章節。 API 金鑰設定使用 `minimax` 提供者 ID。模型參照採用 `minimax/MiniMax-M3` 形式。 ## 透過 `openclaw configure` 設定 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw configure ``` 從選單中選擇**模型/驗證**。 | 驗證選擇 | 說明 | | ---------------------- | --------------------- | | `minimax-global-oauth` | 國際 OAuth（Coding Plan） | | `minimax-cn-oauth` | 中國 OAuth（Coding Plan） | | `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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { imageGenerationModel: { primary: "minimax/image-01" }, }, }, } ``` 圖片生成一律使用 MiniMax 專用圖片端點（`/v1/image_generation`），並忽略 `models.providers.minimax.baseUrl`，因為該欄位改為設定聊天/Anthropic 相容基礎 URL。設定 `MINIMAX_API_HOST=https://api.minimaxi.com` 可將圖片生成路由至 CN 端點；預設全域端點為 `https://api.minimax.io`。 請參閱[圖片生成](/zh-TW/tools/image-generation)，了解共用工具參數、供應商選擇和容錯移轉行為。 ### 文字轉語音 內建的 `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/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.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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { musicGenerationModel: { primary: "minimax/music-2.6" }, }, }, } ``` 請參閱[音樂生成](/zh-TW/tools/music-generation)，了解共用工具參數、供應商選擇和容錯移轉行為。 ### 影片生成 內建的 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 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" }, }, }, } ``` 請參閱[影片生成](/zh-TW/tools/video-generation)，了解共用工具參數、提供者選擇與容錯移轉行為。 ### 圖片理解 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 CN/global 設定可透過 `models.providers.minimax-portal.baseUrl` 間接導向區域，並可透過 `MINIMAX_OAUTH_TOKEN` 提供 bearer 驗證 設定位於 `plugins.entries.minimax.config.webSearch.*` 底下。 請參閱 [MiniMax Search](/zh-TW/tools/minimax-search)，了解完整的網頁搜尋設定與用法。 ## 進階設定 | 選項 | 說明 | | ---------------------------------- | ---------------------------------------------------------------------------------------------------------- | | `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.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"` 上，除非較早的 wrapper 已在 payload 中設定 `thinking` 欄位，OpenClaw 會為 MiniMax M2.x 模型注入 `thinking: { type: "disabled" }`。這可防止 M2.x 的串流端點在 OpenAI 風格的 delta 區塊中發出 `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` | `/fast on` 或 `params.fastMode: true` 會在 Anthropic 相容的串流路徑（`api: "anthropic-messages"`，提供者 `minimax` 或 `minimax-portal`）上，將 `MiniMax-M2.7` 重寫為 `MiniMax-M2.7-highspeed`。 **最適合：** 將你最強的最新世代模型保留為主要模型，並容錯移轉到 MiniMax M2.7。下方範例使用 Opus 作為具體主要模型；請替換成你偏好的最新世代主要模型。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 金鑰）。 * 設定後，用量輪詢會從 `models.providers.minimax-portal.baseUrl` 或 `models.providers.minimax.baseUrl` 推導主機，因此使用 `https://api.minimax.io/anthropic` 的 global 設定會輪詢 `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-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` 切換 請參閱[模型提供者](/zh-TW/concepts/model-providers)，了解提供者規則。 ## 疑難排解 這通常表示 **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 theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw models list ``` 更多協助：[疑難排解](/zh-TW/help/troubleshooting)與 [FAQ](/zh-TW/help/faq)。 ## 相關 選擇提供者、模型參照與容錯移轉行為。 共用圖片工具參數與提供者選擇。 共用音樂工具參數與提供者選擇。 共用影片工具參數與提供者選擇。 透過 MiniMax Token Plan 設定網頁搜尋。 一般疑難排解與 FAQ。