Providers
MiniMax
Default penyedia MiniMax OpenClaw adalah MiniMax M2.7.
MiniMax juga menyediakan:
- Sintesis ucapan bawaan melalui T2A v2
- Pemahaman gambar bawaan melalui
MiniMax-VL-01 - Pembuatan musik bawaan melalui
music-2.6 web_searchbawaan melalui API pencarian MiniMax Token Plan
Pemisahan penyedia:
| ID Penyedia | Autentikasi | Kapabilitas |
|---|---|---|
minimax |
Kunci API | Teks, pembuatan gambar, pembuatan musik, pembuatan video, pemahaman gambar, ucapan, pencarian web |
minimax-portal |
OAuth | Teks, pembuatan gambar, pembuatan musik, pembuatan video, pemahaman gambar, ucapan |
Katalog bawaan
| Model | Jenis | Deskripsi |
|---|---|---|
MiniMax-M2.7 |
Chat (penalaran) | Model penalaran hosted default |
MiniMax-M2.7-highspeed |
Chat (penalaran) | Tingkat penalaran M2.7 yang lebih cepat |
MiniMax-VL-01 |
Visi | Model pemahaman gambar |
image-01 |
Pembuatan gambar | Pengeditan teks-ke-gambar dan gambar-ke-gambar |
music-2.6 |
Pembuatan musik | Model musik default |
music-2.5 |
Pembuatan musik | Tingkat pembuatan musik sebelumnya |
music-2.0 |
Pembuatan musik | Tingkat pembuatan musik lama |
MiniMax-Hailuo-2.3 |
Pembuatan video | Alur teks-ke-video dan referensi gambar |
Memulai
Pilih metode autentikasi yang Anda inginkan dan ikuti langkah-langkah penyiapan.
OAuth (Coding Plan)
Paling cocok untuk: penyiapan cepat dengan MiniMax Coding Plan melalui OAuth, tanpa memerlukan kunci API.
International
Run onboarding
openclaw onboard --auth-choice minimax-global-oauth
Ini mengautentikasi terhadap api.minimax.io.
Verify the model is available
openclaw models list --provider minimax-portal
China
Run onboarding
openclaw onboard --auth-choice minimax-cn-oauth
Ini mengautentikasi terhadap api.minimaxi.com.
Verify the model is available
openclaw models list --provider minimax-portal
API key
Paling cocok untuk: MiniMax hosted dengan API yang kompatibel dengan Anthropic.
International
Run onboarding
openclaw onboard --auth-choice minimax-global-api
Ini mengonfigurasi api.minimax.io sebagai URL dasar.
Verify the model is available
openclaw models list --provider minimax
China
Run onboarding
openclaw onboard --auth-choice minimax-cn-api
Ini mengonfigurasi api.minimaxi.com sebagai URL dasar.
Verify the model is available
openclaw models list --provider minimax
Contoh konfigurasi
{
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,
},
],
},
},
},
}
Konfigurasikan melalui openclaw configure
Gunakan wizard konfigurasi interaktif untuk mengatur MiniMax tanpa mengedit JSON:
Luncurkan wizard
openclaw configure
Pilih Model/auth
Pilih Model/auth dari menu.
Pilih opsi auth MiniMax
Pilih salah satu opsi MiniMax yang tersedia:
| Pilihan auth | Deskripsi |
|---|---|
minimax-global-oauth |
OAuth internasional (Paket Coding) |
minimax-cn-oauth |
OAuth Tiongkok (Paket Coding) |
minimax-global-api |
Kunci API internasional |
minimax-cn-api |
Kunci API Tiongkok |
Pilih model default Anda
Pilih model default Anda saat diminta.
Kemampuan
Pembuatan gambar
Plugin MiniMax mendaftarkan model image-01 untuk alat image_generate. Model ini mendukung:
- Pembuatan teks-ke-gambar dengan kontrol rasio aspek
- Pengeditan gambar-ke-gambar (referensi subjek) dengan kontrol rasio aspek
- Hingga 9 gambar keluaran per permintaan
- Hingga 1 gambar referensi per permintaan edit
- Rasio aspek yang didukung:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
Untuk menggunakan MiniMax untuk pembuatan gambar, tetapkan sebagai penyedia pembuatan gambar:
{
agents: {
defaults: {
imageGenerationModel: { primary: "minimax/image-01" },
},
},
}
Plugin menggunakan MINIMAX_API_KEY atau auth OAuth yang sama seperti model teks. Tidak diperlukan konfigurasi tambahan jika MiniMax sudah disiapkan.
Baik minimax maupun minimax-portal mendaftarkan image_generate dengan model
image-01 yang sama. Penyiapan kunci API menggunakan MINIMAX_API_KEY; penyiapan OAuth dapat menggunakan
jalur auth minimax-portal bawaan sebagai gantinya.
Pembuatan gambar selalu menggunakan endpoint gambar khusus MiniMax
(/v1/image_generation) dan mengabaikan models.providers.minimax.baseUrl,
karena kolom tersebut mengonfigurasi URL dasar chat/kompatibel Anthropic. Tetapkan
MINIMAX_API_HOST=https://api.minimaxi.com untuk merutekan pembuatan gambar
melalui endpoint CN; endpoint global default adalah
https://api.minimax.io.
Saat onboarding atau penyiapan kunci API menulis entri models.providers.minimax
eksplisit, OpenClaw mewujudkan MiniMax-M2.7 dan
MiniMax-M2.7-highspeed sebagai model chat khusus teks. Pemahaman gambar
diekspos secara terpisah melalui penyedia media MiniMax-VL-01 milik Plugin.
Teks-ke-ucapan
Plugin minimax bawaan mendaftarkan MiniMax T2A v2 sebagai penyedia ucapan untuk
messages.tts.
- Model TTS default:
speech-2.8-hd - Suara default:
English_expressive_narrator - ID model bawaan yang didukung mencakup
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, danspeech-01-turbo. - Resolusi auth adalah
messages.tts.providers.minimax.apiKey, lalu profil auth OAuth/tokenminimax-portal, lalu kunci lingkungan Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), laluMINIMAX_API_KEY. - Jika tidak ada host TTS yang dikonfigurasi, OpenClaw menggunakan kembali host OAuth
minimax-portalyang dikonfigurasi dan menghapus sufiks jalur kompatibel Anthropic seperti/anthropic. - Lampiran audio normal tetap MP3.
- Target catatan suara seperti Feishu dan Telegram ditranskode dari MP3 MiniMax
ke Opus 48kHz dengan
ffmpeg, karena API file Feishu/Lark hanya menerimafile_type: "opus"untuk pesan audio native. - MiniMax T2A menerima
speeddanvolpecahan, tetapipitchdikirim sebagai bilangan bulat; OpenClaw memotong nilaipitchpecahan sebelum permintaan API.
| Pengaturan | Variabel env | Default | Deskripsi |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl |
MINIMAX_API_HOST |
https://api.minimax.io |
Host API MiniMax T2A. |
messages.tts.providers.minimax.model |
MINIMAX_TTS_MODEL |
speech-2.8-hd |
ID model TTS. |
messages.tts.providers.minimax.voiceId |
MINIMAX_TTS_VOICE_ID |
English_expressive_narrator |
ID suara yang digunakan untuk keluaran ucapan. |
messages.tts.providers.minimax.speed |
1.0 |
Kecepatan pemutaran, 0.5..2.0. |
|
messages.tts.providers.minimax.vol |
1.0 |
Volume, (0, 10]. |
|
messages.tts.providers.minimax.pitch |
0 |
Pergeseran pitch bilangan bulat, -12..12. |
Pembuatan musik
Plugin MiniMax bawaan mendaftarkan pembuatan musik melalui alat bersama
music_generate untuk minimax dan minimax-portal.
- Model musik default:
minimax/music-2.6 - Model musik OAuth:
minimax-portal/music-2.6 - Juga mendukung
minimax/music-2.5danminimax/music-2.0 - Kontrol prompt:
lyrics,instrumental,durationSeconds - Format keluaran:
mp3 - Eksekusi berbasis sesi dilepas melalui alur tugas/status bersama, termasuk
action: "status"
Untuk menggunakan MiniMax sebagai penyedia musik default:
{
agents: {
defaults: {
musicGenerationModel: {
primary: "minimax/music-2.6",
},
},
},
}
Pembuatan video
Plugin MiniMax bawaan mendaftarkan pembuatan video melalui alat bersama
video_generate untuk minimax dan minimax-portal.
- Model video default:
minimax/MiniMax-Hailuo-2.3 - Model video OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - Mode: alur teks-ke-video dan referensi satu gambar
- Mendukung
aspectRatiodanresolution
Untuk menggunakan MiniMax sebagai penyedia video default:
{
agents: {
defaults: {
videoGenerationModel: {
primary: "minimax/MiniMax-Hailuo-2.3",
},
},
},
}
Pemahaman gambar
Plugin MiniMax mendaftarkan pemahaman gambar secara terpisah dari katalog teks:
| ID penyedia | Model gambar bawaan |
|---|---|
minimax |
MiniMax-VL-01 |
minimax-portal |
MiniMax-VL-01 |
Itulah mengapa perutean media otomatis dapat menggunakan pemahaman gambar MiniMax bahkan saat katalog penyedia teks bawaan masih menampilkan referensi obrolan M2.7 khusus teks.
Pencarian web
Plugin MiniMax juga mendaftarkan web_search melalui API pencarian MiniMax Token Plan.
- ID penyedia:
minimax - Hasil terstruktur: judul, URL, cuplikan, kueri terkait
- Variabel lingkungan yang disarankan:
MINIMAX_CODE_PLAN_KEY - Alias lingkungan yang diterima:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Cadangan kompatibilitas:
MINIMAX_API_KEYsaat sudah mengarah ke kredensial Token Plan - Penggunaan ulang wilayah:
plugins.entries.minimax.config.webSearch.region, laluMINIMAX_API_HOST, lalu URL dasar penyedia MiniMax - Pencarian tetap berada pada ID penyedia
minimax; penyiapan OAuth CN/global dapat mengarahkan wilayah secara tidak langsung melaluimodels.providers.minimax-portal.baseUrldan dapat menyediakan autentikasi Bearer melaluiMINIMAX_OAUTH_TOKEN
Konfigurasi berada di bawah plugins.entries.minimax.config.webSearch.*.
Konfigurasi lanjutan
Opsi konfigurasi
| Opsi | Deskripsi |
|---|---|
models.providers.minimax.baseUrl |
Utamakan https://api.minimax.io/anthropic (kompatibel dengan Anthropic); https://api.minimax.io/v1 opsional untuk muatan yang kompatibel dengan OpenAI |
models.providers.minimax.api |
Utamakan anthropic-messages; openai-completions opsional untuk muatan yang kompatibel dengan OpenAI |
models.providers.minimax.apiKey |
Kunci API MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models |
Tentukan id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models |
Beri alias pada model yang ingin Anda masukkan ke daftar izin |
models.mode |
Pertahankan merge jika Anda ingin menambahkan MiniMax bersama bawaan |
Nilai bawaan pemikiran
Pada api: "anthropic-messages", OpenClaw menyuntikkan thinking: { type: "disabled" } kecuali thinking sudah ditetapkan secara eksplisit di parameter/konfigurasi.
Ini mencegah titik akhir streaming MiniMax menghasilkan reasoning_content dalam potongan delta bergaya OpenAI, yang akan membocorkan penalaran internal ke keluaran yang terlihat.
Mode cepat
/fast on atau params.fastMode: true menulis ulang MiniMax-M2.7 menjadi MiniMax-M2.7-highspeed pada jalur streaming yang kompatibel dengan Anthropic.
Contoh cadangan
Paling cocok untuk: mempertahankan model generasi terbaru terkuat Anda sebagai utama, dengan MiniMax M2.7 sebagai cadangan. Contoh di bawah menggunakan Opus sebagai model utama konkret; ganti dengan model utama generasi terbaru pilihan Anda.
{
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"],
},
},
},
}
Detail penggunaan Coding Plan
- API penggunaan Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainsatauhttps://api.minimax.io/v1/token_plan/remains(memerlukan kunci Coding Plan). - Polling penggunaan mengambil host dari
models.providers.minimax-portal.baseUrlataumodels.providers.minimax.baseUrlsaat dikonfigurasi, sehingga penyiapan global yang menggunakanhttps://api.minimax.io/anthropicmelakukan polling keapi.minimax.io. URL dasar yang hilang atau salah format tetap menggunakan cadangan CN demi kompatibilitas. - OpenClaw menormalkan penggunaan Coding Plan MiniMax ke tampilan
% leftyang sama dengan yang digunakan penyedia lain. Bidang mentah MiniMaxusage_percent/usagePercentadalah kuota tersisa, bukan kuota terpakai, sehingga OpenClaw membalikkannya. Bidang berbasis hitungan diutamakan saat ada. - Saat API mengembalikan
model_remains, OpenClaw memprioritaskan entri model obrolan, memperoleh label jendela daristart_time/end_timebila diperlukan, dan menyertakan nama model yang dipilih dalam label paket agar jendela Coding Plan lebih mudah dibedakan. - Snapshot penggunaan memperlakukan
minimax,minimax-cn, danminimax-portalsebagai cakupan kuota MiniMax yang sama, dan memprioritaskan OAuth MiniMax yang tersimpan sebelum menggunakan variabel lingkungan kunci Coding Plan sebagai cadangan.
Catatan
- Referensi model mengikuti jalur autentikasi:
- Penyiapan kunci API:
minimax/<model> - Penyiapan OAuth:
minimax-portal/<model>
- Penyiapan kunci API:
- Model obrolan bawaan:
MiniMax-M2.7 - Model obrolan alternatif:
MiniMax-M2.7-highspeed - Proses orientasi dan penyiapan langsung dengan kunci API menulis definisi model khusus teks untuk kedua varian M2.7
- Pemahaman gambar menggunakan penyedia media
MiniMax-VL-01milik Plugin - Perbarui nilai harga di
models.jsonjika Anda memerlukan pelacakan biaya yang tepat - Gunakan
openclaw models listuntuk mengonfirmasi ID penyedia saat ini, lalu beralih denganopenclaw models set minimax/MiniMax-M2.7atauopenclaw models set minimax-portal/MiniMax-M2.7
Pemecahan masalah
"Unknown model: minimax/MiniMax-M2.7"
Ini biasanya berarti penyedia MiniMax belum dikonfigurasi (tidak ada entri penyedia yang cocok dan tidak ditemukan profil autentikasi/kunci lingkungan MiniMax). Perbaikan untuk deteksi ini ada di 2026.1.12. Perbaiki dengan:
- Memutakhirkan ke 2026.1.12 (atau menjalankan dari sumber
main), lalu memulai ulang Gateway. - Menjalankan
openclaw configuredan memilih opsi autentikasi MiniMax, atau - Menambahkan blok
models.providers.minimaxataumodels.providers.minimax-portalyang cocok secara manual, atau - Mengatur
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKEN, atau profil autentikasi MiniMax agar penyedia yang cocok dapat disuntikkan.
Pastikan ID model peka huruf besar-kecil:
- Jalur kunci API:
minimax/MiniMax-M2.7atauminimax/MiniMax-M2.7-highspeed - Jalur OAuth:
minimax-portal/MiniMax-M2.7atauminimax-portal/MiniMax-M2.7-highspeed
Lalu periksa ulang dengan:
openclaw models list
Terkait
Memilih penyedia, referensi model, dan perilaku peralihan cadangan.
Parameter alat gambar bersama dan pemilihan penyedia.
Parameter alat musik bersama dan pemilihan penyedia.
Parameter alat video bersama dan pemilihan penyedia.
Konfigurasi pencarian web melalui MiniMax Token Plan.
Pemecahan masalah umum dan FAQ.