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

Providers

Mistral

El plugin mistral incluido registra cuatro contratos: finalizaciones de chat, comprensión multimedia (transcripción por lotes de Voxtral), STT en tiempo real para Voice Call (Voxtral Realtime) e incrustaciones de memoria (mistral-embed).

Propiedad Valor
Id. del proveedor mistral
Plugin incluido, habilitado de forma predeterminada
Variable de entorno de autenticación MISTRAL_API_KEY
Opción de incorporación --auth-choice mistral-api-key
Opción directa de la CLI --mistral-api-key <key>
API compatible con OpenAI (openai-completions)
URL base https://api.mistral.ai/v1
Modelo predeterminado mistral/mistral-large-latest
Modelo de incrustaciones mistral-embed
Voxtral por lotes voxtral-mini-latest (transcripción de audio)
Voxtral en tiempo real voxtral-mini-transcribe-realtime-2602

Primeros pasos

  • Obtener la clave de API

    Cree una clave de API en la consola de Mistral.

  • Ejecutar la incorporación

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

    También puede proporcionar la clave directamente:

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

  • Establecer un modelo predeterminado

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

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider mistral

    • Catálogo de LLM integrado

    Referencia del modelo Entrada Contexto Salida máxima Notas
    mistral/mistral-large-latest texto, imagen 262,144 16,384 Modelo predeterminado
    mistral/mistral-medium-2508 texto, imagen 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-medium-3-5 texto, imagen 262,144 8,192 Mistral Medium 3.5; razonamiento ajustable
    mistral/mistral-small-latest texto, imagen 262,144 16,384 Versión más reciente de Mistral Small 4; reasoning_effort ajustable
    mistral/mistral-small-2603 texto, imagen 262,144 16,384 Versión fijada de Mistral Small 4; reasoning_effort ajustable
    mistral/pixtral-large-latest texto, imagen 128,000 32,768 Pixtral
    mistral/codestral-latest texto 256,000 4,096 Programación
    mistral/devstral-medium-latest texto 262,144 32,768 Devstral 2
    mistral/magistral-small texto 128,000 40,000 Razonamiento habilitado

    Consulte la fila del catálogo integrado antes de cambiar la configuración:

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

    Realice una prueba rápida de un modelo sin iniciar el Gateway:

    bash
    openclaw infer model run --local \  --model mistral/mistral-medium-3-5 \  --prompt "Responde exactamente con: mistral-ok" \  --json

    Transcripción de audio (Voxtral)

    Use Voxtral para la transcripción de audio por lotes mediante el Pipeline de comprensión multimedia:

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

    STT de transmisión para Voice Call

    El plugin mistral incluido registra Voxtral Realtime como proveedor de STT de transmisión para Voice Call.

    Ajuste Ruta de configuración Valor predeterminado
    Clave de API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Utiliza MISTRAL_API_KEY como alternativa
    Modelo ...mistral.model voxtral-mini-transcribe-realtime-2602
    Codificación ...mistral.encoding pcm_mulaw
    Frecuencia de muestreo ...mistral.sampleRate 8000
    Retardo objetivo ...mistral.targetStreamingDelayMs 800
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    Configuración avanzada

    Razonamiento ajustable

    mistral/mistral-small-latest, mistral/mistral-small-2603 y mistral/mistral-medium-3-5 admiten razonamiento ajustable en la API de finalizaciones de chat mediante reasoning_effort (none minimiza el razonamiento adicional en la salida; high muestra las trazas completas de razonamiento antes de la respuesta final).

    OpenClaw asigna el nivel de razonamiento de la sesión a la API de Mistral:

    Nivel de razonamiento de OpenClaw reasoning_effort de Mistral
    desactivado / mínimo none
    bajo / medio / alto / muy alto / adaptativo / máximo high

    Ejemplo de configuración específica del modelo para el razonamiento de Medium 3.5:

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

    Mistral puede proporcionar incrustaciones de memoria mediante /v1/embeddings (modelo predeterminado: mistral-embed):

    json5
    {  memory: {    search: { provider: "mistral" },  },}
    Autenticación y URL base
    • La autenticación de Mistral utiliza MISTRAL_API_KEY (encabezado Bearer).
    • La URL base del proveedor es de forma predeterminada https://api.mistral.ai/v1 y acepta el formato de solicitud estándar de finalizaciones de chat compatible con OpenAI.
    • El modelo predeterminado de incorporación es mistral/mistral-large-latest.
    • Sobrescriba la URL base en models.providers.mistral.baseUrl solo cuando Mistral publique explícitamente un punto de conexión regional que necesite.

    Contenido relacionado

    Selección de modelos

    Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.
    Comprensión multimedia

    Configuración de la transcripción de audio y selección de proveedores.
    Was this useful?
    On this page

    On this page