OpenClaw’ın MiniMax sağlayıcısı varsayılan olarak MiniMax M2.7 kullanır. MiniMax ayrıca şunları sağlar: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.
- T2A v2 ile birlikte gelen konuşma sentezi
MiniMax-VL-01ile birlikte gelen görsel anlamamusic-2.6ile birlikte gelen müzik oluşturma- MiniMax Token Plan arama API’si üzerinden birlikte gelen
web_search
| Sağlayıcı ID’si | Kimlik doğrulama | Yetenekler |
|---|---|---|
minimax | API anahtarı | Metin, görsel oluşturma, müzik oluşturma, video oluşturma, görsel anlama, konuşma, web araması |
minimax-portal | OAuth | Metin, görsel oluşturma, müzik oluşturma, video oluşturma, görsel anlama, konuşma |
Yerleşik katalog
| 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örü | Görsel anlama modeli |
image-01 | Görsel oluşturma | Metinden görsele ve görselden görsele düzenleme |
music-2.6 | Müzik oluşturma | Varsayılan müzik modeli |
music-2.5 | Müzik oluşturma | Önceki müzik oluşturma katmanı |
music-2.0 | Müzik oluşturma | Eski müzik oluşturma katmanı |
MiniMax-Hailuo-2.3 | Video oluşturma | Metinden videoya ve görsel referans akışları |
Başlarken
Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.- OAuth (Coding Plan)
- API anahtarı
En uygun kullanım: OAuth üzerinden MiniMax Coding Plan ile hızlı kurulum, API anahtarı gerekmez.
- Uluslararası
- Çin
OAuth kurulumları
minimax-portal sağlayıcı id’sini kullanır. Model başvuruları minimax-portal/MiniMax-M2.7 biçimini izler.openclaw configure ile yapılandırma
JSON düzenlemeden MiniMax’i ayarlamak için etkileşimli yapılandırma sihirbazını kullanın:
Bir MiniMax kimlik doğrulama seçeneği belirleyin
Kullanılabilir MiniMax seçeneklerinden birini seçin:
| Kimlik doğrulama seçeneği | Açıklama |
|---|---|
minimax-global-oauth | Uluslararası OAuth (Kodlama Planı) |
minimax-cn-oauth | Çin OAuth (Kodlama Planı) |
minimax-global-api | Uluslararası API anahtarı |
minimax-cn-api | Çin API anahtarı |
Özellikler
Görsel oluşturma
MiniMax Plugin,image_generate aracı için image-01 modelini kaydeder. Şunları destekler:
- En boy oranı denetimiyle metinden görsel oluşturma
- En boy oranı denetimiyle görselden görsele düzenleme (konu referansı)
- İstek başına en fazla 9 çıktı görseli
- Düzenleme isteği başına en fazla 1 referans görsel
- 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 ayarlanmışsa ek yapılandırma gerekmez.
Hem minimax hem de minimax-portal, aynı image-01 modeliyle image_generate kaydı yapar. API anahtarı kurulumları MINIMAX_API_KEY kullanır; OAuth kurulumları bunun yerine paketle gelen minimax-portal kimlik doğrulama yolunu kullanabilir.
Görsel oluşturma her zaman MiniMax’in özel görsel uç noktasını (/v1/image_generation) kullanır ve models.providers.minimax.baseUrl değerini yok sayar; çünkü bu alan sohbet/Anthropic uyumlu temel URL’yi yapılandırır. Görsel oluşturmayı CN uç noktası üzerinden yönlendirmek için MINIMAX_API_HOST=https://api.minimaxi.com ayarlayın; varsayılan global uç nokta https://api.minimax.io değeridir.
İlk kurulum veya API anahtarı kurulumu açık models.providers.minimax girdileri yazdığında, OpenClaw MiniMax-M2.7 ve MiniMax-M2.7-highspeed modellerini yalnızca metin sohbet modelleri olarak somutlaştırır. Görsel anlama, Plugin tarafından sahip olunan 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 Görsel Oluşturma bölümüne bakın.
Metinden konuşmaya
Paketle gelenminimax Plugin, MiniMax T2A v2’yi messages.tts için bir konuşma sağlayıcısı olarak kaydeder.
- Varsayılan TTS modeli:
speech-2.8-hd - Varsayılan ses:
English_expressive_narrator - Desteklenen paket model kimlikleri arasında
speech-2.8-hd,speech-2.8-turbo,speech-2.6-hd,speech-2.6-turbo,speech-02-hd,speech-02-turbo,speech-01-hdvespeech-01-turbobulunur. - Kimlik doğrulama çözümleme sırası
messages.tts.providers.minimax.apiKey, ardındanminimax-portalOAuth/token kimlik doğrulama profilleri, ardından Token Plan ortam anahtarları (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), ardındanMINIMAX_API_KEYşeklindedir. - TTS ana makinesi yapılandırılmamışsa OpenClaw, yapılandırılmış
minimax-portalOAuth ana makinesini yeniden kullanır ve/anthropicgibi Anthropic uyumlu yol soneklerini kaldırır. - Normal ses ekleri MP3 olarak kalır.
- Feishu ve Telegram gibi sesli not hedefleri, MiniMax MP3’ten
ffmpegile 48 kHz Opus biçimine dönüştürülür; çünkü Feishu/Lark dosya API’si yerel ses mesajları için yalnızcafile_type: "opus"değerini kabul eder. - MiniMax T2A kesirli
speedvevoldeğerlerini kabul eder, ancakpitchtam sayı olarak gönderilir; OpenClaw, API isteğinden önce kesirlipitchdeğerlerini keser.
| Ayar | Ortam değişkeni | Varsayılan | Açıklama |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | MiniMax T2A API ana makinesi. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | TTS model kimliği. |
messages.tts.providers.minimax.voiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | Konuşma çıktısı için kullanılan ses kimliği. |
messages.tts.providers.minimax.speed | 1.0 | Oynatma hızı, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Ses düzeyi, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Tam sayı perde kaydırması, -12..12. |
Müzik oluşturma
Paketle gelen MiniMax Plugin, hemminimax hem de minimax-portal için paylaşılan music_generate aracı üzerinden müzik oluşturmayı kaydeder.
- Varsayılan müzik modeli:
minimax/music-2.6 - OAuth müzik modeli:
minimax-portal/music-2.6 minimax/music-2.5veminimax/music-2.0modellerini de destekler- İstem denetimleri:
lyrics,instrumental,durationSeconds - Çıktı 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 Müzik Oluşturma bölümüne bakın.
Video oluşturma
Paketle gelen MiniMax Plugin, hemminimax hem de minimax-portal için paylaşılan video_generate aracı üzerinden video oluşturmayı kaydeder.
- Varsayılan video modeli:
minimax/MiniMax-Hailuo-2.3 - OAuth video modeli:
minimax-portal/MiniMax-Hailuo-2.3 - Modlar: metinden videoya ve tek görsel referans akışları
aspectRatioveresolutiondestekler
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örsel anlama
MiniMax Plugin, görsel anlamayı metin kataloğundan ayrı olarak kaydeder:| Sağlayıcı ID’si | Varsayılan görsel modeli |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Web araması
MiniMax Plugin ayrıca MiniMax Token Plan arama API’si üzerindenweb_search
kaydeder.
- Sağlayıcı id’si:
minimax - Yapılandırılmış sonuçlar: başlıklar, URL’ler, parçacıklar, ilgili sorgular
- Tercih edilen env var:
MINIMAX_CODE_PLAN_KEY - Kabul edilen env alias’ları:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Uyumluluk yedeği: zaten token-plan kimlik bilgisine işaret ettiğinde
MINIMAX_API_KEY - Bölgeyi yeniden kullanma:
plugins.entries.minimax.config.webSearch.region, ardındanMINIMAX_API_HOST, ardından MiniMax sağlayıcı taban URL’leri - Arama, sağlayıcı id’si
minimaxüzerinde kalır; OAuth CN/küresel kurulumu, bölgeyimodels.providers.minimax-portal.baseUrlüzerinden dolaylı olarak yönlendirebilir veMINIMAX_OAUTH_TOKENüzerinden bearer auth sağlayabilir
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
Configuration options
Configuration options
| Seçenek | Açıklama |
|---|---|
models.providers.minimax.baseUrl | https://api.minimax.io/anthropic tercih edilir (Anthropic uyumlu); https://api.minimax.io/v1 OpenAI uyumlu payload’lar için isteğe bağlıdır |
models.providers.minimax.api | anthropic-messages tercih edilir; openai-completions OpenAI uyumlu payload’lar 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 olmasını istediğiniz modeller için alias tanımlayın |
models.mode | MiniMax’i yerleşiklerle birlikte eklemek istiyorsanız merge olarak tutun |
Thinking defaults
Thinking defaults
api: "anthropic-messages" üzerinde, düşünme params/config içinde zaten açıkça ayarlanmadıysa OpenClaw thinking: { type: "disabled" } enjekte eder.Bu, MiniMax’in streaming endpoint’inin OpenAI tarzı delta parçalarında reasoning_content yaymasını engeller; aksi halde dahili akıl yürütme görünür çıktıya sızardı.Fast mode
Fast mode
/fast on veya params.fastMode: true, Anthropic uyumlu stream yolunda MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.Fallback example
Fallback example
En iyi kullanım: en güçlü son nesil modelinizi birincil olarak tutun, MiniMax M2.7’ye yük devredin. Aşağıdaki örnek, somut bir birincil olarak Opus kullanır; kendi tercih ettiğiniz son 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/token_plan/remainsveyahttps://api.minimax.io/v1/token_plan/remains(coding plan anahtarı gerektirir). - Kullanım yoklaması, yapılandırıldığında ana makineyi
models.providers.minimax-portal.baseUrlveyamodels.providers.minimax.baseUrlüzerinden türetir; bu nedenlehttps://api.minimax.io/anthropickullanan küresel kurulumlarapi.minimax.ioadresini yoklar. Eksik veya hatalı biçimlendirilmiş temel URL’ler uyumluluk için CN yedeğini korur. - OpenClaw, MiniMax coding-plan kullanımını diğer sağlayıcıların kullandığı aynı
% kaldıgösterimine normalleştirir. MiniMax’in hamusage_percent/usagePercentalanları tüketilen kota değil, kalan kotadır; bu yüzden OpenClaw bunları tersine çevirir. Sayıma dayalı alanlar mevcut olduğunda önceliklidir. - API
model_remainsdöndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketinistart_time/end_timeüzerinden türetir ve coding-plan pencerelerinin daha kolay ayırt edilebilmesi için seçilen model adını plan etiketine ekler. - 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önmeden önce saklanan 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 - İlk kurulum ve doğrudan API anahtarı kurulumu, her iki M2.7 varyantı için yalnızca metin model tanımları yazar
- Görsel anlama, Plugin tarafından sahiplenilen
MiniMax-VL-01medya sağlayıcısını kullanır - Tam maliyet takibine ihtiyacınız varsa fiyatlandırma değerlerini
models.jsoniçinde güncelleyin - Geçerli sağlayıcı kimliğini doğrulamak için
openclaw models listkomutunu kullanın, ardındanopenclaw models set minimax/MiniMax-M2.7veyaopenclaw models set minimax-portal/MiniMax-M2.7ile geçiş yapın
Sağlayıcı kuralları için Model sağlayıcıları bölümüne bakın.
Sorun giderme
"Bilinmeyen model: minimax/MiniMax-M2.7"
"Bilinmeyen 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ı bulunmamıştır). Bu algılama için düzeltme 2026.1.12 sürümündedir. Şu şekilde düzeltin:
- 2026.1.12 sürümüne yükseltin (veya kaynak koddan
mainüzerinde çalıştırın), ardından gateway’i yeniden başlatın. openclaw configurekomutunu çalıştırıp bir MiniMax kimlik doğrulama seçeneği belirleyin veya- Eşleşen
models.providers.minimaxveyamodels.providers.minimax-portalbloğunu elle ekleyin veya - Eşleşen sağlayıcının enjekte edilebilmesi 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: Sorun giderme ve SSS.
İlgili
Model seçimi
Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.
Görsel oluşturma
Paylaşılan görsel aracı parametreleri ve sağlayıcı seçimi.
Müzik oluşturma
Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.
Video oluşturma
Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.
MiniMax Search
MiniMax Token Plan aracılığıyla web araması yapılandırması.
Sorun giderme
Genel sorun giderme ve SSS.