> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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` |

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

**1. Получите ключ API**

Создайте ключ API в [консоли Mistral](https://console.mistral.ai/).

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice mistral-api-key
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
```

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --all --provider mistral --plain
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Ответь в точности: mistral-ok" \
  --json
```

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

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
```

> [!TIP]
>
> Путь транскрипции мультимедиа использует `/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` |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
```

> [!NOTE]
>
> По умолчанию OpenClaw использует для распознавания речи Mistral в реальном времени `pcm_mulaw` с частотой 8 кГц, чтобы Voice Call мог напрямую передавать мультимедийные кадры Twilio. Используйте `encoding: "pcm_s16le"` и соответствующее значение `sampleRate`, только если входящий поток уже представляет собой необработанные данные PCM.

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

> [accordion] Настраиваемое рассуждение
>
> `mistral/mistral-small-latest`, `mistral/mistral-small-2603` и `mistral/mistral-medium-3-5` поддерживают [настраиваемое рассуждение](https://docs.mistral.ai/studio-api/conversations/reasoning/adjustable) в API Chat Completions через `reasoning_effort` (`none` сводит к минимуму дополнительные рассуждения в выводе; `high` показывает полную трассировку рассуждений перед окончательным ответом).
>
> OpenClaw сопоставляет уровень **рассуждения** сеанса с API Mistral:
>
> | Уровень рассуждения OpenClaw | Mistral `reasoning_effort` |
> | - | - |
> | **off** / **minimal** | `none` |
> | **low** / **medium** / **high** / **xhigh** / **adaptive** / **max** | `high` |
>
> > [!WARNING]
> >
> > Не сочетайте режим рассуждения Medium 3.5 с `temperature: 0`: согласно сообщениям, HTTP API Mistral отклоняет сочетание `reasoning_effort="high"` и `temperature: 0` с ответом 400. Не задавайте температуру либо отключите рассуждение или установите минимальный уровень, чтобы OpenClaw отправлял `reasoning_effort: "none"`, прежде чем задавать низкую температуру.
>
> Пример конфигурации рассуждения Medium 3.5 для конкретной модели:
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "mistral/mistral-medium-3-5" },
>       models: {
>         "mistral/mistral-medium-3-5": {
>           params: { thinking: "high" },
>         },
>       },
>     },
>   },
> }
> ```
>
> > [!NOTE]
> >
> > Другие модели встроенного каталога Mistral не используют этот параметр. Если требуется встроенное поведение Mistral с приоритетом рассуждения, продолжайте использовать модели `magistral-*`.

> [accordion] Векторные представления памяти
>
> Mistral может предоставлять векторные представления памяти через `/v1/embeddings` (модель по умолчанию: `mistral-embed`):
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       memorySearch: { provider: "mistral" },
>     },
>   },
> }
> ```

> [accordion] Аутентификация и базовый URL
>
> * Для аутентификации Mistral используется `MISTRAL_API_KEY` (заголовок Bearer).
> * Базовый URL провайдера по умолчанию — `https://api.mistral.ai/v1`; он принимает стандартный формат запросов завершения чата, совместимый с OpenAI.
> * Модель по умолчанию при первоначальной настройке — `mistral/mistral-large-latest`.
> * Переопределяйте базовый URL в `models.providers.mistral.baseUrl`, только если Mistral явно публикует необходимую вам региональную конечную точку.

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

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при отказе.

> [card] [Анализ мультимедиа](https://docs2.openclaw.ai/ru/nodes/media-understanding.md)
>
> Настройка транскрипции аудио и выбор провайдера.