Saltar al contenido principal
El Plugin incluido mistral registra cuatro contratos: finalizaciones de chat, comprensión de medios (transcripción por lotes de Voxtral), STT en tiempo real para Voice Call (Voxtral Realtime) e incrustaciones de memoria (mistral-embed).
PropiedadValor
ID del proveedormistral
Pluginincluido, habilitado de forma predeterminada
Variable de entorno de autenticaciónMISTRAL_API_KEY
Marca de incorporación--auth-choice mistral-api-key
Marca directa de CLI--mistral-api-key <key>
APIcompatible con OpenAI (openai-completions)
URL basehttps://api.mistral.ai/v1
Modelo predeterminadomistral/mistral-large-latest
Modelo de incrustacionesmistral-embed
Lote de Voxtralvoxtral-mini-latest (transcripción de audio)
Voxtral en tiempo realvoxtral-mini-transcribe-realtime-2602

​
Primeros pasos

1

Obtén tu clave de API

Crea una clave de API en la consola de Mistral.
2

Ejecuta la incorporación

openclaw onboard --auth-choice mistral-api-key
O pasa la clave directamente:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Define un modelo predeterminado

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

Verifica que el modelo esté disponible

openclaw models list --provider mistral

​
Catálogo de LLM integrado

Referencia de modeloEntradaContextoSalida máximaNotas
mistral/mistral-large-latesttexto, imagen262,14416,384Modelo predeterminado
mistral/mistral-medium-2508texto, imagen262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5texto, imagen262,1448,192Mistral Medium 3.5; razonamiento ajustable
mistral/mistral-small-latesttexto, imagen128,00016,384Mistral Small 4; razonamiento ajustable mediante la API reasoning_effort
mistral/pixtral-large-latesttexto, imagen128,00032,768Pixtral
mistral/codestral-latesttexto256,0004,096Programación
mistral/devstral-medium-latesttexto262,14432,768Devstral 2
mistral/magistral-smalltexto128,00040,000Con razonamiento habilitado
Explora la fila del catálogo incluido antes de cambiar la configuración: 
openclaw models list --all --provider mistral --plain
Haz una prueba rápida de un modelo sin iniciar el Gateway: 
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

​
Transcripción de audio (Voxtral)

Usa Voxtral para la transcripción de audio por lotes mediante la canalización de comprensión de medios: 
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
La ruta de transcripción de medios usa /v1/audio/transcriptions. El modelo de audio predeterminado para Mistral es voxtral-mini-latest.

​
STT de streaming para Voice Call

El Plugin incluido mistral registra Voxtral Realtime como proveedor de STT de streaming para Voice Call.
ConfiguraciónRuta de configuraciónPredeterminado
Clave de APIplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyRecurre a MISTRAL_API_KEY
Modelo...mistral.modelvoxtral-mini-transcribe-realtime-2602
Codificación...mistral.encodingpcm_mulaw
Frecuencia de muestreo...mistral.sampleRate8000
Retraso objetivo...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw establece de forma predeterminada STT en tiempo real de Mistral en pcm_mulaw a 8 kHz para que Voice Call pueda reenviar directamente tramas multimedia de Twilio. Usa encoding: "pcm_s16le" y un sampleRate coincidente solo si tu flujo ascendente ya es PCM sin procesar.

​
Configuración avanzada

mistral/mistral-small-latest y mistral/mistral-medium-3-5 admiten razonamiento ajustable en la API Chat Completions mediante reasoning_effort (none minimiza el pensamiento adicional en la salida; high muestra trazas completas de pensamiento antes de la respuesta final).OpenClaw asigna el nivel de pensamiento de la sesión a la API de Mistral:
Nivel de pensamiento de OpenClawreasoning_effort de Mistral
desactivado / mínimonone
bajo / medio / alto / xhigh / adaptive / maxhigh
Evita combinar el modo de razonamiento Medium 3.5 con temperature: 0; se ha informado que la API HTTP de Mistral rechaza reasoning_effort="high" más temperature: 0 con una respuesta 400. Deja la temperatura sin definir, o desactiva/reduce al mínimo el pensamiento para que OpenClaw envíe reasoning_effort: "none" antes de establecer una temperatura baja.
Ejemplo de configuración con alcance de 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" },
        },
      },
    },
  },
}
Otros modelos incluidos en el catálogo de Mistral no usan este parámetro. Sigue usando los modelos magistral-* cuando quieras el comportamiento nativo de Mistral centrado primero en el razonamiento.
Mistral puede servir incrustaciones de memoria mediante /v1/embeddings (modelo predeterminado: mistral-embed):
{
  agents: {
    defaults: {
      memorySearch: { provider: "mistral" },
    },
  },
}
  • La autenticación de Mistral usa MISTRAL_API_KEY (encabezado Bearer).
  • La URL base del proveedor usa de forma predeterminada https://api.mistral.ai/v1 y acepta la forma estándar de solicitud de finalizaciones de chat compatible con OpenAI.
  • El modelo predeterminado de incorporación es mistral/mistral-large-latest.
  • Sobrescribe la URL base en models.providers.mistral.baseUrl solo cuando Mistral publique explícitamente un endpoint regional que necesites.

​
Relacionado

Selección de modelos

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

Comprensión de medios

Configuración de transcripción de audio y selección de proveedor.