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

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

También puede proporcionar la clave directamente:

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

Establecer un modelo predeterminado

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

Verificar que el modelo esté disponible

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:

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

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

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:

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

La ruta de transcripción multimedia utiliza /v1/audio/transcriptions. El modelo de audio predeterminado para Mistral es 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`

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

OpenClaw establece de forma predeterminada el STT en tiempo real de Mistral en pcm_mulaw a 8 kHz para que Voice Call pueda reenviar directamente las tramas multimedia de Twilio. Use encoding: "pcm_s16le" y un valor de sampleRate correspondiente solo si el flujo ascendente ya es PCM sin procesar.

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`

Evite combinar el modo de razonamiento de Medium 3.5 con temperature: 0; se ha informado que la API HTTP de Mistral rechaza reasoning_effort="high" junto con temperature: 0 con una respuesta 400. No establezca la temperatura, o desactive el razonamiento o configúrelo como mínimo para que OpenClaw envíe reasoning_effort: "none" antes de establecer una temperatura baja.

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

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

Los demás modelos del catálogo integrado de Mistral no utilizan este parámetro. Siga usando modelos magistral-* cuando desee el comportamiento nativo de Mistral que prioriza el razonamiento.

Incrustaciones de memoria

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

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

Overview

Concepts and configuration

Providers

Primeros pasos

Catálogo de LLM integrado

Transcripción de audio (Voxtral)

STT de transmisión para Voice Call

Configuración avanzada

Contenido relacionado

Selección de modelos

Comprensión multimedia

​Primeros pasos

​Catálogo de LLM integrado

​Transcripción de audio (Voxtral)

​STT de transmisión para Voice Call

​Configuración avanzada

​Contenido relacionado

Selección de modelos

Comprensión multimedia

Primeros pasos

Catálogo de LLM integrado

Transcripción de audio (Voxtral)

STT de transmisión para Voice Call

Configuración avanzada

Contenido relacionado