Mistral

Встроенный плагин mistral регистрирует четыре контракта: завершения чата, анализ мультимедиа (пакетная транскрипция Voxtral), распознавание речи в реальном времени для Voice Call (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 "Ответь в точности: mistral-ok" \
  --json

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

Используйте Voxtral для пакетной транскрипции аудио через конвейер анализа мультимедиа:

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

Путь транскрипции мультимедиа использует /v1/audio/transcriptions. Модель аудио по умолчанию для Mistral — voxtral-mini-latest.

Потоковое распознавание речи для Voice Call

Встроенный плагин mistral регистрирует Voxtral Realtime как провайдера потокового распознавания речи для Voice Call.

Параметр	Путь конфигурации	Значение по умолчанию
Ключ 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 использует для распознавания речи Mistral в реальном времени pcm_mulaw с частотой 8 кГц, чтобы Voice Call мог напрямую передавать мультимедийные кадры Twilio. Используйте encoding: "pcm_s16le" и соответствующее значение sampleRate, только если входящий поток уже представляет собой необработанные данные PCM.

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

Настраиваемое рассуждение

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

Уровень рассуждения OpenClaw	Mistral `reasoning_effort`
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`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 не используют этот параметр. Если требуется встроенное поведение Mistral с приоритетом рассуждения, продолжайте использовать модели magistral-*.

Векторные представления памяти

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)

Потоковое распознавание речи для Voice Call

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

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

Выбор модели

Анализ мультимедиа

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

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

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

​Потоковое распознавание речи для Voice Call

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

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

Выбор модели

Анализ мультимедиа

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

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

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

Потоковое распознавание речи для Voice Call

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

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