Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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_search bawaan melalui API pencarian MiniMax Token Plan
Pemisahan penyedia:
ID PenyediaAutentikasiKapabilitas
minimaxKunci APITeks, pembuatan gambar, pembuatan musik, pembuatan video, pemahaman gambar, ucapan, pencarian web
minimax-portalOAuthTeks, pembuatan gambar, pembuatan musik, pembuatan video, pemahaman gambar, ucapan

​
Katalog bawaan

ModelJenisDeskripsi
MiniMax-M2.7Chat (penalaran)Model penalaran hosted default
MiniMax-M2.7-highspeedChat (penalaran)Tingkat penalaran M2.7 yang lebih cepat
MiniMax-VL-01VisiModel pemahaman gambar
image-01Pembuatan gambarPengeditan teks-ke-gambar dan gambar-ke-gambar
music-2.6Pembuatan musikModel musik default
music-2.5Pembuatan musikTingkat pembuatan musik sebelumnya
music-2.0Pembuatan musikTingkat pembuatan musik lama
MiniMax-Hailuo-2.3Pembuatan videoAlur teks-ke-video dan referensi gambar

​
Memulai

Pilih metode autentikasi yang Anda inginkan dan ikuti langkah-langkah penyiapan.
Paling cocok untuk: penyiapan cepat dengan MiniMax Coding Plan melalui OAuth, tanpa memerlukan kunci API.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Ini mengautentikasi terhadap api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
Penyiapan OAuth menggunakan id penyedia minimax-portal. Referensi model mengikuti bentuk minimax-portal/MiniMax-M2.7.
Tautan referral untuk MiniMax Coding Plan (diskon 10%): MiniMax Coding Plan

​
Konfigurasikan melalui openclaw configure

Gunakan wizard konfigurasi interaktif untuk mengatur MiniMax tanpa mengedit JSON:
1

Luncurkan wizard

openclaw configure
2

Pilih Model/auth

Pilih Model/auth dari menu.
3

Pilih opsi auth MiniMax

Pilih salah satu opsi MiniMax yang tersedia:
Pilihan authDeskripsi
minimax-global-oauthOAuth internasional (Paket Coding)
minimax-cn-oauthOAuth Tiongkok (Paket Coding)
minimax-global-apiKunci API internasional
minimax-cn-apiKunci API Tiongkok
4

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.
Lihat Pembuatan Gambar untuk parameter alat bersama, pemilihan penyedia, dan perilaku failover.

​
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, dan speech-01-turbo.
  • Resolusi auth adalah messages.tts.providers.minimax.apiKey, lalu profil auth OAuth/token minimax-portal, lalu kunci lingkungan Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), lalu MINIMAX_API_KEY.
  • Jika tidak ada host TTS yang dikonfigurasi, OpenClaw menggunakan kembali host OAuth minimax-portal yang 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 menerima file_type: "opus" untuk pesan audio native.
  • MiniMax T2A menerima speed dan vol pecahan, tetapi pitch dikirim sebagai bilangan bulat; OpenClaw memotong nilai pitch pecahan sebelum permintaan API.
PengaturanVariabel envDefaultDeskripsi
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHost API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdID model TTS.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorID suara yang digunakan untuk keluaran ucapan.
messages.tts.providers.minimax.speed1.0Kecepatan pemutaran, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volume, (0, 10].
messages.tts.providers.minimax.pitch0Pergeseran 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.5 dan minimax/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",
      },
    },
  },
}
Lihat Pembuatan Musik untuk parameter alat bersama, pemilihan penyedia, dan perilaku failover.

​
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 aspectRatio dan resolution
Untuk menggunakan MiniMax sebagai penyedia video default: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Lihat Pembuatan Video untuk parameter alat bersama, pemilihan penyedia, dan perilaku peralihan cadangan.

​
Pemahaman gambar

