Mistral

Il Plugin mistral incluso registra quattro contratti: completamenti chat, comprensione dei contenuti multimediali (trascrizione batch con Voxtral), STT in tempo reale per le chiamate vocali (Voxtral Realtime) ed embedding della memoria (mistral-embed).

Proprietà	Valore
ID del provider	`mistral`
Plugin	incluso, abilitato per impostazione predefinita
Variabile di ambiente per l’autenticazione	`MISTRAL_API_KEY`
Flag di configurazione iniziale	`--auth-choice mistral-api-key`
Flag CLI diretto	`--mistral-api-key <key>`
API	compatibile con OpenAI (`openai-completions`)
URL di base	`https://api.mistral.ai/v1`
Modello predefinito	`mistral/mistral-large-latest`
Modello di embedding	`mistral-embed`
Voxtral batch	`voxtral-mini-latest` (trascrizione audio)
Voxtral in tempo reale	`voxtral-mini-transcribe-realtime-2602`

Per iniziare

Ottieni la tua chiave API

Crea una chiave API nella console Mistral.

Esegui la configurazione iniziale

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

In alternativa, passa direttamente la chiave:

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

Imposta un modello predefinito

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

Verifica che il modello sia disponibile

openclaw models list --provider mistral

Catalogo LLM integrato

Riferimento del 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-medium-3-5`	testo, immagine	262,144	8,192	Mistral Medium 3.5; ragionamento regolabile
`mistral/mistral-small-latest`	testo, immagine	262,144	16,384	Versione più recente di Mistral Small 4; `reasoning_effort` regolabile
`mistral/mistral-small-2603`	testo, immagine	262,144	16,384	Versione bloccata di Mistral Small 4; `reasoning_effort` regolabile
`mistral/pixtral-large-latest`	testo, immagine	128,000	32,768	Pixtral
`mistral/codestral-latest`	testo	256,000	4,096	Programmazione
`mistral/devstral-medium-latest`	testo	262,144	32,768	Devstral 2
`mistral/magistral-small`	testo	128,000	40,000	Ragionamento abilitato

Consulta la voce del catalogo incluso prima di modificare la configurazione:

openclaw models list --all --provider mistral --plain

Esegui una prova rapida di un modello senza avviare il Gateway:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Rispondi esattamente con: mistral-ok" \
  --json

Trascrizione audio (Voxtral)

Usa Voxtral per la trascrizione batch dell’audio tramite la pipeline di comprensione dei contenuti multimediali:

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

Il percorso di trascrizione dei contenuti multimediali usa /v1/audio/transcriptions. Il modello audio predefinito per Mistral è voxtral-mini-latest.

STT in streaming per le chiamate vocali

Il Plugin mistral incluso registra Voxtral Realtime come provider STT in streaming per le chiamate vocali.

Impostazione	Percorso di configurazione	Valore predefinito
Chiave API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Ripiega su `MISTRAL_API_KEY`
Modello	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Codifica	`...mistral.encoding`	`pcm_mulaw`
Frequenza di campionamento	`...mistral.sampleRate`	`8000`
Ritardo di destinazione	`...mistral.targetStreamingDelayMs`	`800`

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

Per impostazione predefinita, OpenClaw configura lo STT in tempo reale di Mistral su pcm_mulaw a 8 kHz, così le chiamate vocali possono inoltrare direttamente i frame multimediali di Twilio. Usa encoding: "pcm_s16le" e un valore sampleRate corrispondente solo se il flusso a monte è già in formato PCM non elaborato.

Configurazione avanzata

Ragionamento regolabile

mistral/mistral-small-latest, mistral/mistral-small-2603 e mistral/mistral-medium-3-5 supportano il ragionamento regolabile nell’API Chat Completions tramite reasoning_effort (none riduce al minimo il ragionamento aggiuntivo nell’output; high mostra le tracce complete del ragionamento prima della risposta finale).OpenClaw associa il livello di ragionamento della sessione all’API di Mistral:

Livello di ragionamento di OpenClaw	`reasoning_effort` di Mistral
disattivato / minimo	`none`
basso / medio / alto / molto alto / adattivo / massimo	`high`

Evita di combinare la modalità di ragionamento di Medium 3.5 con temperature: 0; è stato segnalato che l’API HTTP di Mistral rifiuta reasoning_effort="high" insieme a temperature: 0 con una risposta 400. Non impostare la temperatura oppure disattiva il ragionamento o impostalo al minimo, affinché OpenClaw invii reasoning_effort: "none" prima di impostare una temperatura bassa.

Esempio di configurazione specifica per il modello per il ragionamento di Medium 3.5:

{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

Gli altri modelli del catalogo Mistral incluso non usano questo parametro. Continua a usare i modelli magistral-* quando desideri il comportamento nativo di Mistral incentrato innanzitutto sul ragionamento.

Embedding della memoria

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

{
  agents: {
    defaults: {
      memorySearch: { provider: "mistral" },
    },
  },
}

Autenticazione e URL di base

L’autenticazione di Mistral usa MISTRAL_API_KEY (intestazione Bearer).
L’URL di base del provider è https://api.mistral.ai/v1 per impostazione predefinita e accetta il formato standard delle richieste di completamento chat compatibile con OpenAI.
Il modello predefinito della configurazione iniziale è mistral/mistral-large-latest.
Sovrascrivi l’URL di base in models.providers.mistral.baseUrl solo quando Mistral pubblica esplicitamente un endpoint regionale di cui hai bisogno.

Contenuti correlati

Selezione del modello

Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.

Comprensione dei contenuti multimediali

Configurazione della trascrizione audio e selezione del provider.

Overview

Concepts and configuration

Providers

Per iniziare

Catalogo LLM integrato

Trascrizione audio (Voxtral)

STT in streaming per le chiamate vocali

Configurazione avanzata

Contenuti correlati

Selezione del modello

Comprensione dei contenuti multimediali

​Per iniziare

​Catalogo LLM integrato

​Trascrizione audio (Voxtral)

​STT in streaming per le chiamate vocali

​Configurazione avanzata

​Contenuti correlati

Selezione del modello

Comprensione dei contenuti multimediali

Per iniziare

Catalogo LLM integrato

Trascrizione audio (Voxtral)

STT in streaming per le chiamate vocali

Configurazione avanzata

Contenuti correlati