MiniMax
OpenClaw’ın MiniMax sağlayıcısı varsayılan olarak MiniMax M2.7 kullanır. MiniMax ayrıca şunları da sağlar:- T2A v2 aracılığıyla paketlenmiş konuşma sentezi
MiniMax-VL-01aracılığıyla paketlenmiş görüntü anlamamusic-2.5+aracılığıyla paketlenmiş müzik üretimi- MiniMax Coding Plan arama API’si üzerinden paketlenmiş
web_search
| Sağlayıcı kimliği | Kimlik doğrulama | Yetenekler |
|---|---|---|
minimax | API anahtarı | Metin, görüntü üretimi, görüntü anlama, konuşma, web araması |
minimax-portal | OAuth | Metin, görüntü üretimi, görüntü anlama |
Model ailesi
| Model | Tür | Açıklama |
|---|---|---|
MiniMax-M2.7 | Sohbet (akıl yürütme) | Varsayılan barındırılan akıl yürütme modeli |
MiniMax-M2.7-highspeed | Sohbet (akıl yürütme) | Daha hızlı M2.7 akıl yürütme katmanı |
MiniMax-VL-01 | Görsel | Görüntü anlama modeli |
image-01 | Görüntü üretimi | Metinden görüntü ve görüntüden görüntü düzenleme |
music-2.5+ | Müzik üretimi | Varsayılan müzik modeli |
music-2.5 | Müzik üretimi | Önceki müzik üretimi katmanı |
music-2.0 | Müzik üretimi | Eski müzik üretimi katmanı |
MiniMax-Hailuo-2.3 | Video üretimi | Metinden videoya ve görüntü referans akışları |
Başlangıç
Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.- OAuth (Coding Plan)
- API anahtarı
En iyi kullanım alanı: OAuth ile MiniMax Coding Plan üzerinden hızlı kurulum, API anahtarı gerekmez.
- Uluslararası
- Çin
OAuth kurulumları
minimax-portal sağlayıcı kimliğini kullanır. Model referansları minimax-portal/MiniMax-M2.7 biçimini izler.openclaw configure ile yapılandırma
JSON düzenlemeden MiniMax’ı ayarlamak için etkileşimli yapılandırma sihirbazını kullanın:
Bir MiniMax kimlik doğrulama seçeneği seçin
Kullanılabilir MiniMax seçeneklerinden birini seçin:
| Kimlik doğrulama seçeneği | Açıklama |
|---|---|
minimax-global-oauth | Uluslararası OAuth (Coding Plan) |
minimax-cn-oauth | Çin OAuth (Coding Plan) |
minimax-global-api | Uluslararası API anahtarı |
minimax-cn-api | Çin API anahtarı |
Yetenekler
Görüntü üretimi
MiniMax Plugin’i,image_generate aracı için image-01 modelini kaydeder. Şunları destekler:
- En-boy oranı kontrolü ile metinden görüntü üretimi
- En-boy oranı kontrolü ile görüntüden görüntü düzenleme (özne referansı)
- İstek başına en fazla 9 çıktı görüntüsü
- Düzenleme isteği başına en fazla 1 referans görüntü
- Desteklenen en-boy oranları:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
MINIMAX_API_KEY veya OAuth kimlik doğrulamasını kullanır. MiniMax zaten kurulmuşsa ek yapılandırma gerekmez.
Hem minimax hem de minimax-portal, aynı
image-01 modeliyle image_generate kaydeder. API anahtarı kurulumları MINIMAX_API_KEY kullanır; OAuth kurulumları bunun yerine
paketlenmiş minimax-portal kimlik doğrulama yolunu kullanabilir.
Onboarding veya API anahtarı kurulumu açık models.providers.minimax
girdileri yazdığında, OpenClaw MiniMax-M2.7 ve
MiniMax-M2.7-highspeed modellerini input: ["text", "image"] ile somutlaştırır.
Yerleşik paketlenmiş MiniMax metin kataloğunun kendisi, bu açık sağlayıcı yapılandırması oluşana kadar
yalnızca metin meta verisi olarak kalır. Görüntü anlama ise
Plugin’e ait MiniMax-VL-01 medya sağlayıcısı üzerinden ayrı olarak sunulur.
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Image Generation bölümüne bakın.
Müzik üretimi
Paketlenmişminimax Plugin’i ayrıca paylaşılan
music_generate aracı üzerinden müzik üretimini de kaydeder.
- Varsayılan müzik modeli:
minimax/music-2.5+ - Ayrıca
minimax/music-2.5veminimax/music-2.0desteklenir - İstem denetimleri:
lyrics,instrumental,durationSeconds - Çıkış biçimi:
mp3 - Oturum destekli çalıştırmalar,
action: "status"dahil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Music Generation bölümüne bakın.
Video üretimi
Paketlenmişminimax Plugin’i ayrıca paylaşılan
video_generate aracı üzerinden video üretimini de kaydeder.
- Varsayılan video modeli:
minimax/MiniMax-Hailuo-2.3 - Modlar: metinden videoya ve tek görüntü referanslı akışlar
aspectRatioveresolutiondesteklenir
Paylaşılan araç parametreleri, sağlayıcı seçimi ve yük devretme davranışı için Video Generation bölümüne bakın.
Görüntü anlama
MiniMax Plugin’i görüntü anlamayı metin kataloğundan ayrı kaydeder:| Sağlayıcı kimliği | Varsayılan görüntü modeli |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Web araması
MiniMax Plugin’i ayrıca MiniMax Coding Plan arama API’si üzerindenweb_search de kaydeder.
- Sağlayıcı kimliği:
minimax - Yapılandırılmış sonuçlar: başlıklar, URL’ler, özet parçaları, ilgili sorgular
- Tercih edilen ortam değişkeni:
MINIMAX_CODE_PLAN_KEY - Kabul edilen ortam takma adı:
MINIMAX_CODING_API_KEY - Uyumluluk yedeği: zaten coding-plan token’ına işaret ediyorsa
MINIMAX_API_KEY - Bölge yeniden kullanımı:
plugins.entries.minimax.config.webSearch.region, ardındanMINIMAX_API_HOST, ardından MiniMax sağlayıcı temel URL’leri - Arama,
minimaxsağlayıcı kimliğinde kalır; OAuth CN/global kurulumu yine de bölgeyi dolaylı olarakmodels.providers.minimax-portal.baseUrlüzerinden yönlendirebilir
plugins.entries.minimax.config.webSearch.* altında bulunur.
Tam web araması yapılandırması ve kullanımı için MiniMax Search bölümüne bakın.
Gelişmiş yapılandırma
Yapılandırma seçenekleri
Yapılandırma seçenekleri
| Seçenek | Açıklama |
|---|---|
models.providers.minimax.baseUrl | Tercihen https://api.minimax.io/anthropic (Anthropic uyumlu); https://api.minimax.io/v1 OpenAI uyumlu yükler için isteğe bağlıdır |
models.providers.minimax.api | Tercihen anthropic-messages; openai-completions OpenAI uyumlu yükler için isteğe bağlıdır |
models.providers.minimax.apiKey | MiniMax API anahtarı (MINIMAX_API_KEY) |
models.providers.minimax.models | id, name, reasoning, contextWindow, maxTokens, cost tanımlayın |
agents.defaults.models | İzin listesinde istediğiniz modellere takma ad verin |
models.mode | MiniMax’ı yerleşiklerle birlikte eklemek istiyorsanız merge olarak tutun |
Thinking varsayılanları
Thinking varsayılanları
api: "anthropic-messages" üzerinde, OpenClaw düşünme zaten parametrelerde/yapılandırmada açıkça ayarlanmadıysa thinking: { type: "disabled" } enjekte eder.Bu, MiniMax’ın akış uç noktasının OpenAI tarzı delta parçaları içinde reasoning_content yaymasını önler; aksi halde bu durum iç akıl yürütmenin görünür çıktıya sızmasına neden olur.Hızlı mod
Hızlı mod
/fast on veya params.fastMode: true, Anthropic uyumlu akış yolunda MiniMax-M2.7 modelini MiniMax-M2.7-highspeed olarak yeniden yazar.Yük devretme örneği
Yük devretme örneği
En iyi kullanım alanı: en güçlü yeni nesil modelinizi birincil olarak tutup MiniMax M2.7’ye yük devretmek. Aşağıdaki örnek, somut bir birincil model olarak Opus kullanır; bunu tercih ettiğiniz yeni nesil birincil modelle değiştirin.
Coding Plan kullanım ayrıntıları
Coding Plan kullanım ayrıntıları
- Coding Plan kullanım API’si:
https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains(bir coding plan anahtarı gerektirir). - OpenClaw, MiniMax coding-plan kullanımını diğer sağlayıcılarda kullanılan aynı
% kaldıgörünümüne normalize eder. MiniMax’ın hamusage_percent/usagePercentalanları tüketilen kotayı değil, kalan kotayı gösterir; bu yüzden OpenClaw bunları ters çevirir. Varsa sayım tabanlı alanlar önceliklidir. - API
model_remainsdöndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketinistart_time/end_timeüzerinden türetir ve seçilen model adını plan etiketine ekler; böylece coding-plan pencerelerini ayırt etmek kolaylaşır. - Kullanım anlık görüntüleri
minimax,minimax-cnveminimax-portaldeğerlerini aynı MiniMax kota yüzeyi olarak ele alır ve Coding Plan anahtarı ortam değişkenlerine geri düşmeden önce kayıtlı MiniMax OAuth’u tercih eder.
Notlar
- Model referansları kimlik doğrulama yolunu izler:
- API anahtarı kurulumu:
minimax/<model> - OAuth kurulumu:
minimax-portal/<model>
- API anahtarı kurulumu:
- Varsayılan sohbet modeli:
MiniMax-M2.7 - Alternatif sohbet modeli:
MiniMax-M2.7-highspeed - Onboarding ve doğrudan API anahtarı kurulumu, her iki M2.7 varyantı için de
input: ["text", "image"]içeren açık model tanımları yazar - Paketlenmiş sağlayıcı kataloğu şu anda, açık MiniMax sağlayıcı yapılandırması oluşana kadar sohbet referanslarını yalnızca metin meta verisi olarak sunar
- Tam maliyet takibi gerekiyorsa
models.jsoniçindeki fiyatlandırma değerlerini güncelleyin - Geçerli sağlayıcı kimliğini doğrulamak için
openclaw models listkullanın, ardındanopenclaw models set minimax/MiniMax-M2.7veyaopenclaw models set minimax-portal/MiniMax-M2.7ile değiştirin
Sağlayıcı kuralları için Model providers bölümüne bakın.
Sorun giderme
"Unknown model: minimax/MiniMax-M2.7"
"Unknown model: minimax/MiniMax-M2.7"
Bu genellikle MiniMax sağlayıcısının yapılandırılmadığı anlamına gelir (eşleşen sağlayıcı girdisi yoktur ve MiniMax kimlik doğrulama profili/ortam anahtarı bulunamaz). Bu algılama için bir düzeltme 2026.1.12 sürümündedir. Düzeltmek için:
- 2026.1.12 sürümüne yükseltin (veya kaynak koddan
mainçalıştırın), ardından gateway’i yeniden başlatın. openclaw configureçalıştırıp bir MiniMax kimlik doğrulama seçeneği seçin, veya- Eşleşen
models.providers.minimaxya damodels.providers.minimax-portalbloğunu elle ekleyin, veya - Eşleşen sağlayıcının eklenebilmesi için
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENya da bir MiniMax kimlik doğrulama profili ayarlayın.
- API anahtarı yolu:
minimax/MiniMax-M2.7veyaminimax/MiniMax-M2.7-highspeed - OAuth yolu:
minimax-portal/MiniMax-M2.7veyaminimax-portal/MiniMax-M2.7-highspeed
Daha fazla yardım: Troubleshooting ve FAQ.
İlgili
Model seçimi
Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.
Görüntü üretimi
Paylaşılan görüntü aracı parametreleri ve sağlayıcı seçimi.
Müzik üretimi
Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.
Video üretimi
Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.
MiniMax Search
MiniMax Coding Plan üzerinden web araması yapılandırması.
Sorun giderme
Genel sorun giderme ve SSS.