MiniMax

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:

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

Configure via openclaw configure

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

openclaw configure

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.

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.

Music generation

The bundled MiniMax plugin registers music generation through the shared music_generate tool for both minimax and minimax-portal.

• โมเดลเพลงเริ่มต้น: minimax/music-2.6
• โมเดลเพลง OAuth: minimax-portal/music-2.6
• รองรับ minimax/music-2.5 และ minimax/music-2.0 ด้วย
• การควบคุมพรอมป์: lyrics, instrumental
• รูปแบบเอาต์พุต: mp3
• การรันที่มีเซสชันรองรับจะแยกตัวผ่านโฟลว์งาน/สถานะร่วม รวมถึง action: "status"

หากต้องการใช้ MiniMax เป็นผู้ให้บริการเพลงเริ่มต้น:

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

การสร้างวิดีโอ

Plugin MiniMax ที่มาพร้อมชุดติดตั้งลงทะเบียนการสร้างวิดีโอผ่านเครื่องมือร่วม video_generate สำหรับทั้ง minimax และ minimax-portal

• โมเดลวิดีโอเริ่มต้น: minimax/MiniMax-Hailuo-2.3
• โมเดลวิดีโอ OAuth: minimax-portal/MiniMax-Hailuo-2.3
• โหมด: โฟลว์ข้อความเป็นวิดีโอและโฟลว์อ้างอิงภาพเดี่ยว
• รองรับ aspectRatio และ resolution

หากต้องการใช้ MiniMax เป็นผู้ให้บริการวิดีโอเริ่มต้น:

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

การทำความเข้าใจภาพ

Plugin MiniMax ลงทะเบียนการทำความเข้าใจภาพแยกจากแคตตาล็อกข้อความ:

นี่คือเหตุผลที่การกำหนดเส้นทางสื่ออัตโนมัติสามารถใช้การทำความเข้าใจภาพของ MiniMax ได้ แม้เมื่อแคตตาล็อกผู้ให้บริการข้อความที่มาพร้อมชุดติดตั้งมี refs แชตที่รองรับภาพของ M3 ด้วย

การค้นหาเว็บ

Plugin MiniMax ยังลงทะเบียน web_search ผ่าน API ค้นหา MiniMax Token Plan ด้วย

• ID ผู้ให้บริการ: minimax
• ผลลัพธ์แบบมีโครงสร้าง: ชื่อเรื่อง, URL, snippets, คำค้นที่เกี่ยวข้อง
• ตัวแปรสภาพแวดล้อมที่แนะนำ: MINIMAX_CODE_PLAN_KEY
• นามแฝง env ที่ยอมรับ: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• ทางเลือกสำรองด้านความเข้ากันได้: MINIMAX_API_KEY เมื่อชี้ไปยังข้อมูลรับรอง token-plan อยู่แล้ว
• การใช้ภูมิภาคซ้ำ: plugins.entries.minimax.config.webSearch.region จากนั้น MINIMAX_API_HOST จากนั้น URL ฐานของผู้ให้บริการ MiniMax
• การค้นหายังคงอยู่บน ID ผู้ให้บริการ minimax; การตั้งค่า OAuth CN/global สามารถกำหนดภูมิภาคทางอ้อมผ่าน models.providers.minimax-portal.baseUrl และสามารถให้ bearer auth ผ่าน MINIMAX_OAUTH_TOKEN

การกำหนดค่าอยู่ใต้ plugins.entries.minimax.config.webSearch.*

การกำหนดค่าขั้นสูง

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

หมายเหตุ

• refs โมเดลเป็นไปตามเส้นทาง auth:
  • การตั้งค่าด้วยคีย์ API: minimax/<model>
  • การตั้งค่า OAuth: minimax-portal/<model>
• โมเดลแชตเริ่มต้น: MiniMax-M3
• โมเดลแชตทางเลือก: MiniMax-M2.7, MiniMax-M2.7-highspeed
• การ onboarding และการตั้งค่าคีย์ API โดยตรงจะเขียนคำจำกัดความโมเดลสำหรับ M3 และตัวแปร M2.7 ทั้งสองแบบ
• การทำความเข้าใจภาพใช้ผู้ให้บริการสื่อ MiniMax-VL-01 ที่ Plugin เป็นเจ้าของ
• อัปเดตราคาค่าใช้จ่ายใน models.json หากคุณต้องการการติดตามต้นทุนที่แม่นยำ
• ใช้ openclaw models list เพื่อยืนยัน ID ผู้ให้บริการปัจจุบัน จากนั้นสลับด้วย openclaw models set minimax/MiniMax-M3 หรือ openclaw models set minimax-portal/MiniMax-M3

การแก้ไขปัญหา

openclaw models list

ที่เกี่ยวข้อง