MiniMax

Provider MiniMax di OpenClaw default-nya menggunakan MiniMax M2.7. MiniMax juga menyediakan:

Sintesis suara bawaan melalui T2A v2
Pemahaman gambar bawaan melalui MiniMax-VL-01
Pembuatan musik bawaan melalui music-2.5+
web_search bawaan melalui API pencarian MiniMax Coding Plan

Pembagian provider:

ID Provider	Auth	Kapabilitas
`minimax`	API key	Teks, pembuatan gambar, pemahaman gambar, suara, pencarian web
`minimax-portal`	OAuth	Teks, pembuatan gambar, pemahaman gambar

Jajaran model

Model	Tipe	Deskripsi
`MiniMax-M2.7`	Chat (reasoning)	Model reasoning hosted default
`MiniMax-M2.7-highspeed`	Chat (reasoning)	Tier reasoning M2.7 yang lebih cepat
`MiniMax-VL-01`	Vision	Model pemahaman gambar
`image-01`	Pembuatan gambar	Teks-ke-gambar dan pengeditan gambar-ke-gambar
`music-2.5+`	Pembuatan musik	Model musik default
`music-2.5`	Pembuatan musik	Tier pembuatan musik sebelumnya
`music-2.0`	Pembuatan musik	Tier pembuatan musik lama
`MiniMax-Hailuo-2.3`	Pembuatan video	Alur teks-ke-video dan referensi gambar

Memulai

Pilih metode auth yang Anda sukai dan ikuti langkah penyiapannya.

OAuth (Coding Plan)
API key

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

Internasional
China

Jalankan onboarding

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

Ini melakukan autentikasi terhadap api.minimax.io.

Verifikasi bahwa model tersedia

openclaw models list --provider minimax-portal

Jalankan onboarding

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

Ini melakukan autentikasi terhadap api.minimaxi.com.

Verifikasi bahwa model tersedia

openclaw models list --provider minimax-portal

Penyiapan OAuth menggunakan ID provider minimax-portal. Ref model mengikuti format minimax-portal/MiniMax-M2.7.

Tautan referral untuk MiniMax Coding Plan (diskon 10%): MiniMax Coding Plan

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

Internasional
China

Jalankan onboarding

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

Ini mengonfigurasi api.minimax.io sebagai base URL.

Verifikasi bahwa model tersedia

openclaw models list --provider minimax

Jalankan onboarding

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

Ini mengonfigurasi api.minimaxi.com sebagai base URL.

Verifikasi bahwa model tersedia

openclaw models list --provider minimax

Contoh config

{
  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", "image"],
            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", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },
            contextWindow: 204800,
            maxTokens: 131072,
          },
        ],
      },
    },
  },
}

Pada jalur streaming yang kompatibel dengan Anthropic, OpenClaw menonaktifkan thinking MiniMax secara default kecuali Anda secara eksplisit menetapkan thinking sendiri. Endpoint streaming MiniMax mengeluarkan reasoning_content dalam potongan delta bergaya OpenAI, bukan blok thinking Anthropic native, yang dapat membocorkan reasoning internal ke output yang terlihat jika dibiarkan aktif secara implisit.

Penyiapan API key menggunakan ID provider minimax. Ref model mengikuti format minimax/MiniMax-M2.7.

Konfigurasi melalui `openclaw configure`

Gunakan wizard config interaktif untuk menyiapkan 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:

Opsi auth	Deskripsi
`minimax-global-oauth`	OAuth internasional (Coding Plan)
`minimax-cn-oauth`	OAuth China (Coding Plan)
`minimax-global-api`	API key internasional
`minimax-cn-api`	API key China

Pilih model default Anda

Pilih model default Anda saat diminta.

Kapabilitas

Pembuatan gambar

Plugin MiniMax mendaftarkan model image-01 untuk tool 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 output 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, setel sebagai provider 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 API key menggunakan MINIMAX_API_KEY; penyiapan OAuth dapat menggunakan jalur auth minimax-portal bawaan sebagai gantinya. Saat onboarding atau penyiapan API key menulis entri models.providers.minimax yang eksplisit, OpenClaw mewujudkan MiniMax-M2.7 dan MiniMax-M2.7-highspeed dengan input: ["text", "image"]. Katalog teks MiniMax bawaan yang dibundel sendiri tetap berupa metadata khusus teks sampai config provider eksplisit tersebut ada. Pemahaman gambar diekspos secara terpisah melalui provider media MiniMax-VL-01 milik Plugin.

