MiniMax

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ı:

# Yerleşik katalog

# Başlarken

Tercih ettiğiniz kimlik doğrulama yöntemini seçin ve kurulum adımlarını izleyin.

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider minimax

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

# openclaw configure ile yapılandırma

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

openclaw configure

# Ö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.

# 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.

# 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",
      },
    },
  },
}

# 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",
      },
    },
  },
}

# Görsel anlama

MiniMax Plugin, görsel anlamayı metin kataloğundan ayrı olarak kaydeder:

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.

# Gelişmiş yapılandırma

{
  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"],
      },
    },
  },
}

# 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

# Sorun giderme

openclaw models list

# İlgili