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), 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.

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

    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 "Reply with exactly: mistral-ok" \  --json

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

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

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "mistral", model: "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
    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 завершень чату через reasoning_effort (none мінімізує додаткові міркування у виводі; high показує повні ланцюжки міркувань перед остаточною відповіддю).

    OpenClaw зіставляє рівень міркування сеансу з API Mistral:

    Рівень міркування OpenClaw reasoning_effort Mistral
    вимкнено / мінімальний none
    низький / середній / високий / дуже високий / адаптивний / максимальний 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