Ana içeriğe atla

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.

OpenClaw’ın MiniMax sağlayıcısı varsayılan olarak MiniMax M2.7 kullanır. MiniMax ayrıca şunları sağlar:
  • T2A v2 ile birlikte gelen konuşma sentezi
  • MiniMax-VL-01 ile birlikte gelen görsel anlama
  • music-2.6 ile birlikte gelen müzik oluşturma
  • MiniMax Token Plan arama API’si üzerinden birlikte gelen web_search
Sağlayıcı ayrımı:
Sağlayıcı ID’siKimlik doğrulamaYetenekler
minimaxAPI anahtarıMetin, görsel oluşturma, müzik oluşturma, video oluşturma, görsel anlama, konuşma, web araması
minimax-portalOAuthMetin, görsel oluşturma, müzik oluşturma, video oluşturma, görsel anlama, konuşma

Yerleşik katalog

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örüGörsel anlama modeli
image-01Görsel oluşturmaMetinden görsele ve görselden görsele düzenleme
music-2.6Müzik oluşturmaVarsayılan müzik modeli
music-2.5Müzik oluşturmaÖnceki müzik oluşturma katmanı
music-2.0Müzik oluşturmaEski müzik oluşturma katmanı
MiniMax-Hailuo-2.3Video oluşturmaMetinden 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.
En uygun kullanım: OAuth üzerinden MiniMax Coding Plan ile hızlı kurulum, API anahtarı gerekmez.
1

İlk kurulumu çalıştırın

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider minimax-portal
OAuth kurulumları minimax-portal sağlayıcı id’sini kullanır. Model başvuruları 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’i ayarlamak için etkileşimli yapılandırma sihirbazını kullanın:
1

Sihirbazı başlatın

openclaw configure
2

Model/kimlik doğrulamayı seçin

Menüden Model/kimlik doğrulama seçeneğini belirleyin.
3

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

Kullanılabilir MiniMax seçeneklerinden birini seçin:
Kimlik doğrulama seçeneğiAçıklama
minimax-global-oauthUluslararası OAuth (Kodlama Planı)
minimax-cn-oauthÇin OAuth (Kodlama 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.

Ö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
Görsel oluşturma için MiniMax’i kullanmak üzere görsel oluşturma 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 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 gelen minimax 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-hd ve speech-01-turbo bulunur.
  • Kimlik doğrulama çözümleme sırası messages.tts.providers.minimax.apiKey, ardından minimax-portal OAuth/token kimlik doğrulama profilleri, ardından Token Plan ortam anahtarları (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), ardından MINIMAX_API_KEY şeklindedir.
  • TTS ana makinesi yapılandırılmamışsa OpenClaw, yapılandırılmış minimax-portal OAuth ana makinesini yeniden kullanır ve /anthropic gibi Anthropic uyumlu yol soneklerini kaldırır.
  • Normal ses ekleri MP3 olarak kalır.
  • Feishu ve Telegram gibi sesli not hedefleri, MiniMax MP3’ten ffmpeg ile 48 kHz Opus biçimine dönüştürülür; çünkü Feishu/Lark dosya API’si yerel ses mesajları için yalnızca file_type: "opus" değerini kabul eder.
  • MiniMax T2A kesirli speed ve vol değerlerini kabul eder, ancak pitch tam sayı olarak gönderilir; OpenClaw, API isteğinden önce kesirli pitch değerlerini keser.
AyarOrtam değişkeniVarsayılanAçıklama
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax T2A API ana makinesi.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS model kimliği.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorKonuşma çıktısı için kullanılan ses kimliği.
messages.tts.providers.minimax.speed1.0Oynatma hızı, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Ses düzeyi, (0, 10].
messages.tts.providers.minimax.pitch0Tam sayı perde kaydırması, -12..12.

Müzik oluşturma

Paketle gelen MiniMax Plugin, hem minimax 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.5 ve minimax/music-2.0 modellerini 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
MiniMax’i varsayılan müzik sağlayıcısı olarak kullanmak için:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
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, hem minimax 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ı
  • aspectRatio ve resolution destekler
MiniMax’i varsayılan video sağlayıcısı olarak 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örsel anlama

MiniMax Plugin, görsel anlamayı metin kataloğundan ayrı olarak kaydeder:
Sağlayıcı ID’siVarsayılan görsel modeli
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Bu nedenle otomatik medya yönlendirme, paketlenmiş metin sağlayıcı kataloğu hala yalnızca metin M2.7 sohbet başvurularını gösterse bile MiniMax görsel anlamayı kullanabilir.

Web araması

MiniMax Plugin ayrıca MiniMax Token Plan arama API’si üzerinden web_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ından MINIMAX_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ölgeyi models.providers.minimax-portal.baseUrl üzerinden dolaylı olarak yönlendirebilir ve MINIMAX_OAUTH_TOKEN üzerinden bearer auth sağlayabilir
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.baseUrlhttps://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.apianthropic-messages tercih edilir; openai-completions OpenAI uyumlu payload’lar 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 olmasını istediğiniz modeller için alias tanımlayın
models.modeMiniMax’i yerleşiklerle birlikte eklemek istiyorsanız merge olarak tutun
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 on veya params.fastMode: true, Anthropic uyumlu stream yolunda MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.
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.
{
  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/token_plan/remains veya https://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.baseUrl veya models.providers.minimax.baseUrl üzerinden türetir; bu nedenle https://api.minimax.io/anthropic kullanan küresel kurulumlar api.minimax.io adresini 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 ham usage_percent / usagePercent alanları 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_remains döndürdüğünde OpenClaw sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketini start_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-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ö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>
  • 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-01 medya sağlayıcısını kullanır
  • Tam maliyet takibine ihtiyacınız varsa fiyatlandırma değerlerini models.json içinde güncelleyin
  • Geçerli sağlayıcı kimliğini doğrulamak için openclaw models list komutunu kullanın, ardından openclaw models set minimax/MiniMax-M2.7 veya openclaw models set minimax-portal/MiniMax-M2.7 ile geçiş yapın
MiniMax Coding Plan için referans bağlantısı (%10 indirim): MiniMax Coding Plan
Sağlayıcı kuralları için Model sağlayıcıları 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ı 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 configure komutunu çalıştırıp bir MiniMax kimlik doğrulama seçeneği belirleyin veya
  • Eşleşen models.providers.minimax veya models.providers.minimax-portal bloğunu elle ekleyin veya
  • Eşleşen sağlayıcının enjekte edilebilmesi 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 yeniden kontrol edin:
openclaw models list
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.