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 ảnh từ văn bản và chỉnh sửa ảnh dựa trên ảnh (tham chiếu chủ thể), cả hai đều hỗ trợ kiểm soát tỷ lệ khung hình
• Tối đa 9 ảnh đầu ra cho mỗi yêu cầu, 1 ả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" },    },  },}

Việc tạo hình ảnh luôn sử dụng điểm cuối dành riêng cho hình ảnh của MiniMax (/v1/image_generation) và bỏ qua models.providers.minimax.baseUrl, vì trường đó dù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 Trung Quốc; đ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
• Các mã định danh 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, speech-01-240228
• Thứ tự phân giải thông tin xác thực: messages.tts.providers.minimax.apiKey, sau đó là các hồ sơ xác thực OAuth/token của minimax-portal, tiếp theo là các khóa môi trường của Gói token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), rồi đến MINIMAX_API_KEY
• Nếu chưa 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 với Anthropic như /anthropic
• Các tệp âm thanh đính kèm 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 48 kHz bằng ffmpeg, vì chẳng hạn API tệp của Feishu/Lark chỉ chấp nhận file_type: "opus" cho tin nhắn âm thanh gốc
• MiniMax T2A chấp nhận giá trị thập phân cho speed và vol, 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 khi gửi yêu cầu API

Tạo nhạc

Plugin MiniMax đi kèm đăng ký khả 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 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 dựa trên phiên được 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ý khả 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ế độ: chuyển văn bản thành video và các 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ý chức năng hiểu hình ảnh riêng biệt với danh mục văn bản:

Đó là lý do cơ chế định tuyến phương tiện tự động có thể sử dụng chức 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. Chức 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 Trung Quốc/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 thiết lập ban đầu 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
• Chức 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