Перейти к основному содержанию
OpenClaw включает встроенный Plugin Mistral, который регистрирует четыре контракта: чат-завершения, понимание медиа (пакетная транскрипция Voxtral), realtime STT для Voice Call (Voxtral Realtime) и эмбеддинги памяти (mistral-embed).
СвойствоЗначение
ID провайдераmistral
Pluginвстроенный, enabledByDefault: true
Env var авторизацииMISTRAL_API_KEY
Флаг онбординга--auth-choice mistral-api-key
Прямой флаг CLI--mistral-api-key <key>
APIсовместимый с OpenAI (openai-completions)
Базовый URLhttps://api.mistral.ai/v1
Модель по умолчаниюmistral/mistral-large-latest
Модель эмбеддинговmistral-embed
Пакетный Voxtralvoxtral-mini-latest (транскрипция аудио)
Realtime Voxtralvoxtral-mini-transcribe-realtime-2602

​
Начало работы

1

Получите ключ API

Создайте ключ API в Mistral Console.
2

Запустите онбординг

openclaw onboard --auth-choice mistral-api-key
Или передайте ключ напрямую:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Задайте модель по умолчанию

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

Проверьте, что модель доступна

openclaw models list --provider mistral

​
Встроенный каталог LLM

Mistral Medium 3.5 — текущая смешанная модель Medium во встроенном каталоге: 128B плотных весов, ввод текста и изображений, контекст 256K, вызов функций, структурированный вывод, программирование и настраиваемое рассуждение через API Chat Completions. Используйте mistral/mistral-medium-3-5, когда вам нужна более новая унифицированная агентная/кодинговая модель Mistral вместо модели по умолчанию mistral/mistral-large-latest. Сейчас OpenClaw поставляет такой встроенный каталог Mistral:
Ссылка на модельВводКонтекстМакс. выводПримечания
mistral/mistral-large-latestтекст, изображение262,14416,384Модель по умолчанию
mistral/mistral-medium-2508текст, изображение262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5текст, изображение262,1448,192Mistral Medium 3.5; настраиваемое рассуждение
mistral/mistral-small-latestтекст, изображение128,00016,384Mistral Small 4; настраиваемое рассуждение через API reasoning_effort
mistral/pixtral-large-latestтекст, изображение128,00032,768Pixtral
mistral/codestral-latestтекст256,0004,096Программирование
mistral/devstral-medium-latestтекст262,14432,768Devstral 2
mistral/magistral-smallтекст128,00040,000С поддержкой рассуждения
После онбординга выполните smoke-тест Medium 3.5 без запуска Gateway: 
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json
Чтобы просмотреть строку встроенного каталога перед изменением конфигурации: 
openclaw models list --all --provider mistral --plain

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

Используйте Voxtral для пакетной транскрипции аудио через конвейер понимания медиа. 
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
Путь транскрипции медиа использует /v1/audio/transcriptions. Модель аудио по умолчанию для Mistral — voxtral-mini-latest.

​
Потоковый STT для Voice Call

Встроенный Plugin mistral регистрирует Voxtral Realtime как провайдера потокового STT для Voice Call.
НастройкаПуть конфигурацииПо умолчанию
Ключ APIplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyОткатывается к MISTRAL_API_KEY
Модель...mistral.modelvoxtral-mini-transcribe-realtime-2602
Кодирование...mistral.encodingpcm_mulaw
Частота дискретизации...mistral.sampleRate8000
Целевая задержка...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw по умолчанию задает realtime STT Mistral как pcm_mulaw при 8 кГц, чтобы Voice Call мог напрямую пересылать медиафреймы Twilio. Используйте encoding: "pcm_s16le" и соответствующий sampleRate только если ваш вышестоящий поток уже является raw PCM.

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

mistral/mistral-small-latest (Mistral Small 4) и mistral/mistral-medium-3-5 поддерживают настраиваемое рассуждение в API Chat Completions через reasoning_effort (none минимизирует дополнительные размышления в выводе; high показывает полные трассы рассуждения перед финальным ответом). Mistral рекомендует reasoning_effort="high" для агентных и кодовых сценариев Medium 3.5.OpenClaw сопоставляет уровень thinking сеанса с API Mistral:
Уровень thinking в OpenClawMistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Не сочетайте режим рассуждения Medium 3.5 с temperature: 0. HTTP API Mistral отклоняет reasoning_effort="high" плюс temperature: 0 ответом 400. Не задавайте temperature, чтобы Mistral использовал значение по умолчанию, или следуйте рекомендованным настройкам Medium 3.5 и используйте temperature: 0.7 для высокого уровня рассуждения. Для детерминированных прямых ответов выключите thinking или задайте minimal, чтобы OpenClaw отправлял reasoning_effort: "none" перед снижением temperature.
Пример конфигурации для Medium 3.5 reasoning на уровне модели:
{
  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).
{
  memorySearch: { provider: "mistral" },
}
  • Авторизация Mistral использует MISTRAL_API_KEY (заголовок Bearer).
  • Базовый URL провайдера по умолчанию — https://api.mistral.ai/v1; он принимает стандартную форму запроса chat-completions, совместимую с OpenAI.
  • Модель онбординга по умолчанию — mistral/mistral-large-latest.
  • Переопределяйте базовый URL в models.providers.mistral.baseUrl только когда Mistral явно публикует нужный вам региональный endpoint.

​
Связанные материалы

Выбор модели

Выбор провайдеров, ссылок на модели и поведения failover.

Понимание медиа

Настройка транскрипции аудио и выбор провайдера.