Lihat Pembuatan Gambar untuk parameter tool bersama, pemilihan provider, dan perilaku failover.

Pembuatan musik

Plugin minimax bawaan juga mendaftarkan pembuatan musik melalui tool bersama music_generate.

Model musik default: minimax/music-2.5+
Juga mendukung minimax/music-2.5 dan minimax/music-2.0
Kontrol prompt: lyrics, instrumental, durationSeconds
Format output: mp3
Proses yang didukung sesi dilepas melalui alur task/status bersama, termasuk action: "status"

Untuk menggunakan MiniMax sebagai provider musik default:

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.5+",
      },
    },
  },
}

Lihat Pembuatan Musik untuk parameter tool bersama, pemilihan provider, dan perilaku failover.

Pembuatan video

Plugin minimax bawaan juga mendaftarkan pembuatan video melalui tool bersama video_generate.

Model video default: minimax/MiniMax-Hailuo-2.3
Mode: teks-ke-video dan alur referensi gambar tunggal
Mendukung aspectRatio dan resolution

Untuk menggunakan MiniMax sebagai provider video default:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}

Lihat Pembuatan Video untuk parameter tool bersama, pemilihan provider, dan perilaku failover.

Pemahaman gambar

Plugin MiniMax mendaftarkan pemahaman gambar secara terpisah dari katalog teks:

ID Provider	Model gambar default
`minimax`	`MiniMax-VL-01`
`minimax-portal`	`MiniMax-VL-01`

Itulah sebabnya perutean media otomatis dapat menggunakan pemahaman gambar MiniMax bahkan ketika katalog provider teks bawaan yang dibundel masih menampilkan ref chat M2.7 khusus teks.

Pencarian web

Plugin MiniMax juga mendaftarkan web_search melalui API pencarian MiniMax Coding Plan.

ID provider: minimax
Hasil terstruktur: judul, URL, snippet, kueri terkait
Variabel env yang disarankan: MINIMAX_CODE_PLAN_KEY
Alias env yang diterima: MINIMAX_CODING_API_KEY
Fallback kompatibilitas: MINIMAX_API_KEY ketika sudah menunjuk ke token coding-plan
Penggunaan ulang region: plugins.entries.minimax.config.webSearch.region, lalu MINIMAX_API_HOST, lalu base URL provider MiniMax
Pencarian tetap berada pada ID provider minimax; penyiapan OAuth CN/global tetap dapat mengarahkan region secara tidak langsung melalui models.providers.minimax-portal.baseUrl

Config berada di bawah plugins.entries.minimax.config.webSearch.*.

Lihat MiniMax Search untuk konfigurasi dan penggunaan pencarian web lengkap.

Konfigurasi lanjutan

Opsi konfigurasi

Opsi	Deskripsi
`models.providers.minimax.baseUrl`	Pilih `https://api.minimax.io/anthropic` (kompatibel dengan Anthropic); `https://api.minimax.io/v1` opsional untuk payload yang kompatibel dengan OpenAI
`models.providers.minimax.api`	Pilih `anthropic-messages`; `openai-completions` opsional untuk payload yang kompatibel dengan OpenAI
`models.providers.minimax.apiKey`	API key MiniMax (`MINIMAX_API_KEY`)
`models.providers.minimax.models`	Tentukan `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost`
`agents.defaults.models`	Alias model yang Anda inginkan dalam allowlist
`models.mode`	Gunakan `merge` jika Anda ingin menambahkan MiniMax bersama bawaan

Default thinking

Pada api: "anthropic-messages", OpenClaw menyisipkan thinking: { type: "disabled" } kecuali thinking sudah disetel secara eksplisit dalam params/config.Ini mencegah endpoint streaming MiniMax mengeluarkan reasoning_content dalam potongan delta bergaya OpenAI, yang akan membocorkan reasoning internal ke output yang terlihat.

Mode cepat

/fast on atau params.fastMode: true menulis ulang MiniMax-M2.7 menjadi MiniMax-M2.7-highspeed pada jalur stream yang kompatibel dengan Anthropic.

Contoh fallback

