OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

Plugin minimax ที่รวมมาให้ลงทะเบียนผู้ให้บริการ 2 รายและความสามารถ 5 ประเภท ได้แก่ แชต การสร้างภาพ การสร้างเพลง การสร้างวิดีโอ การทำความเข้าใจภาพ เสียงพูด (T2A v2) และการค้นหาเว็บ

ID ผู้ให้บริการ การยืนยันตัวตน ความสามารถ
minimax คีย์ API ข้อความ การสร้างภาพ การสร้างเพลง การสร้างวิดีโอ การทำความเข้าใจภาพ เสียงพูด การค้นหาเว็บ
minimax-portal OAuth ข้อความ การสร้างภาพ การสร้างเพลง การสร้างวิดีโอ การทำความเข้าใจภาพ เสียงพูด

แค็ตตาล็อกในตัว

โมเดล ประเภท คำอธิบาย
MiniMax-M3 แชต (การให้เหตุผล) โมเดลการให้เหตุผลแบบโฮสต์เริ่มต้น
MiniMax-M2.7 แชต (การให้เหตุผล) โมเดลการให้เหตุผลแบบโฮสต์รุ่นก่อนหน้า
MiniMax-M2.7-highspeed แชต (การให้เหตุผล) ระดับการให้เหตุผล M2.7 ที่เร็วขึ้น
MiniMax-VL-01 การมองเห็น โมเดลทำความเข้าใจภาพ
image-01 การสร้างภาพ การแปลงข้อความเป็นภาพและการแก้ไขภาพเป็นภาพ
music-2.6 การสร้างเพลง โมเดลเพลงเริ่มต้น
MiniMax-Hailuo-2.3 การสร้างวิดีโอ ขั้นตอนการแปลงข้อความเป็นวิดีโอและภาพเป็นวิดีโอ

การอ้างอิงโมเดลเป็นไปตามเส้นทางการยืนยันตัวตน: minimax/<model> สำหรับการตั้งค่าด้วยคีย์ API และ minimax-portal/<model> สำหรับการตั้งค่าด้วย OAuth

เริ่มต้นใช้งาน

OAuth (Coding Plan)

เหมาะที่สุดสำหรับ: การตั้งค่าอย่างรวดเร็วด้วย MiniMax Coding Plan ผ่าน OAuth โดยไม่ต้องใช้คีย์ API

