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 bawaan mendaftarkan dua penyedia serta lima kapabilitas: percakapan, pembuatan gambar, pembuatan musik, pembuatan video, pemahaman gambar, ucapan (T2A v2), dan pencarian web.

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-M3 Percakapan (penalaran) Model penalaran terhosting default
MiniMax-M2.7 Percakapan (penalaran) Model penalaran terhosting sebelumnya
MiniMax-M2.7-highspeed Percakapan (penalaran) Tingkat penalaran M2.7 yang lebih cepat
MiniMax-VL-01 Visi Model pemahaman gambar
image-01 Pembuatan gambar Penyuntingan teks-ke-gambar dan gambar-ke-gambar
music-2.6 Pembuatan musik Model musik default
MiniMax-Hailuo-2.3 Pembuatan video Alur teks-ke-video dan gambar-ke-video

Referensi model mengikuti jalur autentikasi: minimax/<model> untuk penyiapan dengan kunci API, minimax-portal/<model> untuk penyiapan OAuth.

Memulai

OAuth (Coding Plan)

Paling cocok untuk: penyiapan cepat dengan MiniMax Coding Plan melalui OAuth, tanpa memerlukan kunci API.

Internasional

  • Jalankan orientasi awal

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

    URL dasar penyedia yang dihasilkan: api.minimax.io.

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider minimax-portal

    • Tiongkok

  • Jalankan orientasi awal

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

    URL dasar penyedia yang dihasilkan: api.minimaxi.com.

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider minimax-portal

    • Kunci API

    Paling cocok untuk: MiniMax terhosting dengan API yang kompatibel dengan Anthropic.

    Internasional

  • Jalankan orientasi awal

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

    Ini mengonfigurasi api.minimax.io sebagai URL dasar.

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider minimax

    • Tiongkok

  • Jalankan orientasi awal

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

    Ini mengonfigurasi api.minimaxi.com sebagai URL dasar.

  • Verifikasi bahwa model tersedia

    bash
    openclaw models list --provider minimax

    • Contoh konfigurasi

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

    Konfigurasikan melalui openclaw configure

  • Jalankan wizard

    bash
    openclaw configure

  • Pilih Model/auth

    Pilih Model/auth dari menu.

  • Pilih opsi autentikasi MiniMax

    Pilihan autentikasi 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 pada minimax dan minimax-portal, dengan menggunakan kembali MINIMAX_API_KEY atau autentikasi OAuth yang sama seperti model teks.

    • Pembuatan teks-ke-gambar dan pengeditan gambar-ke-gambar (referensi subjek), keduanya dengan kontrol rasio aspek
    • Hingga 9 gambar keluaran per permintaan, 1 gambar referensi per permintaan pengeditan
    • Rasio aspek yang didukung: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

    Pembuatan gambar selalu menggunakan endpoint gambar khusus MiniMax (/v1/image_generation) dan mengabaikan models.providers.minimax.baseUrl, karena kolom tersebut mengonfigurasi URL dasar yang kompatibel dengan chat/Anthropic. Atur MINIMAX_API_HOST=https://api.minimaxi.com untuk merutekan pembuatan gambar melalui endpoint CN; endpoint global default adalah https://api.minimax.io.

    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: 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
    • Urutan resolusi autentikasi: messages.tts.providers.minimax.apiKey, lalu profil autentikasi OAuth/token minimax-portal, lalu kunci lingkungan Paket Token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), kemudian MINIMAX_API_KEY
    • Jika tidak ada host TTS yang dikonfigurasi, OpenClaw menggunakan kembali host OAuth minimax-portal yang dikonfigurasi dan menghapus akhiran jalur yang kompatibel dengan Anthropic seperti /anthropic
    • Lampiran audio biasa tetap dalam format MP3. Target catatan suara (Feishu, Telegram, dan kanal lain yang meminta lampiran yang kompatibel dengan catatan suara) ditranskode dari MP3 MiniMax menjadi Opus 48 kHz dengan ffmpeg, karena misalnya API berkas Feishu/Lark hanya menerima file_type: "opus" untuk pesan audio native
    • MiniMax T2A menerima nilai pecahan untuk speed dan vol, tetapi pitch dikirim sebagai bilangan bulat; OpenClaw memotong bagian pecahan nilai pitch sebelum permintaan API
    Pengaturan Variabel lingkungan 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 nada berupa 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 (OAuth: minimax-portal/music-2.6)
    • Juga mendukung music-2.6-free, music-cover, dan music-cover-free
    • Kontrol perintah: lyrics, instrumental
    • Format keluaran: mp3
    • Eksekusi berbasis sesi dilepaskan melalui alur tugas/status bersama, termasuk action: "status"
    json5
    {  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 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
    • Juga mendukung MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, dan I2V-01
    • Mode: teks-ke-video dan alur referensi satu gambar
    • Mendukung resolution (768P atau 1080P pada model Hailuo 2.3/02); aspectRatio tidak didukung dan diabaikan
    json5
    {  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 Ekstraksi teks PDF
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

    Itulah sebabnya perutean media otomatis dapat menggunakan pemahaman gambar MiniMax meskipun katalog penyedia teks bawaan juga menyertakan referensi percakapan M3 berkemampuan gambar. Pemahaman PDF menggunakan MiniMax-M2.7 hanya untuk ekstraksi teks; MiniMax tidak mendaftarkan jalur konversi PDF ke gambar.

    Pencarian web

    Plugin MiniMax juga mendaftarkan web_search melalui API pencarian MiniMax Token Plan (/v1/coding_plan/search).

    • ID penyedia: minimax
    • Hasil terstruktur: judul, URL, cuplikan, kueri terkait
    • Variabel lingkungan yang diutamakan: MINIMAX_CODE_PLAN_KEY
    • Alias variabel lingkungan yang diterima: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
    • Fallback kompatibilitas: MINIMAX_API_KEY jika sudah mengarah ke kredensial paket token
    • Penggunaan ulang wilayah: plugins.entries.minimax.config.webSearch.region, lalu MINIMAX_API_HOST, kemudian URL dasar penyedia MiniMax
    • Pencarian tetap menggunakan 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.*.

    Konfigurasi lanjutan

    Opsi konfigurasi
    Opsi Deskripsi
    models.providers.minimax.baseUrl Utamakan https://api.minimax.io/anthropic (kompatibel dengan Anthropic); https://api.minimax.io/v1 bersifat opsional untuk payload yang kompatibel dengan OpenAI
    models.providers.minimax.api Utamakan anthropic-messages; openai-completions bersifat opsional untuk payload 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 Berikan alias pada model yang ingin Anda masukkan ke daftar yang diizinkan
    models.mode Pertahankan merge jika Anda ingin menambahkan MiniMax bersama model bawaan
    Pengaturan bawaan penalaran

    Pada api: "anthropic-messages", OpenClaw menyisipkan thinking: { type: "disabled" } untuk model MiniMax M2.x kecuali pembungkus sebelumnya telah menetapkan bidang thinking dalam payload. Hal ini mencegah endpoint streaming M2.x menghasilkan reasoning_content dalam potongan delta bergaya OpenAI, yang dapat membocorkan penalaran internal ke keluaran yang terlihat.

    MiniMax-M3 (dan M3.x) dikecualikan: M3 mengembalikan larik content kosong dengan stop_reason: "end_turn" ketika penalaran dinonaktifkan, sehingga OpenClaw menghapus pengaturan bawaan nonaktif implisit untuk M3 dan, ketika tingkat penalaran ditetapkan, memaksakan thinking: { type: "adaptive" } sebagai gantinya.

    Tingkat penalaran yang tersedia untuk setiap keluarga model:

    Keluarga model Tingkat Bawaan
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    Mode cepat

    /fast on atau params.fastMode: true mengubah MiniMax-M2.7 menjadi MiniMax-M2.7-highspeed pada jalur aliran yang kompatibel dengan Anthropic (api: "anthropic-messages", penyedia minimax atau minimax-portal).

    Contoh fallback

    Paling sesuai untuk: mempertahankan model generasi terbaru dan terkuat Anda sebagai model utama, lalu beralih ke MiniMax M2.7 jika gagal. Contoh di bawah menggunakan Opus sebagai model utama konkret; ganti dengan model utama generasi terbaru pilihan Anda.

    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"],      },    },  },}
    Detail penggunaan Coding Plan
    • API penggunaan Coding Plan: https://api.minimaxi.com/v1/token_plan/remains atau https://api.minimax.io/v1/token_plan/remains (memerlukan kunci paket pengodean).
    • Polling penggunaan mengambil host dari models.providers.minimax-portal.baseUrl atau models.providers.minimax.baseUrl ketika dikonfigurasi, sehingga penyiapan global yang menggunakan https://api.minimax.io/anthropic melakukan polling ke api.minimax.io. URL dasar yang tidak ada atau salah format mempertahankan fallback CN demi kompatibilitas.
    • OpenClaw menormalisasi penggunaan paket pengodean MiniMax ke tampilan % tersisa yang sama seperti penyedia lain. Bidang mentah usage_percent / usagePercent milik MiniMax menunjukkan kuota tersisa, bukan kuota terpakai, sehingga OpenClaw membalikkannya. Bidang berbasis jumlah diutamakan jika tersedia.
    • Ketika API mengembalikan model_remains, OpenClaw mengutamakan entri model percakapan, memperoleh label jendela dari start_time / end_time jika diperlukan, dan menyertakan nama model terpilih dalam label paket agar jendela paket pengodean lebih mudah dibedakan.
    • Snapshot penggunaan memperlakukan minimax, minimax-cn, minimax-portal, dan minimax-portal-cn sebagai permukaan kuota MiniMax yang sama, serta mengutamakan OAuth MiniMax tersimpan sebelum beralih ke variabel lingkungan kunci Coding Plan.

    Catatan

    • Model percakapan bawaan: MiniMax-M3. Model percakapan alternatif: MiniMax-M2.7, MiniMax-M2.7-highspeed
    • Orientasi awal dan penyiapan kunci API langsung menulis definisi model untuk M3 dan kedua varian M2.7
    • Pemahaman gambar menggunakan penyedia media MiniMax-VL-01 yang dimiliki Plugin
    • Perbarui nilai harga dalam 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-M3 atau openclaw models set minimax-portal/MiniMax-M3

    Pemecahan masalah

    "Model tidak dikenal: minimax/MiniMax-M3"

    Ini biasanya berarti penyedia MiniMax belum dikonfigurasi (tidak ada entri penyedia yang cocok serta tidak ditemukan profil autentikasi MiniMax atau kunci variabel lingkungan). Perbaiki dengan:

    • Menjalankan openclaw configure dan memilih opsi autentikasi MiniMax, atau
    • Menambahkan blok models.providers.minimax atau models.providers.minimax-portal yang cocok secara manual, atau
    • Menetapkan MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN, atau profil autentikasi MiniMax agar penyedia yang cocok dapat disisipkan.

    Pastikan ID model peka terhadap huruf besar-kecil:

    • Jalur kunci API: minimax/MiniMax-M3, minimax/MiniMax-M2.7, atau minimax/MiniMax-M2.7-highspeed
    • Jalur OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7, atau minimax-portal/MiniMax-M2.7-highspeed

    Kemudian periksa kembali dengan:

    bash
    openclaw models list

    Terkait

    Pemilihan model

    Memilih penyedia, referensi model, dan perilaku failover.
    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 tanya jawab umum.
    Was this useful?
    On this page

    On this page