Plugin MiniMax mendaftarkan pemahaman gambar secara terpisah dari katalog teks:
ID penyediaModel gambar bawaan
minimaxMiniMax-VL-01
minimax-portalMiniMax-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_KEY saat sudah mengarah ke kredensial Token Plan
  • Penggunaan ulang wilayah: plugins.entries.minimax.config.webSearch.region, lalu MINIMAX_API_HOST, lalu URL dasar penyedia MiniMax
  • Pencarian tetap berada pada ID penyedia minimax; penyiapan OAuth CN/global dapat mengarahkan wilayah secara tidak langsung melalui models.providers.minimax-portal.baseUrl dan dapat menyediakan autentikasi Bearer melalui MINIMAX_OAUTH_TOKEN
Konfigurasi berada di bawah plugins.entries.minimax.config.webSearch.*.
Lihat Pencarian MiniMax untuk konfigurasi dan penggunaan pencarian web lengkap.

​
Konfigurasi lanjutan

OpsiDeskripsi
models.providers.minimax.baseUrlUtamakan https://api.minimax.io/anthropic (kompatibel dengan Anthropic); https://api.minimax.io/v1 opsional untuk muatan yang kompatibel dengan OpenAI
models.providers.minimax.apiUtamakan anthropic-messages; openai-completions opsional untuk muatan yang kompatibel dengan OpenAI
models.providers.minimax.apiKeyKunci API MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsTentukan id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsBeri alias pada model yang ingin Anda masukkan ke daftar izin
models.modePertahankan merge jika Anda ingin menambahkan MiniMax bersama bawaan
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.
/fast on atau params.fastMode: true menulis ulang MiniMax-M2.7 menjadi MiniMax-M2.7-highspeed pada jalur streaming yang kompatibel dengan Anthropic.
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"],
      },
    },
  },
}
  • API penggunaan Coding Plan: https://api.minimaxi.com/v1/token_plan/remains atau https://api.minimax.io/v1/token_plan/remains (memerlukan kunci Coding Plan).
  • Polling penggunaan mengambil host dari models.providers.minimax-portal.baseUrl atau models.providers.minimax.baseUrl saat dikonfigurasi, sehingga penyiapan global yang menggunakan https://api.minimax.io/anthropic melakukan polling ke api.minimax.io. URL dasar yang hilang atau salah format tetap menggunakan cadangan CN demi kompatibilitas.
  • OpenClaw menormalkan penggunaan Coding Plan MiniMax ke tampilan % left yang sama dengan yang digunakan penyedia lain. Bidang mentah MiniMax usage_percent / usagePercent adalah 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 dari start_time / end_time bila diperlukan, dan menyertakan nama model yang dipilih dalam label paket agar jendela Coding Plan lebih mudah dibedakan.
  • Snapshot penggunaan memperlakukan minimax, minimax-cn, dan minimax-portal sebagai 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>
  • 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-01 milik Plugin
  • Perbarui nilai harga di models.json jika Anda memerlukan pelacakan biaya yang tepat
  • Gunakan openclaw models list untuk mengonfirmasi ID penyedia saat ini, lalu beralih dengan openclaw models set minimax/MiniMax-M2.7 atau openclaw models set minimax-portal/MiniMax-M2.7
Tautan rujukan untuk MiniMax Coding Plan (diskon 10%): MiniMax Coding Plan
Lihat Penyedia model untuk aturan penyedia.

​
Pemecahan masalah

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 configure dan memilih opsi autentikasi MiniMax, atau
  • Menambahkan blok models.providers.minimax atau models.providers.minimax-portal yang 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.7 atau minimax/MiniMax-M2.7-highspeed
  • Jalur OAuth: minimax-portal/MiniMax-M2.7 atau minimax-portal/MiniMax-M2.7-highspeed
Lalu periksa ulang dengan:
openclaw models list
Bantuan lebih lanjut: Pemecahan masalah dan FAQ.

​
Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku peralihan cadangan.

Pembuatan gambar

Parameter alat gambar bersama dan pemilihan penyedia.

Pembuatan musik

Parameter alat musik bersama dan pemilihan penyedia.

Pembuatan video

Parameter alat video bersama dan pemilihan penyedia.

Pencarian MiniMax

Konfigurasi pencarian web melalui MiniMax Token Plan.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.