Providers
Mistral
OpenClaw містить вбудований Plugin Mistral, який реєструє чотири контракти: чат-доповнення, розуміння медіа (пакетна транскрипція Voxtral), STT у реальному часі для голосових викликів (Voxtral Realtime) і embeddings пам’яті (mistral-embed).
| Властивість | Значення |
|---|---|
| Ідентифікатор провайдера | mistral |
| Plugin | вбудований, enabledByDefault: true |
| Змінна середовища автентифікації | 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 |
| Модель embedding | mistral-embed |
| Пакетний Voxtral | voxtral-mini-latest (аудіотранскрипція) |
| Voxtral у реальному часі | voxtral-mini-transcribe-realtime-2602 |
Початок роботи
Отримайте свій API-ключ
Створіть API-ключ у Mistral Console.
Запустіть онбординг
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
OpenClaw наразі постачається з таким вбудованим каталогом Mistral:
| Посилання на модель | Вхідні дані | Контекст | Максимальний вихід | Примітки |
|---|---|---|---|---|
mistral/mistral-large-latest |
текст, зображення | 262,144 | 16,384 | Модель за замовчуванням |
mistral/mistral-medium-2508 |
текст, зображення | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-small-latest |
текст, зображення | 128,000 | 16,384 | Mistral Small 4; регульоване reasoning через API 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 | З увімкненим reasoning |
Аудіотранскрипція (Voxtral)
Використовуйте Voxtral для пакетної аудіотранскрипції через конвеєр розуміння медіа.
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
Потокове STT для голосових викликів
Вбудований Plugin 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 |
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "mistral",
providers: {
mistral: {
apiKey: "${MISTRAL_API_KEY}",
targetStreamingDelayMs: 800,
},
},
},
},
},
},
},
}
Розширена конфігурація
Регульоване reasoning (mistral-small-latest)
mistral/mistral-small-latest відповідає Mistral Small 4 і підтримує регульоване reasoning в API Chat Completions через reasoning_effort (none мінімізує додаткове мислення у вихідних даних; high показує повні трасування мислення перед фінальною відповіддю).
OpenClaw зіставляє рівень thinking сесії з API Mistral:
| Рівень thinking в OpenClaw | reasoning_effort Mistral |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Embeddings пам’яті
Mistral може надавати embeddings пам’яті через /v1/embeddings (модель за замовчуванням: mistral-embed).
{
memorySearch: { provider: "mistral" },
}
Автентифікація та базова URL-адреса
- Автентифікація 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.