Paling cocok untuk: mempertahankan model generasi terbaru terkuat Anda sebagai primary, lalu fail over ke MiniMax M2.7. Contoh di bawah menggunakan Opus sebagai primary konkret; ganti dengan model primary 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/api/openplatform/coding_plan/remains (memerlukan coding plan key).
OpenClaw menormalkan penggunaan coding-plan MiniMax ke tampilan % tersisa yang sama seperti yang digunakan provider lain. Field mentah usage_percent / usagePercent MiniMax adalah kuota tersisa, bukan kuota yang sudah digunakan, jadi OpenClaw membalikkannya. Field berbasis hitungan diprioritaskan jika ada.
Saat API mengembalikan model_remains, OpenClaw memprioritaskan entri model chat, menurunkan 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 permukaan kuota MiniMax yang sama, dan memprioritaskan OAuth MiniMax yang tersimpan sebelum fallback ke env vars Coding Plan key.

Catatan

Ref model mengikuti jalur auth:
- Penyiapan API key: minimax/<model>
- Penyiapan OAuth: minimax-portal/<model>
Model chat default: MiniMax-M2.7
Model chat alternatif: MiniMax-M2.7-highspeed
Onboarding dan penyiapan API key langsung menulis definisi model eksplisit dengan input: ["text", "image"] untuk kedua varian M2.7
Katalog provider bawaan saat ini mengekspos ref chat sebagai metadata khusus teks sampai config provider MiniMax eksplisit ada
Perbarui nilai harga di models.json jika Anda memerlukan pelacakan biaya yang akurat
Gunakan openclaw models list untuk mengonfirmasi ID provider saat ini, lalu ganti dengan openclaw models set minimax/MiniMax-M2.7 atau openclaw models set minimax-portal/MiniMax-M2.7

Tautan referral untuk MiniMax Coding Plan (diskon 10%): MiniMax Coding Plan

Lihat Provider model untuk aturan provider.

Pemecahan masalah

"Model tidak dikenal: minimax/MiniMax-M2.7"

Ini biasanya berarti provider MiniMax belum dikonfigurasi (tidak ada entri provider yang cocok dan tidak ada profil auth/env key MiniMax yang ditemukan). Perbaikan untuk deteksi ini ada di 2026.1.12. Perbaiki dengan:

Upgrade ke 2026.1.12 (atau jalankan dari source main), lalu restart gateway.
Jalankan openclaw configure dan pilih opsi auth MiniMax, atau
Tambahkan blok models.providers.minimax atau models.providers.minimax-portal yang cocok secara manual, atau
Setel MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN, atau profil auth MiniMax agar provider yang cocok dapat disisipkan.

Pastikan ID model peka huruf besar-kecil:

Jalur API key: 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 provider, ref model, dan perilaku failover.

Pembuatan gambar

Parameter tool gambar bersama dan pemilihan provider.

Pembuatan musik

Parameter tool musik bersama dan pemilihan provider.

Pembuatan video

Parameter tool video bersama dan pemilihan provider.

MiniMax Search

Konfigurasi pencarian web melalui MiniMax Coding Plan.

Pemecahan masalah

Pemecahan masalah umum dan FAQ.

Overview

Concepts and configuration

Providers

MiniMax

MiniMax

Jajaran model

Memulai

Contoh config

Konfigurasi melalui `openclaw configure`

Kapabilitas

Pembuatan gambar

Pembuatan musik

Pembuatan video

Pemahaman gambar

Pencarian web

Konfigurasi lanjutan

Catatan

Pemecahan masalah

Terkait

Pemilihan model

Pembuatan gambar

Pembuatan musik

Pembuatan video

MiniMax Search

Pemecahan masalah

Overview

Concepts and configuration

Providers

​MiniMax

​Jajaran model

​Memulai

​Contoh config

​Konfigurasi melalui openclaw configure

​Kapabilitas

​Pembuatan gambar

​Pembuatan musik

​Pembuatan video

​Pemahaman gambar

​Pencarian web

​Konfigurasi lanjutan

​Catatan

​Pemecahan masalah

​Terkait

Pemilihan model

Pembuatan gambar

Pembuatan musik

Pembuatan video

MiniMax Search

Pemecahan masalah

MiniMax

Jajaran model

Memulai

Contoh config

Konfigurasi melalui `openclaw configure`

Kapabilitas

Pembuatan gambar

Pembuatan musik

Pembuatan video

Pemahaman gambar

Pencarian web

Konfigurasi lanjutan

Catatan

Pemecahan masalah

Terkait