MiniMax

OpenClaw's MiniMax provider defaults to MiniMax M2.7.

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:

# Built-in catalog

# Getting started

Choose your preferred auth method and follow the setup steps.

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider minimax

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            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,
          },
        ],
      },
    },
  },
}

# Configure via openclaw configure

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

openclaw configure

# Khả năng

# Tạo hình ảnh

Plugin MiniMax đăng ký mô hình image-01 cho công cụ image_generate. Công cụ này hỗ trợ:

• Tạo hình ảnh từ văn bản với khả năng kiểm soát tỷ lệ khung hình
• Chỉnh sửa hình ảnh từ hình ảnh (tham chiếu chủ thể) với khả năng kiểm soát tỷ lệ khung hình
• Tối đa 9 hình ảnh đầu ra cho mỗi yêu cầu
• Tối đa 1 hình ảnh tham chiếu cho mỗi yêu cầu chỉnh sửa
• Các tỷ lệ khung hình được hỗ trợ: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

Để dùng MiniMax cho tạo hình ảnh, hãy đặt MiniMax làm nhà cung cấp tạo hình ảnh:

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Plugin sử dụng cùng MINIMAX_API_KEY hoặc xác thực OAuth như các mô hình văn bản. Không cần cấu hình bổ sung nếu MiniMax đã được thiết lập.

Cả minimax và minimax-portal đều đăng ký image_generate với cùng mô hình image-01. Các thiết lập khóa API dùng MINIMAX_API_KEY; các thiết lập OAuth có thể dùng đường dẫn xác thực minimax-portal đi kèm thay thế.

Tạo hình ảnh luôn dùng endpoint hình ảnh chuyên dụng của MiniMax (/v1/image_generation) và bỏ qua models.providers.minimax.baseUrl, vì trường đó cấu hình URL cơ sở tương thích chat/Anthropic. Đặt MINIMAX_API_HOST=https://api.minimaxi.com để định tuyến tạo hình ảnh qua endpoint CN; endpoint toàn cầu mặc định là https://api.minimax.io.

Khi onboarding hoặc thiết lập khóa API ghi các mục models.providers.minimax rõ ràng, OpenClaw hiện thực hóa MiniMax-M2.7 và MiniMax-M2.7-highspeed dưới dạng các mô hình chat chỉ dành cho văn bản. Khả năng hiểu hình ảnh được cung cấp riêng thông qua nhà cung cấp phương tiện MiniMax-VL-01 do Plugin sở hữu.

# Chuyển văn bản thành giọng nói

Plugin minimax đi kèm đăng ký MiniMax T2A v2 làm nhà cung cấp giọng nói cho messages.tts.

• Mô hình TTS mặc định: speech-2.8-hd
• Giọng nói mặc định: English_expressive_narrator
• Các id mô hình đi kèm được hỗ trợ bao gồm 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, và speech-01-turbo.
• Thứ tự phân giải xác thực là messages.tts.providers.minimax.apiKey, sau đó hồ sơ xác thực OAuth/token minimax-portal, sau đó các khóa môi trường Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), rồi MINIMAX_API_KEY.
• Nếu chưa cấu hình máy chủ TTS, OpenClaw dùng lại máy chủ OAuth minimax-portal đã cấu hình và loại bỏ các hậu tố đường dẫn tương thích Anthropic như /anthropic.
• Tệp đính kèm âm thanh thông thường vẫn là MP3.
• Các đích ghi chú thoại như Feishu và Telegram được chuyển mã từ MP3 của MiniMax sang Opus 48kHz bằng ffmpeg, vì API tệp Feishu/Lark chỉ chấp nhận file_type: "opus" cho tin nhắn âm thanh gốc.
• MiniMax T2A chấp nhận speed và vol dạng số thập phân, nhưng pitch được gửi dưới dạng số nguyên; OpenClaw cắt bỏ phần thập phân của giá trị pitch trước yêu cầu API.

# Tạo nhạc

Plugin MiniMax đi kèm đăng ký tạo nhạc thông qua công cụ dùng chung music_generate cho cả minimax và 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.5 và minimax/music-2.0
• Điều khiển prompt: lyrics, instrumental, durationSeconds
• Định dạng đầu ra: mp3
• Các lần chạy có phiên hỗ trợ tách ra thông 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",
      },
    },
  },
}

# 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ả 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ợ aspectRatio và resolution

Để dùng MiniMax làm nhà cung cấp video mặc định:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}

# 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:

Đó 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 tích hợp vẫn chỉ hiển thị các tham chiếu trò chuyện M2.7 dạng chỉ văn bản.

# 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 nó đã trỏ đến thông tin xác thực token-plan
• Tái sử dụng khu vực: 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 dùng ID nhà cung cấp minimax; thiết lập OAuth CN/toàn cầu có thể điều hướng khu vực gián tiếp qua models.providers.minimax-portal.baseUrl và có thể cung cấp xác thực bearer qua MINIMAX_OAUTH_TOKEN

Cấu hình nằm trong plugins.entries.minimax.config.webSearch.*.

# Cấu hình nâng cao

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

# Ghi chú

• Tham chiếu mô hình tuân theo đường dẫn xác thực:
  • Thiết lập bằng khóa API: minimax/<model>
  • Thiết lập OAuth: minimax-portal/<model>
• Mô hình trò chuyện mặc định: MiniMax-M2.7
• Mô hình trò chuyện thay thế: MiniMax-M2.7-highspeed
• Onboarding và thiết lập khóa API trực tiếp ghi các định nghĩa mô hình chỉ văn bản cho 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-M2.7 hoặc openclaw models set minimax-portal/MiniMax-M2.7

# Khắc phục sự cố

openclaw models list

# Liên quan