MiniMax

Plugin minimax đi kèm đăng ký hai nhà cung cấp cùng năm khả năng: trò chuyện, tạo hình ảnh, tạo nhạc, tạo video, hiểu hình ảnh, giọng nói (T2A v2) và tìm kiếm web.

Danh mục tích hợp sẵn

Tham chiếu mô hình tuân theo phương thức xác thực: minimax/<model> cho thiết lập bằng khóa API, minimax-portal/<model> cho thiết lập bằng OAuth.

Bắt đầu

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

Cấu hình qua openclaw configure

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 trên cả minimax và minimax-portal, sử dụng lại cùng MINIMAX_API_KEY hoặc thông tin xác thực OAuth như các mô hình văn bản.

• Tạo hình ảnh từ văn bản và chỉnh sửa từ hình ảnh sang hình ảnh (tham chiếu chủ thể), cả hai đều có tính 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, 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

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

Tính năng tạo hình ảnh luôn sử dụng điểm cuối 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 với trò chuyện/Anthropic. Đặt MINIMAX_API_HOST=https://api.minimaxi.com để định tuyến việc tạo hình ảnh qua điểm cuối CN; điểm cuối toàn cầu mặc định là https://api.minimax.io.

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
• ID mô hình đi kè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, speech-01-turbo
• Thứ tự phân giải xác thực: messages.tts.providers.minimax.apiKey, sau đó là các hồ sơ xác thực OAuth/token minimax-portal, tiếp theo là các khóa môi trường Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), rồi đến MINIMAX_API_KEY
• Nếu không cấu hình máy chủ TTS, OpenClaw sử 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
• Các tệp đính kèm âm thanh thông thường vẫn ở định dạng MP3. Các đích ghi chú thoại (Feishu, Telegram và các kênh khác yêu cầu tệp đính kèm tương thích với ghi chú thoại) được chuyển mã từ MP3 của MiniMax sang Opus 48kHz bằng ffmpeg, vì chẳng hạn 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 phân số, 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 các giá trị pitch trước yêu cầu API

Tạo nhạc

Plugin MiniMax đi kèm đăng ký tính năng tạo nhạc thông qua công cụ dùng chung music_generate cho cả minimax và minimax-portal.

• Mô hình âm nhạc mặc định: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
• Cũng hỗ trợ music-2.6-free, music-cover và music-cover-free
• Các tham số điều khiển lời nhắc: lyrics, instrumental
• Định dạng đầu ra: mp3
• Các lượt chạy có phiên hỗ trợ sẽ tách ra thông qua luồng tác vụ/trạng thái dùng chung, bao gồm action: "status"

{  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

Tạo video

Plugin MiniMax đi kèm đăng ký tính năng 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 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
• Cũng hỗ trợ MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live và I2V-01
• Chế độ: luồng văn bản thành video và luồng tham chiếu một hình ảnh
• Hỗ trợ resolution (768P hoặc 1080P trên các mô hình Hailuo 2.3/02); aspectRatio không được hỗ trợ và sẽ bị bỏ qua

{  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 riêng 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ể sử 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 chứa các tham chiếu trò chuyện M3 có khả năng xử lý hình ảnh. Khả năng hiểu PDF chỉ sử dụng MiniMax-M2.7 để trích xuất văn bản; MiniMax không đăng ký đường dẫn chuyển đổi PDF thành 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 (/v1/coding_plan/search).

• 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 biến môi trường được chấp nhận: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Phương án dự phòng tương thích: MINIMAX_API_KEY khi biến này đã trỏ đến thông tin xác thực của gói token
• Tái sử dụng khu vực: plugins.entries.minimax.config.webSearch.region, sau đó MINIMAX_API_HOST, rồi đến 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ể gián tiếp điều hướng khu vực 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 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ú

• Mô hình trò chuyện mặc định: MiniMax-M3. Các mô hình trò chuyện thay thế: MiniMax-M2.7, MiniMax-M2.7-highspeed
• Quy trình làm quen và thiết lập trực tiếp bằng khóa API ghi định nghĩa mô hình cho M3 và cả hai biến thể M2.7
• Khả năng hiểu hình ảnh sử dụng nhà cung cấp phương tiện MiniMax-VL-01 do Plugin sở hữu
• Cập nhật các giá trị định 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, sau đó chuyển đổi bằng openclaw models set minimax/MiniMax-M3 hoặc openclaw models set minimax-portal/MiniMax-M3

Khắc phục sự cố

openclaw models list

Liên quan