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

Providers

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

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

    In alternativa, passa direttamente la chiave:

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

  • Imposta un modello predefinito

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

  • Verifica che il modello sia disponibile

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

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

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

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

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "mistral", model: "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
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    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

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

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

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

    json5
    {  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.
    Was this useful?
    On this page

    On this page