- Bundled speech synthesis via T2A v2
- Bundled image understanding via
MiniMax-VL-01 - Bundled music generation via
music-2.6 - Bundled
web_searchthrough the MiniMax Token Plan search API
| Provider ID | Auth | Capabilities |
|---|---|---|
minimax | API key | Text, image generation, music generation, video generation, image understanding, speech, web search |
minimax-portal | OAuth | Text, image generation, music generation, video generation, image understanding, speech |
Built-in catalog
| Model | Type | Description |
|---|---|---|
MiniMax-M3 | Chat (reasoning) | Default hosted reasoning model |
MiniMax-M2.7 | Chat (reasoning) | Previous hosted reasoning model |
MiniMax-M2.7-highspeed | Chat (reasoning) | Faster M2.7 reasoning tier |
MiniMax-VL-01 | Vision | Image understanding model |
image-01 | Image generation | Text-to-image and image-to-image editing |
music-2.6 | Music generation | Default music model |
music-2.5 | Music generation | Previous music generation tier |
music-2.0 | Music generation | Legacy music generation tier |
MiniMax-Hailuo-2.3 | Video generation | Text-to-video and image reference flows |
Getting started
Choose your preferred auth method and follow the setup steps.- OAuth (Coding Plan)
- API key
Configure via openclaw configure
Use the interactive config wizard to set MiniMax without editing JSON:
Choose a MiniMax auth option
Pick one of the available MiniMax options:
| Auth choice | Description |
|---|---|
minimax-global-oauth | International OAuth (Coding Plan) |
minimax-cn-oauth | China OAuth (Coding Plan) |
minimax-global-api | International API key |
minimax-cn-api | China API key |
Capabilities
Image generation
The MiniMax plugin registers theimage-01 model for the image_generate tool. It supports:
- Text-to-image generation with aspect ratio control
- Image-to-image editing (subject reference) with aspect ratio control
- Up to 9 output images per request
- Up to 1 reference image per edit request
- Supported aspect ratios:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
MINIMAX_API_KEY or OAuth auth as the text models. No additional configuration is needed if MiniMax is already set up.
Both minimax and minimax-portal register image_generate with the same
image-01 model. API-key setups use MINIMAX_API_KEY; OAuth setups can use
the bundled minimax-portal auth path instead.
Image generation always uses MiniMax’s dedicated image endpoint
(/v1/image_generation) and ignores models.providers.minimax.baseUrl,
since that field configures the chat/Anthropic-compatible base URL. Set
MINIMAX_API_HOST=https://api.minimaxi.com to route image generation
through the CN endpoint; the default global endpoint is
https://api.minimax.io.
When onboarding or API-key setup writes explicit models.providers.minimax
entries, OpenClaw materializes MiniMax-M3, MiniMax-M2.7, and
MiniMax-M2.7-highspeed as chat models. M3 advertises text and image input;
image understanding remains exposed separately through the plugin-owned
MiniMax-VL-01 media provider.
See Image Generation for shared tool parameters, provider selection, and failover behavior.
Text-to-speech
The bundledminimax plugin registers MiniMax T2A v2 as a speech provider for
messages.tts.
- Default TTS model:
speech-2.8-hd - Default voice:
English_expressive_narrator - Supported bundled model ids include
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, andspeech-01-turbo. - Auth resolution is
messages.tts.providers.minimax.apiKey, thenminimax-portalOAuth/token auth profiles, then Token Plan environment keys (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), thenMINIMAX_API_KEY. - If no TTS host is configured, OpenClaw reuses the configured
minimax-portalOAuth host and strips Anthropic-compatible path suffixes such as/anthropic. - Normal audio attachments stay MP3.
- Voice-note targets such as Feishu and Telegram are transcoded from MiniMax
MP3 to 48kHz Opus with
ffmpeg, because the Feishu/Lark file API only acceptsfile_type: "opus"for native audio messages. - MiniMax T2A accepts fractional
speedandvol, butpitchis sent as an integer; OpenClaw truncates fractionalpitchvalues before the API request.
| Setting | Env var | Default | Description |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | MiniMax T2A API host. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | TTS model id. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | Voice id used for speech output. |
messages.tts.providers.minimax.speed | 1.0 | Playback speed, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Volume, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Integer pitch shift, -12..12. |
Music generation
The bundled MiniMax plugin registers music generation through the sharedmusic_generate tool for both minimax and minimax-portal.
- Mô hình nhạc mặc định:
minimax/music-2.6 - Mô hình nhạc OAuth:
minimax-portal/music-2.6 - Cũng hỗ trợ
minimax/music-2.5vàminimax/music-2.0 - Điều khiển prompt:
lyrics,instrumental - Định dạng đầu ra:
mp3 - Các lượt chạy có phiên hỗ trợ sẽ tách ra qua luồng tác vụ/trạng thái dùng chung, bao gồm
action: "status"
Xem Tạo nhạc để biết các tham số công cụ dùng chung, lựa chọn nhà cung cấp và hành vi chuyển đổi dự phòng.
Tạo video
Plugin MiniMax đi kèm đăng ký tạo video thông qua công cụ dùng chungvideo_generate cho cả minimax và minimax-portal.
- Mô hình video mặc định:
minimax/MiniMax-Hailuo-2.3 - Mô hình video OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - Chế độ: luồng văn bản thành video và tham chiếu một hình ảnh
- Hỗ trợ
aspectRatiovàresolution
Xem Tạo video để biết các tham số công cụ dùng chung, lựa chọn nhà cung cấp và hành vi chuyển đổi dự phòng.
Hiểu hình ảnh
Plugin MiniMax đăng ký khả năng hiểu hình ảnh tách biệt với danh mục văn bản:| ID nhà cung cấp | Mô hình hình ảnh mặc định |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Tìm kiếm web
Plugin MiniMax cũng đăng kýweb_search thông qua API tìm kiếm MiniMax Token Plan.
- ID nhà cung cấp:
minimax - Kết quả có cấu trúc: tiêu đề, URL, đoạn trích, truy vấn liên quan
- Biến môi trường ưu tiên:
MINIMAX_CODE_PLAN_KEY - Bí danh môi trường được chấp nhận:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Dự phòng tương thích:
MINIMAX_API_KEYkhi biến này đã trỏ tới thông tin xác thực token-plan - Tái sử dụng vùng:
plugins.entries.minimax.config.webSearch.region, rồiMINIMAX_API_HOST, rồi các URL cơ sở của nhà cung cấp MiniMax - Tìm kiếm vẫn ở ID nhà cung cấp
minimax; thiết lập OAuth CN/toàn cầu có thể điều hướng vùng gián tiếp thông quamodels.providers.minimax-portal.baseUrlvà có thể cung cấp xác thực bearer thông quaMINIMAX_OAUTH_TOKEN
plugins.entries.minimax.config.webSearch.*.
Xem Tìm kiếm MiniMax để biết cấu hình và cách dùng tìm kiếm web đầy đủ.
Cấu hình nâng cao
Tùy chọn cấu hình
Tùy chọn cấu hình
| Tùy chọn | Mô tả |
|---|---|
models.providers.minimax.baseUrl | Ưu tiên https://api.minimax.io/anthropic (tương thích Anthropic); https://api.minimax.io/v1 là tùy chọn cho payload tương thích OpenAI |
models.providers.minimax.api | Ưu tiên anthropic-messages; openai-completions là tùy chọn cho payload tương thích OpenAI |
models.providers.minimax.apiKey | Khóa API MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models | Định nghĩa id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models | Đặt bí danh cho các mô hình bạn muốn đưa vào allowlist |
models.mode | Giữ merge nếu bạn muốn thêm MiniMax cùng với các mục tích hợp sẵn |
Mặc định Thinking
Mặc định Thinking
Trên
api: "anthropic-messages", OpenClaw chèn thinking: { type: "disabled" } cho các mô hình MiniMax M2.x trừ khi thinking đã được đặt rõ ràng trong tham số/cấu hình.Điều này ngăn endpoint streaming của M2.x phát ra reasoning_content trong các đoạn delta kiểu OpenAI, vốn sẽ làm lộ suy luận nội bộ trong đầu ra hiển thị.MiniMax-M3 (và M3.x) được miễn trừ: M3 phát ra các khối thinking Anthropic đúng chuẩn và trả về mảng content rỗng với stop_reason: "end_turn" khi thinking bị tắt, nên wrapper giữ M3 trên đường dẫn thinking bị bỏ qua/thích ứng của nhà cung cấp.Chế độ nhanh
Chế độ nhanh
/fast on hoặc params.fastMode: true viết lại MiniMax-M2.7 thành MiniMax-M2.7-highspeed trên đường dẫn stream tương thích Anthropic.Ví dụ dự phòng
Ví dụ dự phòng
Phù hợp nhất cho: giữ mô hình thế hệ mới nhất mạnh nhất của bạn làm chính, chuyển đổi dự phòng sang MiniMax M2.7. Ví dụ bên dưới dùng Opus làm mô hình chính cụ thể; hãy thay bằng mô hình chính thế hệ mới nhất bạn ưa dùng.
Chi tiết sử dụng Coding Plan
Chi tiết sử dụng Coding Plan
- API sử dụng Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainshoặchttps://api.minimax.io/v1/token_plan/remains(yêu cầu khóa coding plan). - Việc thăm dò mức sử dụng lấy host từ
models.providers.minimax-portal.baseUrlhoặcmodels.providers.minimax.baseUrlkhi được cấu hình, vì vậy các thiết lập toàn cầu dùnghttps://api.minimax.io/anthropicsẽ thăm dòapi.minimax.io. URL cơ sở bị thiếu hoặc sai định dạng sẽ giữ dự phòng CN để tương thích. - OpenClaw chuẩn hóa mức sử dụng coding-plan của MiniMax sang cùng màn hình
% leftđược các nhà cung cấp khác dùng. Các trường thôusage_percent/usagePercentcủa MiniMax là hạn mức còn lại, không phải hạn mức đã tiêu thụ, nên OpenClaw đảo ngược chúng. Các trường dựa trên số lượng được ưu tiên khi có. - Khi API trả về
model_remains, OpenClaw ưu tiên mục mô hình trò chuyện, suy ra nhãn cửa sổ từstart_time/end_timekhi cần, và đưa tên mô hình đã chọn vào nhãn gói để các cửa sổ coding-plan dễ phân biệt hơn. - Ảnh chụp nhanh mức sử dụng coi
minimax,minimax-cnvàminimax-portallà cùng một bề mặt hạn mức MiniMax, và ưu tiên OAuth MiniMax đã lưu trước khi dự phòng về các biến môi trường khóa Coding Plan.
Ghi chú
- Tham chiếu mô hình đi theo đường dẫn xác thực:
- Thiết lập khóa API:
minimax/<model> - Thiết lập OAuth:
minimax-portal/<model>
- Thiết lập khóa API:
- Mô hình trò chuyện mặc định:
MiniMax-M3 - Mô hình trò chuyện thay thế:
MiniMax-M2.7,MiniMax-M2.7-highspeed - Onboarding và thiết lập khóa API trực tiếp ghi định nghĩa mô hình cho M3 và cả hai biến thể M2.7
- Hiểu hình ảnh dùng nhà cung cấp phương tiện
MiniMax-VL-01do Plugin sở hữu - Cập nhật giá trị giá trong
models.jsonnếu bạn cần theo dõi chi phí chính xác - Dùng
openclaw models listđể xác nhận ID nhà cung cấp hiện tại, rồi chuyển bằngopenclaw models set minimax/MiniMax-M3hoặcopenclaw models set minimax-portal/MiniMax-M3
Xem Nhà cung cấp mô hình để biết quy tắc nhà cung cấp.
Khắc phục sự cố
"Mô hình không xác định: minimax/MiniMax-M3"
"Mô hình không xác định: minimax/MiniMax-M3"
Điều này thường có nghĩa là nhà cung cấp MiniMax chưa được cấu hình (không có mục nhà cung cấp khớp và không tìm thấy hồ sơ xác thực/khóa môi trường MiniMax). Bản sửa cho phát hiện này có trong 2026.1.12. Sửa bằng cách:
- Nâng cấp lên 2026.1.12 (hoặc chạy từ mã nguồn
main), rồi khởi động lại gateway. - Chạy
openclaw configurevà chọn một tùy chọn xác thực MiniMax, hoặc - Thêm thủ công khối
models.providers.minimaxhoặcmodels.providers.minimax-portalkhớp, hoặc - Đặt
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKEN, hoặc một hồ sơ xác thực MiniMax để nhà cung cấp khớp có thể được chèn.
- Đường dẫn khóa API:
minimax/MiniMax-M3,minimax/MiniMax-M2.7, hoặcminimax/MiniMax-M2.7-highspeed - Đường dẫn OAuth:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7, hoặcminimax-portal/MiniMax-M2.7-highspeed
Trợ giúp thêm: Khắc phục sự cố và FAQ.
Liên quan
Lựa chọn mô hình
Chọn nhà cung cấp, tham chiếu mô hình và hành vi chuyển đổi dự phòng.
Tạo hình ảnh
Tham số công cụ hình ảnh dùng chung và lựa chọn nhà cung cấp.
Tạo nhạc
Tham số công cụ nhạc dùng chung và lựa chọn nhà cung cấp.
Tạo video
Tham số công cụ video dùng chung và lựa chọn nhà cung cấp.
Tìm kiếm MiniMax
Cấu hình tìm kiếm web qua MiniMax Token Plan.
Khắc phục sự cố
Khắc phục sự cố chung và FAQ.