OpenClawDocs
Nesta página

Nesta página

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

Providers

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

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

    Ou forneça a chave diretamente:

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

  • Defina um modelo padrão

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

  • Verifique se o modelo está disponível

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

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

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

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

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

    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

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

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    Embeddings de memória

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

    json5
    {  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ê.

    Relacionados

    Seleção de modelos

    Escolha de provedores, referências de modelos e comportamento de failover.
    Compreensão de mídia

    Configuração da transcrição de áudio e seleção de provedores.
    Was this useful?