English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

Mistral

OpenClaw include un Plugin Mistral integrato che registra quattro contratti: completamenti chat, comprensione dei media (trascrizione batch Voxtral), STT realtime per Voice Call (Voxtral Realtime) ed embedding di memoria (mistral-embed).

Proprietà Valore
ID provider mistral
Plugin integrato, enabledByDefault: true
Variabile env di autenticazione MISTRAL_API_KEY
Flag di onboarding --auth-choice mistral-api-key
Flag CLI diretto --mistral-api-key <key>
API compatibile con OpenAI (openai-completions)
URL base https://api.mistral.ai/v1
Modello predefinito mistral/mistral-large-latest
Modello di embedding mistral-embed
Batch Voxtral voxtral-mini-latest (trascrizione audio)
Realtime Voxtral voxtral-mini-transcribe-realtime-2602

Per iniziare

  • Get your API key

    Crea una chiave API nella Console Mistral.

  • Run onboarding

    openclaw onboard --auth-choice mistral-api-key

    Oppure passa direttamente la chiave:

    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

  • Set a default model

    {
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}

  • Verify the model is available

    openclaw models list --provider mistral

    • Catalogo LLM integrato

    OpenClaw attualmente distribuisce questo catalogo Mistral integrato:

    Riferimento modello Input Contesto Output massimo Note
    mistral/mistral-large-latest testo, immagine 262,144 16,384 Modello predefinito
    mistral/mistral-medium-2508 testo, immagine 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-small-latest testo, immagine 128,000 16,384 Mistral Small 4; ragionamento regolabile tramite API reasoning_effort
    mistral/pixtral-large-latest testo, immagine 128,000 32,768 Pixtral
    mistral/codestral-latest testo 256,000 4,096 Coding
    mistral/devstral-medium-latest testo 262,144 32,768 Devstral 2
    mistral/magistral-small testo 128,000 40,000 Con ragionamento abilitato

    Trascrizione audio (Voxtral)

    Usa Voxtral per la trascrizione audio batch tramite la pipeline di comprensione dei media.

    {
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}

    STT in streaming per Voice Call

    Il Plugin mistral integrato registra Voxtral Realtime come provider STT in streaming per Voice Call.

    Impostazione Percorso di configurazione Predefinito
    Chiave API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Ricade su MISTRAL_API_KEY
    Modello ...mistral.model voxtral-mini-transcribe-realtime-2602
    Codifica ...mistral.encoding pcm_mulaw
    Frequenza di campionamento ...mistral.sampleRate 8000
    Ritardo target ...mistral.targetStreamingDelayMs 800 
    {
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

    Configurazione avanzata

    Adjustable reasoning (mistral-small-latest)

    mistral/mistral-small-latest corrisponde a Mistral Small 4 e supporta il ragionamento regolabile nell'API Chat Completions tramite reasoning_effort (none riduce al minimo il pensiero extra nell'output; high espone le tracce complete di pensiero prima della risposta finale).

    OpenClaw mappa il livello di pensiero della sessione all'API di Mistral:

    Livello di pensiero OpenClaw reasoning_effort Mistral
    off / minimal none
    low / medium / high / xhigh / adaptive / max high
    Memory embeddings

    Mistral può fornire embedding di memoria tramite /v1/embeddings (modello predefinito: mistral-embed).

    {
  memorySearch: { provider: "mistral" },
}
    Auth and base URL
    • L'autenticazione Mistral usa MISTRAL_API_KEY (header Bearer).
    • L'URL base del provider predefinito è https://api.mistral.ai/v1 e accetta la forma di richiesta chat-completions standard compatibile con OpenAI.
    • Il modello predefinito di onboarding è mistral/mistral-large-latest.
    • Sovrascrivi l'URL base in models.providers.mistral.baseUrl solo quando Mistral pubblica esplicitamente un endpoint regionale di cui hai bisogno.

    Correlati

    Model selection

    Scelta dei provider, riferimenti dei modelli e comportamento di failover.
    Media understanding

    Configurazione della trascrizione audio e selezione del provider.