Providers
MiniMax
Plugin minimax ที่มาพร้อมระบบจะลงทะเบียนผู้ให้บริการสองรายและความสามารถเจ็ดรายการ ได้แก่ แชต การสร้างรูปภาพ การสร้างเพลง การสร้างวิดีโอ การทำความเข้าใจรูปภาพ เสียงพูด (T2A v2) และการค้นหาเว็บ
| รหัสผู้ให้บริการ | การยืนยันตัวตน | ความสามารถ |
|---|---|---|
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
นานาชาติ
เรียกใช้การเริ่มต้นตั้งค่า
openclaw onboard --auth-choice minimax-global-oauthURL ฐานของผู้ให้บริการที่ได้: api.minimax.io
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider minimax-portalจีน
เรียกใช้การเริ่มต้นตั้งค่า
openclaw onboard --auth-choice minimax-cn-oauthURL ฐานของผู้ให้บริการที่ได้: api.minimaxi.com
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider minimax-portalคีย์ API
เหมาะที่สุดสำหรับ: MiniMax แบบโฮสต์ที่ใช้ API ซึ่งเข้ากันได้กับ Anthropic
นานาชาติ
เรียกใช้การเริ่มต้นตั้งค่า
openclaw onboard --auth-choice minimax-global-apiการดำเนินการนี้กำหนดค่า api.minimax.io เป็น URL ฐาน
ตรวจสอบว่าโมเดลพร้อมใช้งาน
openclaw models list --provider minimaxจีน
เรียกใช้การเริ่มต้นตั้งค่า
openclaw onboard --auth-choice minimax-cn-apiการดำเนินการนี้กำหนดค่า api.minimaxi.com เป็น URL ฐาน
ตรวจสอบว่าโมเดลพร้อมใช้งาน
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, }, ], }, }, },}กำหนดค่าผ่าน openclaw configure
เปิดตัวช่วยตั้งค่า
openclaw configureเลือกโมเดล/การยืนยันตัวตน
เลือก 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
{ agents: { defaults: { imageGenerationModel: { primary: "minimax/image-01" }, }, },}การสร้างภาพใช้ปลายทางเฉพาะสำหรับภาพของ MiniMax (/v1/image_generation) เสมอ และไม่สนใจ models.providers.minimax.baseUrl เนื่องจากฟิลด์ดังกล่าวใช้กำหนดค่า URL ฐานที่เข้ากันได้กับแชต/Anthropic แทน ตั้งค่า MINIMAX_API_HOST=https://api.minimaxi.com เพื่อกำหนดเส้นทางการสร้างภาพผ่านปลายทางจีน โดยปลายทางสากลเริ่มต้นคือ https://api.minimax.io
การแปลงข้อความเป็นเสียงพูด
Plugin minimax ที่รวมมาให้ลงทะเบียน MiniMax T2A v2 เป็นผู้ให้บริการเสียงพูดสำหรับ messages.tts
- โมเดล TTS เริ่มต้น:
speech-2.8-hd - เสียงเริ่มต้น:
English_expressive_narrator - รหัสโมเดลที่รวมมาให้:
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 - ลำดับการพิจารณาการยืนยันตัวตน:
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 |
รหัสโมเดล TTS |
messages.tts.providers.minimax.voiceId |
MINIMAX_TTS_VOICE_ID |
English_expressive_narrator |
รหัสเสียงที่ใช้สำหรับผลลัพธ์เสียงพูด |
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"
{ 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
{ agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" }, }, },}การทำความเข้าใจรูปภาพ
Plugin MiniMax ลงทะเบียนความสามารถในการทำความเข้าใจรูปภาพแยกจากแค็ตตาล็อกข้อความ:
| รหัสผู้ให้บริการ | โมเดลรูปภาพเริ่มต้น | การแยกข้อความจาก 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) ด้วย
- รหัสผู้ให้บริการ:
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 - การค้นหายังคงใช้รหัสผู้ให้บริการ
minimaxการตั้งค่า OAuth สำหรับจีน/ทั่วโลกสามารถกำหนดภูมิภาคทางอ้อมผ่าน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 |
กำหนดนามแฝงให้โมเดลที่ต้องการเพิ่มลงในรายการอนุญาต |
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 เป็นโมเดลหลักที่ระบุอย่างชัดเจน คุณสามารถเปลี่ยนเป็นโมเดลหลักรุ่นล่าสุดที่ต้องการได้
{ 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 ฐานหายไปหรือมีรูปแบบไม่ถูกต้อง ระบบจะยังคงใช้ระบบสำรองสำหรับจีนเพื่อรักษาความเข้ากันได้ - OpenClaw ปรับข้อมูลการใช้งาน Coding Plan ของ MiniMax ให้อยู่ในรูปแบบการแสดง
% คงเหลือแบบเดียวกับผู้ให้บริการรายอื่น ฟิลด์ดิบusage_percent/usagePercentของ MiniMax หมายถึงโควตาที่เหลือ ไม่ใช่โควตาที่ใช้ไป ดังนั้น OpenClaw จึงกลับค่าดังกล่าว ฟิลด์แบบนับจำนวนจะมีลำดับความสำคัญสูงกว่าเมื่อมีอยู่ - เมื่อ API ส่งคืน
model_remainsOpenClaw จะเลือกข้อมูลของโมเดลแชตก่อน สร้างป้ายกำกับช่วงเวลาจาก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เพื่อยืนยันรหัสผู้ให้บริการปัจจุบัน จากนั้นสลับด้วย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 เพื่อให้ระบบสามารถแทรกผู้ให้บริการที่ตรงกันได้
ตรวจสอบให้แน่ใจว่ารหัสโมเดล คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่:
- เส้นทางคีย์ 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
จากนั้นตรวจสอบอีกครั้งด้วย:
openclaw models listเนื้อหาที่เกี่ยวข้อง
การเลือกผู้ให้บริการ การอ้างอิงโมเดล และลักษณะการทำงานเมื่อสลับไปใช้ระบบสำรอง
พารามิเตอร์เครื่องมือรูปภาพที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
พารามิเตอร์เครื่องมือเพลงที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
พารามิเตอร์เครื่องมือวิดีโอที่ใช้ร่วมกันและการเลือกผู้ให้บริการ
การกำหนดค่าการค้นหาเว็บผ่าน MiniMax Token Plan
การแก้ไขปัญหาทั่วไปและคำถามที่พบบ่อย