Chuyển đến nội dung chính
OpenClaw’s MiniMax provider defaults to MiniMax M3. MiniMax also provides:
  • Bundled speech synthesis via T2A v2
  • Bundled image understanding via MiniMax-VL-01
  • Bundled music generation via music-2.6
  • Bundled web_search through the MiniMax Token Plan search API
Provider split:
Provider IDAuthCapabilities
minimaxAPI keyText, image generation, music generation, video generation, image understanding, speech, web search
minimax-portalOAuthText, image generation, music generation, video generation, image understanding, speech

Built-in catalog

ModelTypeDescription
MiniMax-M3Chat (reasoning)Default hosted reasoning model
MiniMax-M2.7Chat (reasoning)Previous hosted reasoning model
MiniMax-M2.7-highspeedChat (reasoning)Faster M2.7 reasoning tier
MiniMax-VL-01VisionImage understanding model
image-01Image generationText-to-image and image-to-image editing
music-2.6Music generationDefault music model
music-2.5Music generationPrevious music generation tier
music-2.0Music generationLegacy music generation tier
MiniMax-Hailuo-2.3Video generationText-to-video and image reference flows

Getting started

Choose your preferred auth method and follow the setup steps.
Best for: quick setup with MiniMax Coding Plan via OAuth, no API key required.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
This authenticates against api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
OAuth setups use the minimax-portal provider id. Model refs follow the form minimax-portal/MiniMax-M3.
Referral link for MiniMax Coding Plan (10% off): MiniMax Coding Plan

Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:
1

Launch the wizard

openclaw configure
2

Select Model/auth

Choose Model/auth from the menu.
3

Choose a MiniMax auth option

Pick one of the available MiniMax options:
Auth choiceDescription
minimax-global-oauthInternational OAuth (Coding Plan)
minimax-cn-oauthChina OAuth (Coding Plan)
minimax-global-apiInternational API key
minimax-cn-apiChina API key
4

Pick your default model

Select your default model when prompted.

Capabilities

Image generation

The MiniMax plugin registers the image-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
To use MiniMax for image generation, set it as the image generation provider:
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
The plugin uses the same 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 bundled minimax 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, and speech-01-turbo.
  • Auth resolution is messages.tts.providers.minimax.apiKey, then minimax-portal OAuth/token auth profiles, then Token Plan environment keys (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), then MINIMAX_API_KEY.
  • If no TTS host is configured, OpenClaw reuses the configured minimax-portal OAuth 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 accepts file_type: "opus" for native audio messages.
  • MiniMax T2A accepts fractional speed and vol, but pitch is sent as an integer; OpenClaw truncates fractional pitch values before the API request.
SettingEnv varDefaultDescription
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax T2A API host.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS model id.
messages.tts.providers.minimax.speakerVoiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorVoice id used for speech output.
messages.tts.providers.minimax.speed1.0Playback speed, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volume, (0, 10].
messages.tts.providers.minimax.pitch0Integer pitch shift, -12..12.

Music generation

The bundled MiniMax plugin registers music generation through the shared music_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.5minimax/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"
Để dùng MiniMax làm nhà cung cấp nhạc mặc định:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
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 chung video_generate cho cả minimaxminimax-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ợ aspectRatioresolution
Để dùng MiniMax làm nhà cung cấp video mặc định:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
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ấpMô hình hình ảnh mặc định
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Đó là lý do định tuyến phương tiện tự động có thể dùng khả năng hiểu hình ảnh của MiniMax ngay cả khi danh mục nhà cung cấp văn bản đi kèm cũng bao gồm các tham chiếu trò chuyện M3 có khả năng xử lý hình ảnh.

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_KEY khi 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ồi MINIMAX_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 qua models.providers.minimax-portal.baseUrl và có thể cung cấp xác thực bearer thông qua MINIMAX_OAUTH_TOKEN
Cấu hình nằm dưới 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ọnMô 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.apiKeyKhó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.modeGiữ merge nếu bạn muốn thêm MiniMax cùng với các mục tích hợp sẵn
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.
/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.
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.
{
  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 sử dụng Coding Plan: https://api.minimaxi.com/v1/token_plan/remains hoặc https://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.baseUrl hoặc models.providers.minimax.baseUrl khi được cấu hình, vì vậy các thiết lập toàn cầu dùng https://api.minimax.io/anthropic sẽ 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 / usagePercent củ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_time khi 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-cnminimax-portal là 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>
  • 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-01 do Plugin sở hữu
  • Cập nhật giá trị giá trong models.json nế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ằng openclaw models set minimax/MiniMax-M3 hoặc openclaw models set minimax-portal/MiniMax-M3
Liên kết giới thiệu cho MiniMax Coding Plan (giảm 10%): MiniMax Coding Plan
Xem Nhà cung cấp mô hình để biết quy tắc nhà cung cấp.

Khắc phục sự cố

Đ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 configure và chọn một tùy chọn xác thực MiniMax, hoặc
  • Thêm thủ công khối models.providers.minimax hoặc models.providers.minimax-portal khớ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.
Đảm bảo ID mô hình phân biệt chữ hoa chữ thường:
  • Đường dẫn khóa API: minimax/MiniMax-M3, minimax/MiniMax-M2.7, hoặc minimax/MiniMax-M2.7-highspeed
  • Đường dẫn OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7, hoặc minimax-portal/MiniMax-M2.7-highspeed
Sau đó kiểm tra lại bằng:
openclaw models list
Trợ giúp thêm: Khắc phục sự cố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.