Mistral

Вбудований плагін mistral реєструє чотири контракти: завершення чату, розпізнавання медіа (пакетна транскрипція Voxtral), STT у реальному часі для голосових викликів (Voxtral Realtime) і векторні представлення пам’яті (mistral-embed).

Властивість	Значення
Ідентифікатор провайдера	`mistral`
Плагін	вбудований, увімкнений за замовчуванням
Змінна середовища автентифікації	`MISTRAL_API_KEY`
Прапорець початкового налаштування	`--auth-choice mistral-api-key`
Прямий прапорець CLI	`--mistral-api-key <key>`
API	сумісний з OpenAI (`openai-completions`)
Базова URL-адреса	`https://api.mistral.ai/v1`
Модель за замовчуванням	`mistral/mistral-large-latest`
Модель векторних представлень	`mistral-embed`
Пакетний режим Voxtral	`voxtral-mini-latest` (транскрипція аудіо)
Voxtral у реальному часі	`voxtral-mini-transcribe-realtime-2602`

Початок роботи

Отримайте ключ API

Створіть ключ API в консолі Mistral.

Запустіть початкове налаштування

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

Або передайте ключ безпосередньо:

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

Установіть модель за замовчуванням

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

Перевірте доступність моделі

openclaw models list --provider mistral

Вбудований каталог LLM

Посилання на модель	Вхідні дані	Контекст	Максимальний вивід	Примітки
`mistral/mistral-large-latest`	текст, зображення	262,144	16,384	Модель за замовчуванням
`mistral/mistral-medium-2508`	текст, зображення	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	текст, зображення	262,144	8,192	Mistral Medium 3.5; регульоване міркування
`mistral/mistral-small-latest`	текст, зображення	262,144	16,384	Найновіша Mistral Small 4; регульований `reasoning_effort`
`mistral/mistral-small-2603`	текст, зображення	262,144	16,384	Зафіксована Mistral Small 4; регульований `reasoning_effort`
`mistral/pixtral-large-latest`	текст, зображення	128,000	32,768	Pixtral
`mistral/codestral-latest`	текст	256,000	4,096	Програмування
`mistral/devstral-medium-latest`	текст	262,144	32,768	Devstral 2
`mistral/magistral-small`	текст	128,000	40,000	З підтримкою міркування

Перегляньте рядок вбудованого каталогу, перш ніж змінювати конфігурацію:

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

Виконайте базову перевірку моделі без запуску Gateway:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

Транскрипція аудіо (Voxtral)

Використовуйте Voxtral для пакетної транскрипції аудіо через конвеєр розпізнавання медіа:

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

Шлях транскрипції медіа використовує /v1/audio/transcriptions. Модель аудіо за замовчуванням для Mistral — voxtral-mini-latest.

Потокове STT для голосових викликів

Вбудований плагін mistral реєструє Voxtral Realtime як провайдера потокового STT для голосових викликів.

Налаштування	Шлях конфігурації	Значення за замовчуванням
Ключ API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Використовує `MISTRAL_API_KEY` як резерв
Модель	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Кодування	`...mistral.encoding`	`pcm_mulaw`
Частота дискретизації	`...mistral.sampleRate`	`8000`
Цільова затримка	`...mistral.targetStreamingDelayMs`	`800`

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

За замовчуванням OpenClaw використовує для STT Mistral у реальному часі pcm_mulaw із частотою 8 кГц, щоб голосові виклики могли безпосередньо пересилати медіакадри Twilio. Використовуйте encoding: "pcm_s16le" і відповідне значення sampleRate, лише якщо ваш вхідний потік уже є необробленим PCM.

Розширена конфігурація

Регульоване міркування

mistral/mistral-small-latest, mistral/mistral-small-2603 і mistral/mistral-medium-3-5 підтримують регульоване міркування в API завершень чату через reasoning_effort (none мінімізує додаткові міркування у виводі; high показує повні ланцюжки міркувань перед остаточною відповіддю).OpenClaw зіставляє рівень міркування сеансу з API Mistral:

Рівень міркування OpenClaw	`reasoning_effort` Mistral
вимкнено / мінімальний	`none`
низький / середній / високий / дуже високий / адаптивний / максимальний	`high`

Не поєднуйте режим міркування Medium 3.5 із temperature: 0: за наявними повідомленнями, HTTP API Mistral відхиляє поєднання reasoning_effort="high" і temperature: 0 із відповіддю 400. Не задавайте температуру або вимкніть міркування чи встановіть мінімальний рівень, щоб OpenClaw надсилав reasoning_effort: "none", перш ніж задавати низьку температуру.

Приклад конфігурації міркування Medium 3.5 для конкретної моделі:

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

Інші моделі з вбудованого каталогу Mistral не використовують цей параметр. Продовжуйте використовувати моделі magistral-*, якщо вам потрібна нативна поведінка Mistral із пріоритетом міркування.

Векторні представлення пам’яті

Mistral може надавати векторні представлення пам’яті через /v1/embeddings (модель за замовчуванням: mistral-embed):

{
  agents: {
    defaults: {
      memorySearch: { provider: "mistral" },
    },
  },
}

Автентифікація та базова URL-адреса

Для автентифікації Mistral використовується MISTRAL_API_KEY (заголовок Bearer).
Базова URL-адреса провайдера за замовчуванням — https://api.mistral.ai/v1; вона приймає стандартну, сумісну з OpenAI структуру запиту завершень чату.
Модель за замовчуванням під час початкового налаштування — mistral/mistral-large-latest.
Перевизначайте базову URL-адресу в models.providers.mistral.baseUrl, лише якщо Mistral явно публікує потрібну вам регіональну кінцеву точку.

Пов’язані матеріали

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки перемикання після відмови.

Розпізнавання медіа

Налаштування транскрипції аудіо та вибір провайдера.

Overview

Concepts and configuration

Providers

Початок роботи

Вбудований каталог LLM

Транскрипція аудіо (Voxtral)

Потокове STT для голосових викликів

Розширена конфігурація

Пов’язані матеріали

Вибір моделі

Розпізнавання медіа

​Початок роботи

​Вбудований каталог LLM

​Транскрипція аудіо (Voxtral)

​Потокове STT для голосових викликів

​Розширена конфігурація

​Пов’язані матеріали

Вибір моделі

Розпізнавання медіа

Початок роботи

Вбудований каталог LLM

Транскрипція аудіо (Voxtral)

Потокове STT для голосових викликів

Розширена конфігурація

Пов’язані матеріали