OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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.

  • Запустите первоначальную настройку

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

    Либо передайте ключ напрямую:

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

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

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

  • Убедитесь, что модель доступна

    bash
    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 С поддержкой рассуждений

    Перед изменением конфигурации просмотрите строку встроенного каталога:

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

    Быстро проверьте модель без запуска Gateway:

    bash
    openclaw infer model run --local \  --model mistral/mistral-medium-3-5 \  --prompt "Ответь в точности: mistral-ok" \  --json

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

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

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "mistral", model: "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
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

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

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

    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 для конкретной модели:

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    Векторные представления памяти

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

    json5
    {  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 явно публикует необходимую вам региональную конечную точку.

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

    Выбор модели

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

    Настройка транскрипции аудио и выбор провайдера.
    Was this useful?
    On this page

    On this page