ระหว่างประเทศ

  • เรียกใช้การเริ่มต้นใช้งาน

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

    URL ฐานของผู้ให้บริการที่ได้: api.minimax.io

  • ตรวจสอบว่าโมเดลพร้อมใช้งาน

    bash
    openclaw models list --provider minimax-portal

    • จีน

  • เรียกใช้การเริ่มต้นใช้งาน

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

    URL ฐานของผู้ให้บริการที่ได้: api.minimaxi.com

  • ตรวจสอบว่าโมเดลพร้อมใช้งาน

    bash
    openclaw models list --provider minimax-portal

    • คีย์ API

    เหมาะที่สุดสำหรับ: MiniMax แบบโฮสต์ที่ใช้ API ซึ่งเข้ากันได้กับ Anthropic

    ระหว่างประเทศ

  • เรียกใช้การเริ่มต้นใช้งาน

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

    การดำเนินการนี้กำหนดค่า api.minimax.io เป็น URL ฐาน

  • ตรวจสอบว่าโมเดลพร้อมใช้งาน

    bash
    openclaw models list --provider minimax

    • จีน

  • เรียกใช้การเริ่มต้นใช้งาน

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

    การดำเนินการนี้กำหนดค่า api.minimaxi.com เป็น URL ฐาน

  • ตรวจสอบว่าโมเดลพร้อมใช้งาน

    bash
    openclaw models list --provider minimax

    • ตัวอย่างการกำหนดค่า

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

    กำหนดค่าผ่าน openclaw configure

  • เปิดตัวช่วยสร้าง

    bash
    openclaw configure

  • เลือก Model/auth

    เลือก Model/auth จากเมนู

  • เลือกตัวเลือกการยืนยันตัวตน MiniMax

    ตัวเลือกการยืนยันตัวตน คำอธิบาย
    minimax-global-oauth OAuth ระหว่างประเทศ (Coding Plan)
    minimax-cn-oauth OAuth จีน (Coding Plan)
    minimax-global-api คีย์ API ระหว่างประเทศ
    minimax-cn-api คีย์ API จีน

  • เลือกโมเดลเริ่มต้น

    เลือกโมเดลเริ่มต้นเมื่อระบบแจ้ง

    • ความสามารถ

    การสร้างภาพ

    Plugin MiniMax ลงทะเบียนโมเดล image-01 สำหรับเครื่องมือ image_generate ทั้งบน minimax และ minimax-portal โดยใช้ MINIMAX_API_KEY หรือการยืนยันตัวตนด้วย OAuth เดียวกับโมเดลข้อความ

    • การสร้างภาพจากข้อความและการแก้ไขภาพเป็นภาพ (การอ้างอิงตัวแบบ) โดยทั้งสองแบบรองรับการควบคุมอัตราส่วนภาพ
    • สร้างภาพผลลัพธ์ได้สูงสุด 9 ภาพต่อคำขอ และใช้ภาพอ้างอิงได้ 1 ภาพต่อคำขอแก้ไข
    • อัตราส่วนภาพที่รองรับ: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

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

    การแปลงข้อความเป็นเสียงพูด

    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/โทเค็น 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
    การตั้งค่า ตัวแปรสภาพแวดล้อม ค่าเริ่มต้น คำอธิบาย
    messages.tts.providers.minimax.baseUrl MINIMAX_API_HOST https://api.minimax.io โฮสต์ API ของ MiniMax T2A
    messages.tts.providers.minimax.model MINIMAX_TTS_MODEL speech-2.8-hd ID โมเดล TTS
    messages.tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator ID เสียงที่ใช้สำหรับเอาต์พุตเสียงพูด
    messages.tts.providers.minimax.speed 1.0 ความเร็วในการเล่น 0.5..2.0
    messages.tts.providers.minimax.vol 1.0 ระดับเสียง (0, 10]
    messages.tts.providers.minimax.pitch 0 การเลื่อนระดับเสียงแบบจำนวนเต็ม -12..12

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

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

    • โมเดลเพลงเริ่มต้น: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
    • รองรับ music-2.6-free, music-cover และ music-cover-free ด้วย
    • การควบคุมพรอมต์: lyrics, instrumental
    • รูปแบบเอาต์พุต: mp3
    • การเรียกใช้ที่มีเซสชันรองรับจะแยกไปทำงานผ่านขั้นตอนงาน/สถานะที่ใช้ร่วมกัน รวมถึง action: "status"
    json5
    {  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)
    • รองรับ MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live และ I2V-01 ด้วย
    • โหมด: ขั้นตอนการแปลงข้อความเป็นวิดีโอและการใช้อ้างอิงจากภาพเดียว
    • รองรับ resolution (768P หรือ 1080P ในโมเดล Hailuo 2.3/02); ไม่รองรับ aspectRatio และระบบจะละเว้นค่านี้
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

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

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

    ID ผู้ให้บริการ โมเดลภาพเริ่มต้น การแยกข้อความจาก PDF
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

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

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

    Plugin MiniMax ยังลงทะเบียน web_search ผ่าน API ค้นหาของ MiniMax Token Plan (/v1/coding_plan/search)

    • ID ผู้ให้บริการ: minimax
    • ผลลัพธ์แบบมีโครงสร้าง: ชื่อเรื่อง, URL, ตัวอย่างเนื้อหา, คำค้นหาที่เกี่ยวข้อง
    • ตัวแปรสภาพแวดล้อมที่แนะนำ: MINIMAX_CODE_PLAN_KEY
    • นามแฝงตัวแปรสภาพแวดล้อมที่ยอมรับ: 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/ทั่วโลกสามารถกำหนดภูมิภาคโดยอ้อมผ่าน models.providers.minimax-portal.baseUrl และให้การยืนยันตัวตนแบบ bearer ผ่าน MINIMAX_OAUTH_TOKEN ได้

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

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

    ตัวเลือกการกำหนดค่า
    ตัวเลือก คำอธิบาย
    models.providers.minimax.baseUrl แนะนำให้ใช้ https://api.minimax.io/anthropic (เข้ากันได้กับ Anthropic); https://api.minimax.io/v1 เป็นตัวเลือกสำหรับเพย์โหลดที่เข้ากันได้กับ OpenAI
    models.providers.minimax.api แนะนำให้ใช้ anthropic-messages; openai-completions เป็นตัวเลือกสำหรับเพย์โหลดที่เข้ากันได้กับ OpenAI
    models.providers.minimax.apiKey คีย์ API ของ MiniMax (MINIMAX_API_KEY)
    models.providers.minimax.models กำหนด id, name, reasoning, contextWindow, maxTokens, cost
    agents.defaults.models นามแฝง พารามิเตอร์ และข้อมูลเมตาของแต่ละโมเดล
    agents.defaults.modelPolicy.allow รายการอนุญาตโมเดลแบบระบุชัดเจนซึ่งเป็นตัวเลือก
    models.mode คง merge ไว้ หากต้องการเพิ่ม MiniMax ควบคู่กับระบบที่มีมาให้
    ค่าเริ่มต้นของการคิด

    ใน api: "anthropic-messages" OpenClaw จะแทรก thinking: { type: "disabled" } สำหรับโมเดล MiniMax M2.x เว้นแต่ตัวห่อหุ้มก่อนหน้านี้จะกำหนดฟิลด์ thinking ในเพย์โหลดไว้แล้ว วิธีนี้ป้องกันไม่ให้ปลายทางสตรีมของ M2.x ส่ง reasoning_content ในส่วนข้อมูลเดลตารูปแบบ OpenAI ซึ่งจะทำให้กระบวนการให้เหตุผลภายในรั่วไหลออกมาในผลลัพธ์ที่มองเห็นได้

    MiniMax-M3 (และ M3.x) ได้รับการยกเว้น: เมื่อปิดการคิด M3 จะส่งคืนอาร์เรย์ content ว่างพร้อม stop_reason: "end_turn" ดังนั้น OpenClaw จึงนำค่าเริ่มต้นแบบปิดโดยนัยสำหรับ M3 ออก และเมื่อกำหนดระดับการคิด ระบบจะบังคับใช้ thinking: { type: "adaptive" } แทน

    ระดับการคิดที่ใช้ได้สำหรับแต่ละตระกูลโมเดล:

    ตระกูลโมเดล ระดับ ค่าเริ่มต้น
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    โหมดเร็ว

    /fast on หรือ params.fastMode: true จะเขียน MiniMax-M2.7 ใหม่เป็น MiniMax-M2.7-highspeed ในเส้นทางสตรีมที่เข้ากันได้กับ Anthropic (api: "anthropic-messages", ผู้ให้บริการ minimax หรือ minimax-portal)

    ตัวอย่างการสลับไปใช้ระบบสำรอง

    เหมาะที่สุดสำหรับ: ใช้โมเดลรุ่นล่าสุดที่มีประสิทธิภาพสูงสุดเป็นโมเดลหลัก และสลับไปใช้ MiniMax M2.7 เมื่อระบบหลักล้มเหลว ตัวอย่างด้านล่างใช้ Opus เป็นโมเดลหลักที่เป็นรูปธรรม โดยสามารถเปลี่ยนเป็นโมเดลหลักรุ่นล่าสุดที่ต้องการได้

    json5
    {  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"],      },    },  },}
    รายละเอียดการใช้งาน Coding Plan
    • API การใช้งาน Coding Plan: https://api.minimaxi.com/v1/token_plan/remains หรือ https://api.minimax.io/v1/token_plan/remains (ต้องใช้คีย์ Coding Plan)
    • การสำรวจการใช้งานจะอนุมานโฮสต์จาก models.providers.minimax-portal.baseUrl หรือ models.providers.minimax.baseUrl เมื่อมีการกำหนดค่า ดังนั้นการตั้งค่าแบบทั่วโลกที่ใช้ https://api.minimax.io/anthropic จะสำรวจ api.minimax.io หาก URL ฐานขาดหายหรือมีรูปแบบไม่ถูกต้อง ระบบจะคงทางเลือกสำรอง CN ไว้เพื่อความเข้ากันได้
    • OpenClaw ปรับข้อมูลการใช้งาน Coding Plan ของ MiniMax ให้เป็นรูปแบบการแสดงผล % left เดียวกับที่ผู้ให้บริการรายอื่นใช้ ฟิลด์ดิบ usage_percent / usagePercent ของ MiniMax คือโควตาที่เหลือ ไม่ใช่โควตาที่ใช้ไป ดังนั้น OpenClaw จึงกลับค่าดังกล่าว หากมีฟิลด์ที่อิงจำนวน ระบบจะให้ความสำคัญกับฟิลด์นั้น
    • เมื่อ API ส่งคืน model_remains OpenClaw จะให้ความสำคัญกับรายการโมเดลแชต อนุมานป้ายกำกับช่วงเวลาจาก start_time / end_time เมื่อจำเป็น และใส่ชื่อโมเดลที่เลือกไว้ในป้ายกำกับแผน เพื่อให้แยกแยะช่วงเวลาของ Coding Plan ได้ง่ายขึ้น
    • สแนปช็อตการใช้งานจะถือว่า minimax, minimax-cn, minimax-portal และ minimax-portal-cn เป็นพื้นผิวโควตา MiniMax เดียวกัน และให้ความสำคัญกับ OAuth ของ MiniMax ที่จัดเก็บไว้ก่อนใช้ตัวแปรสภาพแวดล้อมของคีย์ Coding Plan เป็นทางเลือกสำรอง

    หมายเหตุ

    • โมเดลแชตเริ่มต้น: MiniMax-M3 โมเดลแชตทางเลือก: MiniMax-M2.7, MiniMax-M2.7-highspeed
    • การเริ่มต้นใช้งานและการตั้งค่าคีย์ 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

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

    "โมเดลที่ไม่รู้จัก: minimax/MiniMax-M3"

    โดยทั่วไปหมายความว่า ยังไม่ได้กำหนดค่าผู้ให้บริการ MiniMax (ไม่พบรายการผู้ให้บริการที่ตรงกัน และไม่พบโปรไฟล์การยืนยันตัวตนหรือคีย์ตัวแปรสภาพแวดล้อมของ MiniMax) แก้ไขโดย:

    • เรียกใช้ openclaw configure และเลือกตัวเลือกการยืนยันตัวตนของ MiniMax หรือ
    • เพิ่มบล็อก models.providers.minimax หรือ models.providers.minimax-portal ที่ตรงกันด้วยตนเอง หรือ
    • กำหนด MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN หรือโปรไฟล์การยืนยันตัวตน MiniMax เพื่อให้ระบบแทรกผู้ให้บริการที่ตรงกันได้

    ตรวจสอบว่า ID โมเดล คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่:

    • เส้นทางคีย์ API: minimax/MiniMax-M3, minimax/MiniMax-M2.7 หรือ minimax/MiniMax-M2.7-highspeed
    • เส้นทาง OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 หรือ minimax-portal/MiniMax-M2.7-highspeed

    จากนั้นตรวจสอบอีกครั้งด้วย:

    bash
    openclaw models list

    เนื้อหาที่เกี่ยวข้อง

    การเลือกโมเดล

    การเลือกผู้ให้บริการ การอ้างอิงโมเดล และลักษณะการทำงานของการสลับไปใช้ระบบสำรอง
    การสร้างภาพ

    พารามิเตอร์เครื่องมือภาพที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
    การสร้างเพลง

    พารามิเตอร์เครื่องมือเพลงที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
    การสร้างวิดีโอ

    พารามิเตอร์เครื่องมือวิดีโอที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
    การค้นหาด้วย MiniMax

    การกำหนดค่าการค้นหาเว็บผ่าน MiniMax Token Plan
    การแก้ไขปัญหา

    การแก้ไขปัญหาทั่วไปและคำถามที่พบบ่อย
    Was this useful?
    On this page

    On this page