Mistral

O Plugin mistral incluído registra quatro contratos: conclusões de chat, compreensão de mídia (transcrição em lote do Voxtral), STT em tempo real para Voice Call (Voxtral Realtime) e embeddings de memória (mistral-embed).

Propriedade	Valor
ID do provedor	`mistral`
Plugin	incluído, habilitado por padrão
Var. de ambiente de autenticação	`MISTRAL_API_KEY`
Flag de integração inicial	`--auth-choice mistral-api-key`
Flag direta da CLI	`--mistral-api-key <key>`
API	compatível com OpenAI (`openai-completions`)
URL base	`https://api.mistral.ai/v1`
Modelo padrão	`mistral/mistral-large-latest`
Modelo de embedding	`mistral-embed`
Voxtral em lote	`voxtral-mini-latest` (transcrição de áudio)
Voxtral em tempo real	`voxtral-mini-transcribe-realtime-2602`

Primeiros passos

Obtenha sua chave de API

Crie uma chave de API no Console da Mistral.

Execute a integração inicial

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

Ou forneça a chave diretamente:

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

Defina um modelo padrão

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

Verifique se o modelo está disponível

openclaw models list --provider mistral

Catálogo de LLMs integrado

Referência do modelo	Entrada	Contexto	Saída máxima	Observações
`mistral/mistral-large-latest`	texto, imagem	262,144	16,384	Modelo padrão
`mistral/mistral-medium-2508`	texto, imagem	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	texto, imagem	262,144	8,192	Mistral Medium 3.5; raciocínio ajustável
`mistral/mistral-small-latest`	texto, imagem	262,144	16,384	Versão mais recente do Mistral Small 4; `reasoning_effort` ajustável
`mistral/mistral-small-2603`	texto, imagem	262,144	16,384	Versão fixada do Mistral Small 4; `reasoning_effort` ajustável
`mistral/pixtral-large-latest`	texto, imagem	128,000	32,768	Pixtral
`mistral/codestral-latest`	texto	256,000	4,096	Programação
`mistral/devstral-medium-latest`	texto	262,144	32,768	Devstral 2
`mistral/magistral-small`	texto	128,000	40,000	Raciocínio habilitado

Consulte a linha correspondente no catálogo incluído antes de alterar a configuração:

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

Faça um teste rápido de um modelo sem iniciar o Gateway:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

Transcrição de áudio (Voxtral)

Use o Voxtral para transcrição de áudio em lote por meio do pipeline de compreensão de mídia:

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

O caminho de transcrição de mídia usa /v1/audio/transcriptions. O modelo de áudio padrão da Mistral é voxtral-mini-latest.

STT de streaming do Voice Call

O Plugin mistral incluído registra o Voxtral Realtime como provedor de STT de streaming do Voice Call.

Configuração	Caminho da configuração	Padrão
Chave de API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Usa `MISTRAL_API_KEY` como alternativa
Modelo	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Codificação	`...mistral.encoding`	`pcm_mulaw`
Taxa de amostragem	`...mistral.sampleRate`	`8000`
Atraso desejado	`...mistral.targetStreamingDelayMs`	`800`

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

Por padrão, o OpenClaw configura o STT em tempo real da Mistral como pcm_mulaw a 8 kHz, para que o Voice Call possa encaminhar diretamente os quadros de mídia da Twilio. Use encoding: "pcm_s16le" e um sampleRate correspondente somente se o fluxo de origem já estiver em PCM bruto.

Configuração avançada

Raciocínio ajustável

mistral/mistral-small-latest, mistral/mistral-small-2603 e mistral/mistral-medium-3-5 oferecem suporte a raciocínio ajustável na API de conclusões de chat por meio de reasoning_effort (none minimiza o processamento adicional na saída; high expõe os rastros completos de raciocínio antes da resposta final).O OpenClaw mapeia o nível de raciocínio da sessão para a API da Mistral:

Nível de raciocínio do OpenClaw	`reasoning_effort` da Mistral
desativado / mínimo	`none`
baixo / médio / alto / xhigh / adaptativo / máximo	`high`

Evite combinar o modo de raciocínio do Medium 3.5 com temperature: 0; há relatos de que a API HTTP da Mistral rejeita reasoning_effort="high" em conjunto com temperature: 0, retornando uma resposta 400. Não defina a temperatura ou desative/minimize o raciocínio para que o OpenClaw envie reasoning_effort: "none" antes de definir uma temperatura baixa.

Exemplo de configuração de raciocínio específica do modelo Medium 3.5:

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

Outros modelos incluídos no catálogo da Mistral não usam esse parâmetro. Continue usando modelos magistral-* quando quiser o comportamento nativo da Mistral que prioriza o raciocínio.

Embeddings de memória

A Mistral pode fornecer embeddings de memória por meio de /v1/embeddings (modelo padrão: mistral-embed):

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

Autenticação e URL base

A autenticação da Mistral usa MISTRAL_API_KEY (cabeçalho Bearer).
A URL base do provedor é https://api.mistral.ai/v1 por padrão e aceita o formato padrão de solicitação de conclusões de chat compatível com OpenAI.
O modelo padrão da integração inicial é mistral/mistral-large-latest.
Substitua a URL base em models.providers.mistral.baseUrl somente quando a Mistral publicar explicitamente um endpoint regional necessário para você.

Overview

Concepts and configuration

Providers

Primeiros passos

Catálogo de LLMs integrado

Transcrição de áudio (Voxtral)

STT de streaming do Voice Call

Configuração avançada

Relacionados

Seleção de modelos

Compreensão de mídia

​Primeiros passos

​Catálogo de LLMs integrado

​Transcrição de áudio (Voxtral)

​STT de streaming do Voice Call

​Configuração avançada

​Relacionados

Seleção de modelos

Compreensão de mídia

Primeiros passos

Catálogo de LLMs integrado

Transcrição de áudio (Voxtral)

STT de streaming do Voice Call

Configuração avançada

Relacionados