Ana içeriğe atla

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-01 aracılığıyla paketlenmiş görüntü anlama
  • music-2.5+ aracılığıyla paketlenmiş müzik üretimi
  • MiniMax Coding Plan arama API’si üzerinden paketlenmiş web_search
Sağlayıcı ayrımı:
Sağlayıcı kimliğiKimlik doğrulamaYetenekler
minimaxAPI anahtarıMetin, görüntü üretimi, görüntü anlama, konuşma, web araması
minimax-portalOAuthMetin, görüntü üretimi, görüntü anlama

Model ailesi

ModelTürAçıklama
MiniMax-M2.7Sohbet (akıl yürütme)Varsayılan barındırılan akıl yürütme modeli
MiniMax-M2.7-highspeedSohbet (akıl yürütme)Daha hızlı M2.7 akıl yürütme katmanı
MiniMax-VL-01GörselGörüntü anlama modeli
image-01Görüntü üretimiMetinden görüntü ve görüntüden görüntü düzenleme
music-2.5+Müzik üretimiVarsayılan müzik modeli
music-2.5Müzik üretimiÖnceki müzik üretimi katmanı
music-2.0Müzik üretimiEski müzik üretimi katmanı
MiniMax-Hailuo-2.3Video üretimiMetinden 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.
En iyi kullanım alanı: OAuth ile MiniMax Coding Plan üzerinden hızlı kurulum, API anahtarı gerekmez.
1

Onboarding çalıştırın

openclaw onboard --auth-choice minimax-global-oauth
Bu, api.minimax.io üzerinde kimlik doğrulaması yapar.
2

Modelin kullanılabildiğini doğrulayın

openclaw models list --provider minimax-portal
OAuth kurulumları minimax-portal sağlayıcı kimliğini kullanır. Model referansları minimax-portal/MiniMax-M2.7 biçimini izler.
MiniMax Coding Plan için yönlendirme bağlantısı (%10 indirim): MiniMax Coding Plan

openclaw configure ile yapılandırma

JSON düzenlemeden MiniMax’ı ayarlamak için etkileşimli yapılandırma sihirbazını kullanın:
1

Sihirbazı başlatın

openclaw configure
2

Model/auth seçin

Menüden Model/auth seçeneğini seçin.
3

Bir MiniMax kimlik doğrulama seçeneği seçin

Kullanılabilir MiniMax seçeneklerinden birini seçin:
Kimlik doğrulama seçeneğiAçıklama
minimax-global-oauthUluslararası OAuth (Coding Plan)
minimax-cn-oauthÇin OAuth (Coding Plan)
minimax-global-apiUluslararası API anahtarı
minimax-cn-apiÇin API anahtarı
4

Varsayılan modelinizi seçin

İstendiğinde varsayılan modelinizi seçin.

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
Görüntü üretimi için MiniMax kullanmak üzere, onu görüntü üretimi sağlayıcısı olarak ayarlayın:
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
Plugin, metin modelleriyle aynı 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.5 ve minimax/music-2.0 desteklenir
  • İ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
Varsayılan müzik sağlayıcısı olarak MiniMax kullanmak için:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.5+",
      },
    },
  },
}
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
  • aspectRatio ve resolution desteklenir
Varsayılan video sağlayıcısı olarak MiniMax kullanmak için:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
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ğiVarsayılan görüntü modeli
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Bu nedenle otomatik medya yönlendirme, paketlenmiş metin sağlayıcı kataloğu hâlâ yalnızca metin odaklı M2.7 sohbet referanslarını gösterirken bile MiniMax görüntü anlamayı kullanabilir.

Web araması

MiniMax Plugin’i ayrıca MiniMax Coding Plan arama API’si üzerinden web_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ından MINIMAX_API_HOST, ardından MiniMax sağlayıcı temel URL’leri
  • Arama, minimax sağlayıcı kimliğinde kalır; OAuth CN/global kurulumu yine de bölgeyi dolaylı olarak models.providers.minimax-portal.baseUrl üzerinden yönlendirebilir
Yapılandırma 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

SeçenekAçıklama
models.providers.minimax.baseUrlTercihen 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.apiTercihen anthropic-messages; openai-completions OpenAI uyumlu yükler için isteğe bağlıdır
models.providers.minimax.apiKeyMiniMax API anahtarı (MINIMAX_API_KEY)
models.providers.minimax.modelsid, name, reasoning, contextWindow, maxTokens, cost tanımlayın
agents.defaults.modelsİzin listesinde istediğiniz modellere takma ad verin
models.modeMiniMax’ı yerleşiklerle birlikte eklemek istiyorsanız merge olarak tutun
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.
/fast on veya params.fastMode: true, Anthropic uyumlu akış yolunda MiniMax-M2.7 modelini MiniMax-M2.7-highspeed olarak yeniden yazar.
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.
{
  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"],
      },
    },
  },
}
  • 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 ham usage_percent / usagePercent alanları tüketilen kotayı değil, kalan kotayı gösterir; bu yüzden OpenClaw bunları ters çevirir. Varsa sayım tabanlı alanlar önceliklidir.
  • API model_remains döndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketini start_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-cn ve minimax-portal değ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>
  • 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.json içindeki fiyatlandırma değerlerini güncelleyin
  • Geçerli sağlayıcı kimliğini doğrulamak için openclaw models list kullanın, ardından openclaw models set minimax/MiniMax-M2.7 veya openclaw models set minimax-portal/MiniMax-M2.7 ile değiştirin
MiniMax Coding Plan için yönlendirme bağlantısı (%10 indirim): MiniMax Coding Plan
Sağlayıcı kuralları için Model providers bölümüne bakın.

Sorun giderme

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.minimax ya da models.providers.minimax-portal bloğunu elle ekleyin, veya
  • Eşleşen sağlayıcının eklenebilmesi için MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN ya da bir MiniMax kimlik doğrulama profili ayarlayın.
Model kimliğinin büyük/küçük harfe duyarlı olduğundan emin olun:
  • API anahtarı yolu: minimax/MiniMax-M2.7 veya minimax/MiniMax-M2.7-highspeed
  • OAuth yolu: minimax-portal/MiniMax-M2.7 veya minimax-portal/MiniMax-M2.7-highspeed
Ardından şununla tekrar kontrol edin:
openclaw models list
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.