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

# ความสามารถ

# การสร้างภาพ

Plugin MiniMax ลงทะเบียนโมเดล image-01 สำหรับเครื่องมือ image_generate รองรับ:

• การสร้างภาพจากข้อความ พร้อมการควบคุมอัตราส่วนภาพ
• การแก้ไขภาพจากภาพ (การอ้างอิงวัตถุหลัก) พร้อมการควบคุมอัตราส่วนภาพ
• สูงสุด 9 ภาพเอาต์พุต ต่อคำขอ
• สูงสุด 1 ภาพอ้างอิง ต่อคำขอแก้ไข
• อัตราส่วนภาพที่รองรับ: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

หากต้องการใช้ MiniMax สำหรับการสร้างภาพ ให้ตั้งค่าเป็นผู้ให้บริการการสร้างภาพ:

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

Plugin ใช้ MINIMAX_API_KEY เดียวกัน หรือการยืนยันตัวตน OAuth เดียวกับโมเดลข้อความ ไม่จำเป็นต้องตั้งค่าเพิ่มเติมหากตั้งค่า MiniMax ไว้แล้ว

ทั้ง minimax และ minimax-portal ลงทะเบียน image_generate ด้วยโมเดล image-01 เดียวกัน การตั้งค่าด้วยคีย์ API ใช้ MINIMAX_API_KEY; การตั้งค่าด้วย OAuth สามารถใช้ เส้นทางการยืนยันตัวตน minimax-portal ที่รวมมาให้แทนได้

การสร้างภาพใช้ปลายทางภาพเฉพาะของ MiniMax เสมอ (/v1/image_generation) และละเว้น models.providers.minimax.baseUrl เนื่องจากฟิลด์นั้นกำหนดค่า URL ฐานสำหรับแชต/ที่เข้ากันได้กับ Anthropic ตั้งค่า MINIMAX_API_HOST=https://api.minimaxi.com เพื่อกำหนดเส้นทางการสร้างภาพ ผ่านปลายทาง CN; ปลายทางสากลเริ่มต้นคือ https://api.minimax.io

เมื่อการเริ่มต้นใช้งานหรือการตั้งค่าคีย์ API เขียนรายการ models.providers.minimax แบบชัดเจน OpenClaw จะสร้าง MiniMax-M2.7 และ MiniMax-M2.7-highspeed เป็นโมเดลแชตแบบข้อความเท่านั้น การเข้าใจภาพ ถูกเปิดเผยแยกต่างหากผ่านผู้ให้บริการสื่อ MiniMax-VL-01 ที่ Plugin เป็นเจ้าของ

# ข้อความเป็นเสียงพูด

Plugin minimax ที่รวมมาให้ลงทะเบียน MiniMax T2A v2 เป็นผู้ให้บริการเสียงพูดสำหรับ messages.tts

• โมเดล TTS เริ่มต้น: speech-2.8-hd
• เสียงเริ่มต้น: English_expressive_narrator
• ID โมเดลที่รวมมาและรองรับ ได้แก่ 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
• การแก้ไขการยืนยันตัวตนใช้ messages.tts.providers.minimax.apiKey จากนั้น โปรไฟล์การยืนยันตัวตน OAuth/token ของ minimax-portal จากนั้นคีย์สภาพแวดล้อม Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) แล้วจึงใช้ MINIMAX_API_KEY
• หากไม่ได้กำหนดค่าโฮสต์ TTS OpenClaw จะใช้โฮสต์ OAuth ของ minimax-portal ที่กำหนดค่าไว้ซ้ำ และตัดส่วนท้ายเส้นทางที่เข้ากันได้กับ Anthropic เช่น /anthropic
• ไฟล์แนบเสียงปกติยังคงเป็น MP3
• ปลายทางโน้ตเสียง เช่น Feishu และ Telegram จะถูกแปลงรหัสจาก MP3 ของ MiniMax เป็น Opus 48kHz ด้วย ffmpeg เนื่องจาก API ไฟล์ของ Feishu/Lark ยอมรับเฉพาะ file_type: "opus" สำหรับข้อความเสียงแบบเนทีฟ
• MiniMax T2A ยอมรับ speed และ vol แบบทศนิยม แต่ pitch จะถูกส่งเป็น จำนวนเต็ม; OpenClaw จะตัดค่าทศนิยมของ pitch ออกก่อนส่งคำขอ API

# การสร้างเพลง

Plugin MiniMax ที่รวมมาให้ลงทะเบียนการสร้างเพลงผ่านเครื่องมือร่วม music_generate สำหรับทั้ง minimax และ minimax-portal

• โมเดลเพลงเริ่มต้น: minimax/music-2.6
• โมเดลเพลง OAuth: minimax-portal/music-2.6
• รองรับ minimax/music-2.5 และ minimax/music-2.0 ด้วย
• การควบคุมพรอมต์: lyrics, instrumental, durationSeconds
• รูปแบบเอาต์พุต: 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 แชต M2.7 แบบข้อความเท่านั้น

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

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

• ID ผู้ให้บริการ: minimax
• ผลลัพธ์แบบมีโครงสร้าง: ชื่อเรื่อง, URL, snippets, คำค้นหาที่เกี่ยวข้อง
• env var ที่แนะนำ: MINIMAX_CODE_PLAN_KEY
• env aliases ที่ยอมรับ: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• fallback เพื่อความเข้ากันได้: MINIMAX_API_KEY เมื่อชี้ไปยังข้อมูลรับรอง token-plan อยู่แล้ว
• การใช้ภูมิภาคซ้ำ: plugins.entries.minimax.config.webSearch.region จากนั้น MINIMAX_API_HOST จากนั้น base URLs ของผู้ให้บริการ 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-M2.7
• โมเดลแชตทางเลือก: MiniMax-M2.7-highspeed
• การ onboarding และการตั้งค่าคีย์ API โดยตรงจะเขียนคำจำกัดความโมเดลแบบข้อความเท่านั้นสำหรับ M2.7 ทั้งสอง variants
• การเข้าใจรูปภาพใช้ผู้ให้บริการสื่อ MiniMax-VL-01 ที่ Plugin เป็นเจ้าของ
• อัปเดตราคาค่าใช้จ่ายใน models.json หากคุณต้องการติดตามต้นทุนอย่างแม่นยำ
• ใช้ openclaw models list เพื่อยืนยัน ID ผู้ให้บริการปัจจุบัน จากนั้นสลับด้วย openclaw models set minimax/MiniMax-M2.7 หรือ openclaw models set minimax-portal/MiniMax-M2.7

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

openclaw models list

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