OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

Paketle gelen minimax Plugin'i iki sağlayıcıya ek olarak yedi yetenek kaydeder: sohbet, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma (T2A v2) ve web araması.

Sağlayıcı kimliği Kimlik doğrulama Yetenekler
minimax API anahtarı Metin, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma, web araması
minimax-portal OAuth Metin, görüntü oluşturma, müzik oluşturma, video oluşturma, görüntü anlama, konuşma

Yerleşik katalog

Model Tür Açıklama
MiniMax-M3 Sohbet (akıl yürütme) Varsayılan barındırılan akıl yürütme modeli
MiniMax-M2.7 Sohbet (akıl yürütme) Önceki 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üntü Görüntü anlama modeli
image-01 Görüntü oluşturma Metinden görüntüye ve görüntüden görüntüye düzenleme
music-2.6 Müzik oluşturma Varsayılan müzik modeli
MiniMax-Hailuo-2.3 Video oluşturma Metinden videoya ve görüntüden videoya akışlar

Model referansları kimlik doğrulama yolunu izler: API anahtarı kurulumları için minimax/<model>, OAuth kurulumları için minimax-portal/<model>.

Başlarken

OAuth (Coding Plan)

En uygun kullanım: API anahtarı gerektirmeden OAuth aracılığıyla MiniMax Coding Plan ile hızlı kurulum.

