English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

Mistral

OpenClaw incluye un Plugin de Mistral incluido que registra cuatro contratos: completaciones 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).

Propiedad Valor
ID del proveedor mistral
Plugin incluido, enabledByDefault: true
Variable de entorno de autenticación MISTRAL_API_KEY
Marca de incorporación --auth-choice mistral-api-key
Marca directa de 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
Lote de Voxtral voxtral-mini-latest (transcripción de audio)
Voxtral en tiempo real voxtral-mini-transcribe-realtime-2602

Primeros pasos

  • Obtén tu clave de API

    Crea una clave de API en la consola de Mistral.

  • Ejecuta la incorporación

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

    O pasa la clave directamente:

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

  • Configura un modelo predeterminado

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

  • Verifica que el modelo esté disponible

    openclaw models list --provider mistral

    • Catálogo de LLM integrado

    OpenClaw actualmente distribuye este catálogo de Mistral incluido:

    Ref. de 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-small-latest texto, imagen 128,000 16,384 Mistral Small 4; razonamiento ajustable mediante la API reasoning_effort
    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 Con razonamiento habilitado

    Transcripción de audio (Voxtral)

    Usa Voxtral para la transcripción de audio por lotes a través de la canalización de comprensión de medios.

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

    STT en streaming para Voice Call

    El Plugin mistral incluido registra Voxtral Realtime como proveedor de STT en streaming para Voice Call.

    Configuración Ruta de configuración Predeterminado
    Clave de API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Recurre a MISTRAL_API_KEY
    Modelo ...mistral.model voxtral-mini-transcribe-realtime-2602
    Codificación ...mistral.encoding pcm_mulaw
    Frecuencia de muestreo ...mistral.sampleRate 8000
    Retraso objetivo ...mistral.targetStreamingDelayMs 800 
    {
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

    Configuración avanzada

    Razonamiento ajustable (mistral-small-latest)

    mistral/mistral-small-latest se asigna a Mistral Small 4 y admite 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 OpenClaw reasoning_effort de Mistral
    off / minimal none
    low / medium / high / xhigh / adaptive / max high
    Incrustaciones de memoria

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

    {
  memorySearch: { provider: "mistral" },
}
    Autenticación y URL base
    • 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 de solicitud estándar de completaciones 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

    Elección de 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.