Uluslararası

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

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

    Elde edilen sağlayıcı temel URL'si: api.minimax.io.

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

    bash
    openclaw models list --provider minimax-portal

    • Çin

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

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

    Elde edilen sağlayıcı temel URL'si: api.minimaxi.com.

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

    bash
    openclaw models list --provider minimax-portal

    • API anahtarı

    En uygun kullanım: Anthropic uyumlu API ile barındırılan MiniMax.

    Uluslararası

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

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

    Bu, temel URL olarak api.minimax.io değerini yapılandırır.

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

    bash
    openclaw models list --provider minimax

    • Çin

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

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

    Bu, temel URL olarak api.minimaxi.com değerini yapılandırır.

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

    bash
    openclaw models list --provider minimax

    • Yapılandırma örneği

    json5
    {  env: { MINIMAX_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M3",            name: "MiniMax M3",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },            contextWindow: 1000000,            maxTokens: 131072,          },          {            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 aracılığıyla yapılandırma

  • Sihirbazı başlatın

    bash
    openclaw configure

  • Model/kimlik doğrulamayı seçin

    Menüden Model/auth öğesini seçin.

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

    Kimlik doğrulama seçimi 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ı

  • Varsayılan modelinizi seçin

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

    • Yetenekler

    Görüntü oluşturma

    MiniMax Plugin'i, aynı MINIMAX_API_KEY veya OAuth kimlik doğrulamasını metin modelleriyle yeniden kullanarak hem minimax hem de minimax-portal üzerinde image_generate aracı için image-01 modelini kaydeder.

    • En-boy oranı denetimiyle hem metinden görüntü oluşturma hem de görüntüden görüntüye düzenleme (özne referansı)
    • İstek başına en fazla 9 çıktı görüntüsü, düzenleme isteği başına 1 referans görüntüsü
    • Desteklenen en-boy oranları: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

    Görüntü oluşturma her zaman MiniMax'in özel görüntü uç noktasını (/v1/image_generation) kullanır ve bu alan bunun yerine sohbet/Anthropic uyumlu temel URL'yi yapılandırdığından models.providers.minimax.baseUrl değerini yok sayar. Görüntü oluşturmayı CN uç noktası üzerinden yönlendirmek için MINIMAX_API_HOST=https://api.minimaxi.com değerini ayarlayın; varsayılan küresel uç nokta https://api.minimax.io değeridir.

    Metinden konuşmaya

    Paketle gelen minimax Plugin'i, tts için MiniMax T2A v2'yi konuşma sağlayıcısı olarak kaydeder.

    • Varsayılan TTS modeli: speech-2.8-hd
    • Varsayılan ses: English_expressive_narrator
    • Paketle gelen model kimlikleri: 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, speech-01-turbo
    • Kimlik doğrulama çözümleme sırası: 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
    • Hiçbir 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. Sesli not hedefleri (Feishu, Telegram ve sesli not uyumlu bir ek isteyen diğer kanallar), örneğin Feishu/Lark dosya API'si yerel sesli mesajlar için yalnızca file_type: "opus" kabul ettiğinden MiniMax MP3'ten ffmpeg ile 48kHz Opus'a dönüştürülür
    • MiniMax T2A kesirli speed ve vol değerlerini kabul eder, ancak pitch bir tam sayı olarak gönderilir; OpenClaw, API isteğinden önce kesirli pitch değerlerini keser
    Ayar Ortam değişkeni Varsayılan Açıklama
    tts.providers.minimax.baseUrl MINIMAX_API_HOST https://api.minimax.io MiniMax T2A API ana makinesi.
    tts.providers.minimax.model MINIMAX_TTS_MODEL speech-2.8-hd TTS model kimliği.
    tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator Konuşma çıktısı için kullanılan ses kimliği.
    tts.providers.minimax.speed 1.0 Oynatma hızı, 0.5..2.0.
    tts.providers.minimax.vol 1.0 Ses düzeyi, (0, 10].
    tts.providers.minimax.pitch 0 Tam sayı perde kaydırması, -12..12.

    Müzik oluşturma

    Paketle gelen MiniMax Plugin'i, 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: minimax-portal/music-2.6)
    • Ayrıca music-2.6-free, music-cover ve music-cover-free desteklenir
    • İstem denetimleri: lyrics, instrumental
    • Çıktı biçimi: mp3
    • Oturum destekli çalıştırmalar, action: "status" dâhil olmak üzere paylaşılan görev/durum akışı üzerinden ayrılır
    json5
    {  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

    Video oluşturma

    Paketle gelen MiniMax Plugin'i, 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: minimax-portal/MiniMax-Hailuo-2.3)
    • Ayrıca MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live ve I2V-01 desteklenir
    • Modlar: metinden videoya ve tek görsel referanslı akışlar
    • resolution desteklenir (Hailuo 2.3/02 modellerinde 768P veya 1080P); aspectRatio desteklenmez ve yok sayılır
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

    Görsel anlama

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

    Sağlayıcı kimliği Varsayılan görsel modeli PDF metin çıkarma
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

    Bu nedenle, paketle birlikte gelen metin sağlayıcısı kataloğu görsel özellikli M3 sohbet referanslarını da içerse bile otomatik medya yönlendirmesi MiniMax görsel anlamayı kullanabilir. PDF anlama, yalnızca metin çıkarma için MiniMax-M2.7 kullanır; MiniMax, PDF'den görsele dönüştürme yolu kaydetmez.

    Web araması

    MiniMax Plugin ayrıca MiniMax Token Plan arama API'si (/v1/coding_plan/search) üzerinden web_search kaydeder.

    • Sağlayıcı kimliği: minimax
    • Yapılandırılmış sonuçlar: başlıklar, URL'ler, parçacıklar, ilgili sorgular
    • Tercih edilen ortam değişkeni: MINIMAX_CODE_PLAN_KEY
    • Kabul edilen ortam değişkeni takma adları: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
    • Uyumluluk geri dönüşü: zaten bir token planı kimlik bilgisine işaret ediyorsa MINIMAX_API_KEY
    • Bölgeyi yeniden kullanma sırası: plugins.entries.minimax.config.webSearch.region, ardından MINIMAX_API_HOST, ardından MiniMax sağlayıcısının temel URL'leri
    • Arama, minimax sağlayıcı kimliğinde kalır; OAuth CN/global kurulumu, models.providers.minimax-portal.baseUrl üzerinden bölgeyi dolaylı olarak yönlendirebilir ve MINIMAX_OAUTH_TOKEN üzerinden bearer kimlik doğrulaması sağlayabilir

    Yapılandırma plugins.entries.minimax.config.webSearch.* altında bulunur.

    Gelişmiş yapılandırma

    Yapılandırma seçenekleri
    Seçenek Açıklama
    models.providers.minimax.baseUrl https://api.minimax.io/anthropic tercih edilir (Anthropic uyumlu); OpenAI uyumlu yükler için https://api.minimax.io/v1 isteğe bağlıdır
    models.providers.minimax.api anthropic-messages tercih edilir; OpenAI uyumlu yükler için openai-completions 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ımlar
    agents.defaults.models Model başına takma adlar, parametreler ve meta veriler
    agents.defaults.modelPolicy.allow İsteğe bağlı açık model izin listesi
    models.mode MiniMax'i yerleşik seçeneklerin yanına eklemek istiyorsanız merge değerini koruyun
    Düşünme varsayılanları

    api: "anthropic-messages" üzerinde, önceki bir sarmalayıcı yükteki thinking alanını önceden ayarlamadığı sürece OpenClaw, MiniMax M2.x modelleri için thinking: { type: "disabled" } ekler. Bu, M2.x'in akış uç noktasının OpenAI tarzı delta parçalarında reasoning_content yayımlamasını önleyerek dahili akıl yürütmenin görünür çıktıya sızmasını engeller.

    MiniMax-M3 (ve M3.x) muaftır: düşünme devre dışı bırakıldığında M3, stop_reason: "end_turn" ile boş bir content dizisi döndürür; bu nedenle OpenClaw, M3 için örtük devre dışı varsayılanını kaldırır ve bir düşünme düzeyi ayarlandığında bunun yerine thinking: { type: "adaptive" } değerini zorunlu kılar.

    Model ailesine göre kullanılabilir düşünme düzeyleri:

    Model ailesi Düzeyler Varsayılan
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    Hızlı mod

    /fast on veya params.fastMode: true, Anthropic uyumlu akış yolunda (api: "anthropic-messages", sağlayıcı minimax veya minimax-portal) MiniMax-M2.7 değerini MiniMax-M2.7-highspeed olarak yeniden yazar.

    Geri dönüş örneği

    En uygun kullanım: En güçlü son nesil modelinizi birincil olarak kullanın, başarısızlık durumunda MiniMax M2.7'ye geçin. Aşağıdaki örnekte somut bir birincil model olarak Opus kullanılır; bunu tercih ettiğiniz son nesil birincil modelle değiştirin.

    json5
    {  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 ayrıntıları
    • Coding Plan kullanım API'si: https://api.minimaxi.com/v1/token_plan/remains veya https://api.minimax.io/v1/token_plan/remains (bir coding plan anahtarı gerektirir).
    • Kullanım yoklaması, yapılandırıldığında ana bilgisayarı models.providers.minimax-portal.baseUrl veya models.providers.minimax.baseUrl üzerinden türetir; böylece https://api.minimax.io/anthropic kullanan global kurulumlar api.minimax.io adresini yoklar. Eksik veya hatalı biçimlendirilmiş temel URL'ler, uyumluluk amacıyla CN geri dönüşünü korur.
    • OpenClaw, MiniMax coding plan kullanımını diğer sağlayıcıların kullandığı % left görünümüyle aynı biçime normalleştirir. MiniMax'in ham usage_percent / usagePercent alanları tüketilen değil, kalan kotayı gösterir; bu nedenle OpenClaw bunları tersine çevirir. Mevcut olduklarında sayı 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 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, minimax-portal ve minimax-portal-cn değerlerini aynı MiniMax kota yüzeyi olarak ele alır ve Coding Plan anahtarı ortam değişkenlerine geri dönmeden önce depolanmış MiniMax OAuth'u tercih eder.

    Notlar

    • Varsayılan sohbet modeli: MiniMax-M3. Alternatif sohbet modelleri: MiniMax-M2.7, MiniMax-M2.7-highspeed
    • İlk katılım ve doğrudan API anahtarı kurulumu, M3 ve her iki M2.7 çeşidi için model tanımları yazar
    • Görsel anlama, Plugin'e ait MiniMax-VL-01 medya sağlayıcısını kullanır
    • Kesin 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-M3 veya openclaw models set minimax-portal/MiniMax-M3 ile geçiş yapın

    Sorun giderme

    "Bilinmeyen model: minimax/MiniMax-M3"

    Bu genellikle MiniMax sağlayıcısının yapılandırılmadığı anlamına gelir (eşleşen bir sağlayıcı girdisi ve MiniMax kimlik doğrulama profili/ortam anahtarı bulunamadı). Çözüm için:

    • openclaw configure komutunu çalıştırıp bir MiniMax kimlik doğrulama seçeneği belirleyin 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 veya 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-M3, minimax/MiniMax-M2.7 veya minimax/MiniMax-M2.7-highspeed
    • OAuth yolu: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 veya minimax-portal/MiniMax-M2.7-highspeed

    Ardından şu komutla yeniden kontrol edin:

    bash
    openclaw models list

    İlgili içerikler

    Model seçimi

    Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.
    Görsel oluşturma

    Ortak görsel aracı parametreleri ve sağlayıcı seçimi.
    Müzik oluşturma

    Ortak müzik aracı parametreleri ve sağlayıcı seçimi.
    Video oluşturma

    Ortak video aracı parametreleri ve sağlayıcı seçimi.
    MiniMax Arama

    MiniMax Token Plan üzerinden web araması yapılandırması.
    Sorun giderme

    Genel sorun giderme ve SSS.
    Was this useful?
    On this page

    On this page