chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
6077e926ad
commit
5441eaef84
@ -1,79 +1,123 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати генерацію відео Alibaba Wan в OpenClaw
|
||||
- Вам потрібно налаштувати ключ API Model Studio або DashScope для генерації відео
|
||||
summary: Генерація відео Wan в Alibaba Model Studio в OpenClaw
|
||||
- Для генерації відео вам потрібно налаштувати API-ключ Model Studio або DashScope
|
||||
summary: Генерація відео Wan в Alibaba Model Studio у OpenClaw
|
||||
title: Alibaba Model Studio
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T22:36:47Z"
|
||||
generated_at: "2026-04-12T10:33:34Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 97a1eddc7cbd816776b9368f2a926b5ef9ee543f08d151a490023736f67dc635
|
||||
source_hash: a6e97d929952cdba7740f5ab3f6d85c18286b05596a4137bf80bbc8b54f32662
|
||||
source_path: providers/alibaba.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Alibaba Model Studio
|
||||
|
||||
OpenClaw постачається з вбудованим провайдером генерації відео `alibaba` для моделей Wan у
|
||||
OpenClaw постачається з вбудованим провайдером генерації відео `alibaba` для моделей Wan на
|
||||
Alibaba Model Studio / DashScope.
|
||||
|
||||
- Провайдер: `alibaba`
|
||||
- Бажана автентифікація: `MODELSTUDIO_API_KEY`
|
||||
- Також приймаються: `DASHSCOPE_API_KEY`, `QWEN_API_KEY`
|
||||
- Також підтримуються: `DASHSCOPE_API_KEY`, `QWEN_API_KEY`
|
||||
- API: асинхронна генерація відео DashScope / Model Studio
|
||||
|
||||
## Швидкий старт
|
||||
## Початок роботи
|
||||
|
||||
1. Установіть ключ API:
|
||||
|
||||
```bash
|
||||
openclaw onboard --auth-choice qwen-standard-api-key
|
||||
```
|
||||
|
||||
2. Установіть модель відео за замовчуванням:
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
videoGenerationModel: {
|
||||
primary: "alibaba/wan2.6-t2v",
|
||||
<Steps>
|
||||
<Step title="Налаштуйте API-ключ">
|
||||
```bash
|
||||
openclaw onboard --auth-choice qwen-standard-api-key
|
||||
```
|
||||
</Step>
|
||||
<Step title="Налаштуйте модель відео за замовчуванням">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
videoGenerationModel: {
|
||||
primary: "alibaba/wan2.6-t2v",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
}
|
||||
```
|
||||
</Step>
|
||||
<Step title="Перевірте, що провайдер доступний">
|
||||
```bash
|
||||
openclaw models list --provider alibaba
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
<Note>
|
||||
Підійде будь-який із підтримуваних ключів автентифікації (`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY`). Варіант онбордингу `qwen-standard-api-key` налаштовує спільні облікові дані DashScope.
|
||||
</Note>
|
||||
|
||||
## Вбудовані моделі Wan
|
||||
|
||||
Вбудований провайдер `alibaba` наразі реєструє:
|
||||
|
||||
- `alibaba/wan2.6-t2v`
|
||||
- `alibaba/wan2.6-i2v`
|
||||
- `alibaba/wan2.6-r2v`
|
||||
- `alibaba/wan2.6-r2v-flash`
|
||||
- `alibaba/wan2.7-r2v`
|
||||
| Посилання на модель | Режим |
|
||||
| ------------------------- | ------------------------- |
|
||||
| `alibaba/wan2.6-t2v` | Текст у відео |
|
||||
| `alibaba/wan2.6-i2v` | Зображення у відео |
|
||||
| `alibaba/wan2.6-r2v` | Референс у відео |
|
||||
| `alibaba/wan2.6-r2v-flash` | Референс у відео (швидко) |
|
||||
| `alibaba/wan2.7-r2v` | Референс у відео |
|
||||
|
||||
## Поточні обмеження
|
||||
|
||||
- До **1** вихідного відео на запит
|
||||
- До **1** вхідного зображення
|
||||
- До **4** вхідних відео
|
||||
- Тривалість до **10 секунд**
|
||||
- Підтримуються `size`, `aspectRatio`, `resolution`, `audio` і `watermark`
|
||||
- Режим еталонного зображення/відео наразі потребує **віддалених URL-адрес http(s)**
|
||||
| Параметр | Обмеження |
|
||||
| --------------------- | -------------------------------------------------------- |
|
||||
| Вихідні відео | До **1** на запит |
|
||||
| Вхідні зображення | До **1** |
|
||||
| Вхідні відео | До **4** |
|
||||
| Тривалість | До **10 секунд** |
|
||||
| Підтримувані елементи керування | `size`, `aspectRatio`, `resolution`, `audio`, `watermark` |
|
||||
| Референсне зображення/відео | Лише віддалені URL `http(s)` |
|
||||
|
||||
## Зв’язок із Qwen
|
||||
<Warning>
|
||||
Режим референсного зображення/відео наразі вимагає **віддалених URL `http(s)`**. Локальні шляхи до файлів для референсних вхідних даних не підтримуються.
|
||||
</Warning>
|
||||
|
||||
Вбудований провайдер `qwen` також використовує розміщені Alibaba кінцеві точки DashScope для
|
||||
генерації відео Wan. Використовуйте:
|
||||
## Розширена конфігурація
|
||||
|
||||
- `qwen/...`, якщо вам потрібна канонічна поверхня провайдера Qwen
|
||||
- `alibaba/...`, якщо вам потрібна пряма поверхня генерації відео Wan від постачальника
|
||||
<AccordionGroup>
|
||||
<Accordion title="Зв’язок із Qwen">
|
||||
Вбудований провайдер `qwen` також використовує розміщені Alibaba кінцеві точки DashScope для
|
||||
генерації відео Wan. Використовуйте:
|
||||
|
||||
- `qwen/...`, якщо вам потрібна канонічна поверхня провайдера Qwen
|
||||
- `alibaba/...`, якщо вам потрібна пряма поверхня генерації відео Wan, що належить постачальнику
|
||||
|
||||
Докладніше див. у [документації провайдера Qwen](/uk/providers/qwen).
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Пріоритет ключів автентифікації">
|
||||
OpenClaw перевіряє ключі автентифікації в такому порядку:
|
||||
|
||||
1. `MODELSTUDIO_API_KEY` (бажано)
|
||||
2. `DASHSCOPE_API_KEY`
|
||||
3. `QWEN_API_KEY`
|
||||
|
||||
Будь-який із цих ключів автентифікує провайдер `alibaba`.
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
- [Генерація відео](/uk/tools/video-generation)
|
||||
- [Qwen](/uk/providers/qwen)
|
||||
- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults)
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
|
||||
Спільні параметри інструмента відео та вибір провайдера.
|
||||
</Card>
|
||||
<Card title="Qwen" href="/uk/providers/qwen" icon="microchip">
|
||||
Налаштування провайдера Qwen та інтеграція DashScope.
|
||||
</Card>
|
||||
<Card title="Довідник із конфігурації" href="/uk/gateway/configuration-reference#agent-defaults" icon="gear">
|
||||
Значення агента за замовчуванням і конфігурація моделей.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,51 +1,71 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати Cloudflare AI Gateway з OpenClaw
|
||||
- Вам потрібні ID облікового запису, ID шлюзу або env var API-ключа
|
||||
summary: Налаштування Cloudflare AI Gateway (auth + вибір моделі)
|
||||
- Вам потрібен ID облікового запису, ID Gateway або змінна середовища ключа API
|
||||
summary: Налаштування Cloudflare AI Gateway (автентифікація + вибір моделі)
|
||||
title: Cloudflare AI Gateway
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:13:58Z"
|
||||
generated_at: "2026-04-12T10:33:36Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: db77652c37652ca20f7c50f32382dbaeaeb50ea5bdeaf1d4fd17dc394e58950c
|
||||
source_hash: 12e9589fe74e6a6335370b9cf2361a464876a392a33f8317d7fd30c3f163b2e5
|
||||
source_path: providers/cloudflare-ai-gateway.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Cloudflare AI Gateway
|
||||
|
||||
Cloudflare AI Gateway працює перед API провайдерів і дає змогу додавати аналітику, кешування та засоби контролю. Для Anthropic OpenClaw використовує Anthropic Messages API через ваш endpoint Gateway.
|
||||
Cloudflare AI Gateway розташовується перед API провайдерів і дає змогу додавати аналітику, кешування та елементи керування. Для Anthropic OpenClaw використовує Anthropic Messages API через вашу кінцеву точку Gateway.
|
||||
|
||||
- Провайдер: `cloudflare-ai-gateway`
|
||||
- Базова URL-адреса: `https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic`
|
||||
- Типова модель: `cloudflare-ai-gateway/claude-sonnet-4-5`
|
||||
- API-ключ: `CLOUDFLARE_AI_GATEWAY_API_KEY` (ваш API-ключ провайдера для запитів через Gateway)
|
||||
| Властивість | Значення |
|
||||
| ------------- | --------------------------------------------------------------------------------------- |
|
||||
| Провайдер | `cloudflare-ai-gateway` |
|
||||
| Базовий URL | `https://gateway.ai.cloudflare.com/v1/<account_id>/<gateway_id>/anthropic` |
|
||||
| Типова модель | `cloudflare-ai-gateway/claude-sonnet-4-5` |
|
||||
| Ключ API | `CLOUDFLARE_AI_GATEWAY_API_KEY` (ваш ключ API провайдера для запитів через Gateway) |
|
||||
|
||||
Для моделей Anthropic використовуйте свій API-ключ Anthropic.
|
||||
<Note>
|
||||
Для моделей Anthropic, що маршрутизуються через Cloudflare AI Gateway, використовуйте свій **ключ API Anthropic** як ключ провайдера.
|
||||
</Note>
|
||||
|
||||
## Швидкий початок
|
||||
## Початок роботи
|
||||
|
||||
1. Установіть API-ключ провайдера та дані Gateway:
|
||||
<Steps>
|
||||
<Step title="Укажіть ключ API провайдера та дані Gateway">
|
||||
Запустіть онбординг і виберіть варіант автентифікації Cloudflare AI Gateway:
|
||||
|
||||
```bash
|
||||
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
|
||||
```
|
||||
```bash
|
||||
openclaw onboard --auth-choice cloudflare-ai-gateway-api-key
|
||||
```
|
||||
|
||||
2. Установіть типову модель:
|
||||
Буде запитано ID вашого облікового запису, ID Gateway і ключ API.
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
</Step>
|
||||
<Step title="Установіть типову модель">
|
||||
Додайте модель до конфігурації OpenClaw:
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" },
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
</Step>
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider cloudflare-ai-gateway
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Неінтерактивний приклад
|
||||
|
||||
Для сценаріїв або налаштувань CI передайте всі значення в командному рядку:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
--mode local \
|
||||
@ -55,24 +75,49 @@ openclaw onboard --non-interactive \
|
||||
--cloudflare-ai-gateway-api-key "$CLOUDFLARE_AI_GATEWAY_API_KEY"
|
||||
```
|
||||
|
||||
## Автентифіковані шлюзи
|
||||
## Розширена конфігурація
|
||||
|
||||
Якщо ви ввімкнули автентифікацію Gateway у Cloudflare, додайте заголовок `cf-aig-authorization` (це додатково до вашого API-ключа провайдера).
|
||||
<AccordionGroup>
|
||||
<Accordion title="Автентифіковані шлюзи">
|
||||
Якщо ви ввімкнули автентифікацію Gateway у Cloudflare, додайте заголовок `cf-aig-authorization`. Це **додатково до** ключа API вашого провайдера.
|
||||
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
"cloudflare-ai-gateway": {
|
||||
headers: {
|
||||
"cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
"cloudflare-ai-gateway": {
|
||||
headers: {
|
||||
"cf-aig-authorization": "Bearer <cloudflare-ai-gateway-token>",
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
}
|
||||
```
|
||||
|
||||
## Примітка щодо середовища
|
||||
<Tip>
|
||||
Заголовок `cf-aig-authorization` автентифікує в самому Cloudflare Gateway, тоді як ключ API провайдера (наприклад, ваш ключ Anthropic) автентифікує у висхідного провайдера.
|
||||
</Tip>
|
||||
|
||||
Якщо Gateway працює як служба (launchd/systemd), переконайтеся, що `CLOUDFLARE_AI_GATEWAY_API_KEY` доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через `env.shellEnv`).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Примітка щодо середовища">
|
||||
Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `CLOUDFLARE_AI_GATEWAY_API_KEY` доступний для цього процесу.
|
||||
|
||||
<Warning>
|
||||
Ключ, що зберігається лише в `~/.profile`, не допоможе демону launchd/systemd, якщо це середовище не імпортовано також туди. Установіть ключ у `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його прочитати.
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки перемикання на резервний варіант.
|
||||
</Card>
|
||||
<Card title="Усунення несправностей" href="/uk/help/troubleshooting" icon="wrench">
|
||||
Загальне усунення несправностей і поширені запитання.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,39 +1,51 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати Fireworks з OpenClaw
|
||||
- Вам потрібна env-змінна API-ключа Fireworks або id типової моделі
|
||||
- Вам потрібна змінна середовища з API-ключем Fireworks або ідентифікатор моделі за замовчуванням
|
||||
summary: Налаштування Fireworks (автентифікація + вибір моделі)
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T18:13:57Z"
|
||||
generated_at: "2026-04-12T10:33:33Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 20083d5c248abd9a7223e6d188f0265ae27381940ee0067dff6d1d46d908c552
|
||||
source_hash: 8f87b2ed6fb6c6db086166ff2775f15d876947f48a36b9dd2e2a55269709cb6a
|
||||
source_path: providers/fireworks.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Fireworks
|
||||
|
||||
[Fireworks](https://fireworks.ai) надає open-weight і routed models через OpenAI-сумісний API. OpenClaw тепер містить вбудований плагін провайдера Fireworks.
|
||||
[Fireworks](https://fireworks.ai) надає open-weight і маршрутизовані моделі через API, сумісний з OpenAI. OpenClaw містить вбудований Plugin провайдера Fireworks.
|
||||
|
||||
- Провайдер: `fireworks`
|
||||
- Автентифікація: `FIREWORKS_API_KEY`
|
||||
- API: OpenAI-сумісні chat/completions
|
||||
- Base URL: `https://api.fireworks.ai/inference/v1`
|
||||
- Типова модель: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
|
||||
| Властивість | Значення |
|
||||
| ------------- | ----------------------------------------------------- |
|
||||
| Провайдер | `fireworks` |
|
||||
| Автентифікація | `FIREWORKS_API_KEY` |
|
||||
| API | чат/completions, сумісні з OpenAI |
|
||||
| Базовий URL | `https://api.fireworks.ai/inference/v1` |
|
||||
| Модель за замовчуванням | `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` |
|
||||
|
||||
## Швидкий старт
|
||||
## Початок роботи
|
||||
|
||||
Налаштуйте автентифікацію Fireworks через онбординг:
|
||||
<Steps>
|
||||
<Step title="Налаштуйте автентифікацію Fireworks через онбординг">
|
||||
```bash
|
||||
openclaw onboard --auth-choice fireworks-api-key
|
||||
```
|
||||
|
||||
```bash
|
||||
openclaw onboard --auth-choice fireworks-api-key
|
||||
```
|
||||
Це зберігає ваш ключ Fireworks у конфігурації OpenClaw і встановлює стартову модель Fire Pass як модель за замовчуванням.
|
||||
|
||||
Це збереже ваш ключ Fireworks у конфігурації OpenClaw і встановить стартову модель Fire Pass як типову.
|
||||
</Step>
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider fireworks
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Неінтерактивний приклад
|
||||
|
||||
Для сценаріїв або налаштувань CI передайте всі значення в командному рядку:
|
||||
|
||||
```bash
|
||||
openclaw onboard --non-interactive \
|
||||
--mode local \
|
||||
@ -43,23 +55,19 @@ openclaw onboard --non-interactive \
|
||||
--accept-risk
|
||||
```
|
||||
|
||||
## Примітка про середовище
|
||||
|
||||
Якщо Gateway працює поза вашою інтерактивною оболонкою, переконайтеся, що `FIREWORKS_API_KEY`
|
||||
також доступний цьому процесу. Ключ, що зберігається лише в `~/.profile`, не
|
||||
допоможе демону launchd/systemd, якщо це середовище також не буде імпортоване туди.
|
||||
|
||||
## Вбудований каталог
|
||||
|
||||
| Посилання на модель | Назва | Вхід | Контекст | Макс. вивід | Примітки |
|
||||
| ------------------------------------------------------- | --------------------------- | ---------- | -------- | ----------- | -------------------------------------------- |
|
||||
| `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo (Fire Pass) | text,image | 256,000 | 256,000 | Типова вбудована стартова модель у Fireworks |
|
||||
| Посилання на модель | Назва | Вхід | Контекст | Макс. вивід | Примітки |
|
||||
| ----------------------------------------------------- | --------------------------- | ---------- | -------- | ----------- | ------------------------------------------ |
|
||||
| `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` | Kimi K2.5 Turbo (Fire Pass) | text,image | 256,000 | 256,000 | Вбудована стартова модель Fireworks за замовчуванням |
|
||||
|
||||
## Користувацькі id моделей Fireworks
|
||||
<Tip>
|
||||
Якщо Fireworks опублікує новішу модель, наприклад новий випуск Qwen або Gemma, ви можете переключитися на неї напряму, використовуючи її ідентифікатор моделі Fireworks, не чекаючи оновлення вбудованого каталогу.
|
||||
</Tip>
|
||||
|
||||
OpenClaw також приймає динамічні id моделей Fireworks. Використовуйте точний id моделі або router, показаний у Fireworks, і додайте до нього префікс `fireworks/`.
|
||||
## Користувацькі ідентифікатори моделей Fireworks
|
||||
|
||||
Приклад:
|
||||
OpenClaw також приймає динамічні ідентифікатори моделей Fireworks. Використовуйте точний ідентифікатор моделі або маршрутизатора, показаний у Fireworks, і додавайте префікс `fireworks/`.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -73,4 +81,34 @@ OpenClaw також приймає динамічні id моделей Firework
|
||||
}
|
||||
```
|
||||
|
||||
Якщо Fireworks опублікує новішу модель, наприклад свіжий випуск Qwen або Gemma, ви можете одразу переключитися на неї, використавши її id моделі Fireworks без очікування оновлення вбудованого каталогу.
|
||||
<AccordionGroup>
|
||||
<Accordion title="Як працює префікс ідентифікатора моделі">
|
||||
Кожне посилання на модель Fireworks в OpenClaw починається з `fireworks/`, після якого йде точний ідентифікатор або шлях маршрутизатора з платформи Fireworks. Наприклад:
|
||||
|
||||
- Модель маршрутизатора: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
|
||||
- Пряма модель: `fireworks/accounts/fireworks/models/<model-name>`
|
||||
|
||||
OpenClaw видаляє префікс `fireworks/` під час формування API-запиту й надсилає решту шляху до кінцевої точки Fireworks.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Примітка щодо середовища">
|
||||
Якщо Gateway працює поза вашою інтерактивною оболонкою, переконайтеся, що `FIREWORKS_API_KEY` також доступний для цього процесу.
|
||||
|
||||
<Warning>
|
||||
Ключ, що знаходиться лише в `~/.profile`, не допоможе демону launchd/systemd, якщо це середовище також не імпортоване туди. Установіть ключ у `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його прочитати.
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
|
||||
</Card>
|
||||
<Card title="Усунення несправностей" href="/uk/help/troubleshooting" icon="wrench">
|
||||
Загальне усунення несправностей і поширені запитання.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,56 +1,77 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати моделі Mistral в OpenClaw
|
||||
- Вам потрібні налаштування ключа API Mistral і посилання на моделі
|
||||
- Вам потрібні онбординг ключа API Mistral і посилання на моделі
|
||||
summary: Використовуйте моделі Mistral і транскрипцію Voxtral з OpenClaw
|
||||
title: Mistral
|
||||
x-i18n:
|
||||
generated_at: "2026-04-07T07:24:22Z"
|
||||
generated_at: "2026-04-12T10:33:33Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 4e32a0eb2a37dba6383ba338b06a8d0be600e7443aa916225794ccb0fdf46aee
|
||||
source_hash: 0474f55587909ce9bbdd47b881262edbeb1b07eb3ed52de1090a8ec4d260c97b
|
||||
source_path: providers/mistral.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Mistral
|
||||
|
||||
OpenClaw підтримує Mistral як для маршрутизації текстових/графічних моделей (`mistral/...`), так і
|
||||
для аудіотранскрипції через Voxtral у media understanding.
|
||||
OpenClaw підтримує Mistral як для маршрутизації текстових/зображувальних моделей (`mistral/...`), так і для транскрипції аудіо через Voxtral у media understanding.
|
||||
Mistral також можна використовувати для ембедингів пам’яті (`memorySearch.provider = "mistral"`).
|
||||
|
||||
## Налаштування CLI
|
||||
- Провайдер: `mistral`
|
||||
- Автентифікація: `MISTRAL_API_KEY`
|
||||
- API: Mistral Chat Completions (`https://api.mistral.ai/v1`)
|
||||
|
||||
```bash
|
||||
openclaw onboard --auth-choice mistral-api-key
|
||||
# or non-interactive
|
||||
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
|
||||
```
|
||||
## Початок роботи
|
||||
|
||||
## Фрагмент конфігурації (постачальник LLM)
|
||||
<Steps>
|
||||
<Step title="Отримайте свій ключ API">
|
||||
Створіть ключ API в [Mistral Console](https://console.mistral.ai/).
|
||||
</Step>
|
||||
<Step title="Запустіть онбординг">
|
||||
```bash
|
||||
openclaw onboard --auth-choice mistral-api-key
|
||||
```
|
||||
|
||||
```json5
|
||||
{
|
||||
env: { MISTRAL_API_KEY: "sk-..." },
|
||||
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
|
||||
}
|
||||
```
|
||||
Або передайте ключ безпосередньо:
|
||||
|
||||
```bash
|
||||
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
|
||||
```
|
||||
|
||||
</Step>
|
||||
<Step title="Установіть модель за замовчуванням">
|
||||
```json5
|
||||
{
|
||||
env: { MISTRAL_API_KEY: "sk-..." },
|
||||
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
|
||||
}
|
||||
```
|
||||
</Step>
|
||||
<Step title="Переконайтеся, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider mistral
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Вбудований каталог LLM
|
||||
|
||||
Наразі OpenClaw постачається з таким вбудованим каталогом Mistral:
|
||||
|
||||
| Model ref | Input | Context | Max output | Notes |
|
||||
| -------------------------------- | ----------- | ------- | ---------- | ---------------------------------------------------------------- |
|
||||
| `mistral/mistral-large-latest` | text, image | 262,144 | 16,384 | Default model |
|
||||
| `mistral/mistral-medium-2508` | text, image | 262,144 | 8,192 | Mistral Medium 3.1 |
|
||||
| `mistral/mistral-small-latest` | text, image | 128,000 | 16,384 | Mistral Small 4; adjustable reasoning via API `reasoning_effort` |
|
||||
| `mistral/pixtral-large-latest` | text, image | 128,000 | 32,768 | Pixtral |
|
||||
| `mistral/codestral-latest` | text | 256,000 | 4,096 | Coding |
|
||||
| `mistral/devstral-medium-latest` | text | 262,144 | 32,768 | Devstral 2 |
|
||||
| `mistral/magistral-small` | text | 128,000 | 40,000 | Reasoning-enabled |
|
||||
| Посилання на модель | Вхідні дані | Контекст | Макс. вивід | Примітки |
|
||||
| --------------------------------- | ----------- | -------- | ----------- | ---------------------------------------------------------------- |
|
||||
| `mistral/mistral-large-latest` | text, image | 262,144 | 16,384 | Модель за замовчуванням |
|
||||
| `mistral/mistral-medium-2508` | text, image | 262,144 | 8,192 | Mistral Medium 3.1 |
|
||||
| `mistral/mistral-small-latest` | text, image | 128,000 | 16,384 | Mistral Small 4; регульоване міркування через API `reasoning_effort` |
|
||||
| `mistral/pixtral-large-latest` | text, image | 128,000 | 32,768 | Pixtral |
|
||||
| `mistral/codestral-latest` | text | 256,000 | 4,096 | Програмування |
|
||||
| `mistral/devstral-medium-latest` | text | 262,144 | 32,768 | Devstral 2 |
|
||||
| `mistral/magistral-small` | text | 128,000 | 40,000 | З увімкненим міркуванням |
|
||||
|
||||
## Фрагмент конфігурації (аудіотранскрипція з Voxtral)
|
||||
## Транскрипція аудіо (Voxtral)
|
||||
|
||||
Використовуйте Voxtral для транскрипції аудіо через конвеєр media understanding.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -65,22 +86,55 @@ openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
|
||||
}
|
||||
```
|
||||
|
||||
## Регульоване міркування (`mistral-small-latest`)
|
||||
<Tip>
|
||||
Шлях транскрипції медіа використовує `/v1/audio/transcriptions`. Моделлю аудіо за замовчуванням для Mistral є `voxtral-mini-latest`.
|
||||
</Tip>
|
||||
|
||||
`mistral/mistral-small-latest` відповідає Mistral Small 4 і підтримує [регульоване міркування](https://docs.mistral.ai/capabilities/reasoning/adjustable) в API Chat Completions через `reasoning_effort` (`none` мінімізує додаткове мислення у виводі; `high` показує повні сліди мислення перед фінальною відповіддю).
|
||||
## Розширена конфігурація
|
||||
|
||||
OpenClaw зіставляє рівень **thinking** сеансу з API Mistral:
|
||||
<AccordionGroup>
|
||||
<Accordion title="Регульоване міркування (mistral-small-latest)">
|
||||
`mistral/mistral-small-latest` відповідає Mistral Small 4 і підтримує [регульоване міркування](https://docs.mistral.ai/capabilities/reasoning/adjustable) в API Chat Completions через `reasoning_effort` (`none` мінімізує додаткове міркування у виводі; `high` показує повні сліди міркування перед фінальною відповіддю).
|
||||
|
||||
- **off** / **minimal** → `none`
|
||||
- **low** / **medium** / **high** / **xhigh** / **adaptive** → `high`
|
||||
OpenClaw зіставляє рівень **thinking** сесії з API Mistral:
|
||||
|
||||
Інші моделі у вбудованому каталозі Mistral не використовують цей параметр; і надалі використовуйте моделі `magistral-*`, якщо вам потрібна нативна поведінка Mistral з пріоритетом міркування.
|
||||
| Рівень thinking в OpenClaw | Mistral `reasoning_effort` |
|
||||
| --------------------------------------------- | -------------------------- |
|
||||
| **off** / **minimal** | `none` |
|
||||
| **low** / **medium** / **high** / **xhigh** / **adaptive** | `high` |
|
||||
|
||||
## Примітки
|
||||
<Note>
|
||||
Інші моделі у вбудованому каталозі Mistral не використовують цей параметр. Продовжуйте використовувати моделі `magistral-*`, якщо вам потрібна нативна поведінка Mistral, орієнтована насамперед на міркування.
|
||||
</Note>
|
||||
|
||||
- Для автентифікації Mistral використовується `MISTRAL_API_KEY`.
|
||||
- Базова URL-адреса постачальника за замовчуванням: `https://api.mistral.ai/v1`.
|
||||
- Модель за замовчуванням для onboarding — `mistral/mistral-large-latest`.
|
||||
- Аудіомодель за замовчуванням для media understanding у Mistral — `voxtral-mini-latest`.
|
||||
- Шлях транскрипції медіа використовує `/v1/audio/transcriptions`.
|
||||
- Шлях ембедингів пам’яті використовує `/v1/embeddings` (модель за замовчуванням: `mistral-embed`).
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Ембединги пам’яті">
|
||||
Mistral може надавати ембединги пам’яті через `/v1/embeddings` (модель за замовчуванням: `mistral-embed`).
|
||||
|
||||
```json5
|
||||
{
|
||||
memorySearch: { provider: "mistral" },
|
||||
}
|
||||
```
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Автентифікація та базовий URL">
|
||||
- Автентифікація Mistral використовує `MISTRAL_API_KEY`.
|
||||
- Базовий URL провайдера за замовчуванням: `https://api.mistral.ai/v1`.
|
||||
- Модель онбордингу за замовчуванням — `mistral/mistral-large-latest`.
|
||||
- Z.AI використовує Bearer-автентифікацію з вашим ключем API.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
|
||||
</Card>
|
||||
<Card title="Media understanding" href="/tools/media-understanding" icon="microphone">
|
||||
Налаштування транскрипції аудіо та вибір провайдера.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати Z.AI / моделі GLM в OpenClaw
|
||||
- Вам потрібне просте налаштування ZAI_API_KEY
|
||||
- Ви хочете Z.AI / моделі GLM в OpenClaw
|
||||
- Вам потрібне просте налаштування `ZAI_API_KEY`
|
||||
summary: Використовуйте Z.AI (моделі GLM) з OpenClaw
|
||||
title: Z.AI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-08T03:40:14Z"
|
||||
generated_at: "2026-04-12T10:33:34Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 66cbd9813ee28d202dcae34debab1b0cf9927793acb00743c1c62b48d9e381f9
|
||||
source_hash: eddb57770e6f1f9c72e62585d7d43a5e25f0d08f1b793f1ba5b0168c4c47f3cd
|
||||
source_path: providers/zai.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -16,67 +16,145 @@ x-i18n:
|
||||
# Z.AI
|
||||
|
||||
Z.AI — це API-платформа для моделей **GLM**. Вона надає REST API для GLM і використовує API-ключі
|
||||
для автентифікації. Створіть свій API-ключ у консолі Z.AI. OpenClaw використовує провайдер `zai`
|
||||
із API-ключем Z.AI.
|
||||
для автентифікації. Створіть свій API-ключ у консолі Z.AI. OpenClaw використовує провайдера `zai`
|
||||
з API-ключем Z.AI.
|
||||
|
||||
## Налаштування CLI
|
||||
- Провайдер: `zai`
|
||||
- Автентифікація: `ZAI_API_KEY`
|
||||
- API: Z.AI Chat Completions (Bearer auth)
|
||||
|
||||
```bash
|
||||
# Загальне налаштування API-ключа з автоматичним визначенням кінцевої точки
|
||||
openclaw onboard --auth-choice zai-api-key
|
||||
## Початок роботи
|
||||
|
||||
# Coding Plan Global, рекомендовано для користувачів Coding Plan
|
||||
openclaw onboard --auth-choice zai-coding-global
|
||||
<Tabs>
|
||||
<Tab title="Автовизначення endpoint">
|
||||
**Найкраще для:** більшості користувачів. OpenClaw визначає відповідний endpoint Z.AI за ключем і автоматично застосовує правильний базовий URL.
|
||||
|
||||
# Coding Plan CN (регіон Китай), рекомендовано для користувачів Coding Plan
|
||||
openclaw onboard --auth-choice zai-coding-cn
|
||||
<Steps>
|
||||
<Step title="Запустіть онбординг">
|
||||
```bash
|
||||
openclaw onboard --auth-choice zai-api-key
|
||||
```
|
||||
</Step>
|
||||
<Step title="Установіть модель за замовчуванням">
|
||||
```json5
|
||||
{
|
||||
env: { ZAI_API_KEY: "sk-..." },
|
||||
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
|
||||
}
|
||||
```
|
||||
</Step>
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider zai
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
# Загальний API
|
||||
openclaw onboard --auth-choice zai-global
|
||||
</Tab>
|
||||
|
||||
# Загальний API CN (регіон Китай)
|
||||
openclaw onboard --auth-choice zai-cn
|
||||
```
|
||||
<Tab title="Явно вказаний регіональний endpoint">
|
||||
**Найкраще для:** користувачів, які хочуть примусово вибрати певний Coding Plan або загальну поверхню API.
|
||||
|
||||
## Фрагмент конфігурації
|
||||
<Steps>
|
||||
<Step title="Виберіть правильний варіант онбордингу">
|
||||
```bash
|
||||
# Coding Plan Global (рекомендовано для користувачів Coding Plan)
|
||||
openclaw onboard --auth-choice zai-coding-global
|
||||
|
||||
```json5
|
||||
{
|
||||
env: { ZAI_API_KEY: "sk-..." },
|
||||
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
|
||||
}
|
||||
```
|
||||
# Coding Plan CN (регіон Китай)
|
||||
openclaw onboard --auth-choice zai-coding-cn
|
||||
|
||||
`zai-api-key` дає OpenClaw змогу визначити відповідну кінцеву точку Z.AI за ключем і
|
||||
автоматично застосувати правильний базовий URL. Використовуйте явні регіональні варіанти, якщо
|
||||
ви хочете примусово вибрати певний Coding Plan або загальний API-інтерфейс.
|
||||
# Загальний API
|
||||
openclaw onboard --auth-choice zai-global
|
||||
|
||||
# Загальний API CN (регіон Китай)
|
||||
openclaw onboard --auth-choice zai-cn
|
||||
```
|
||||
</Step>
|
||||
<Step title="Установіть модель за замовчуванням">
|
||||
```json5
|
||||
{
|
||||
env: { ZAI_API_KEY: "sk-..." },
|
||||
agents: { defaults: { model: { primary: "zai/glm-5.1" } } },
|
||||
}
|
||||
```
|
||||
</Step>
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider zai
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Вбудований каталог GLM
|
||||
|
||||
Наразі OpenClaw попередньо заповнює вбудований провайдер `zai` такими моделями:
|
||||
OpenClaw наразі наповнює вбудованого провайдера `zai` такими моделями:
|
||||
|
||||
- `glm-5.1`
|
||||
- `glm-5`
|
||||
- `glm-5-turbo`
|
||||
- `glm-5v-turbo`
|
||||
- `glm-4.7`
|
||||
- `glm-4.7-flash`
|
||||
- `glm-4.7-flashx`
|
||||
- `glm-4.6`
|
||||
- `glm-4.6v`
|
||||
- `glm-4.5`
|
||||
- `glm-4.5-air`
|
||||
- `glm-4.5-flash`
|
||||
- `glm-4.5v`
|
||||
| Model ref | Примітки |
|
||||
| -------------------- | -------------------- |
|
||||
| `zai/glm-5.1` | Модель за замовчуванням |
|
||||
| `zai/glm-5` | |
|
||||
| `zai/glm-5-turbo` | |
|
||||
| `zai/glm-5v-turbo` | |
|
||||
| `zai/glm-4.7` | |
|
||||
| `zai/glm-4.7-flash` | |
|
||||
| `zai/glm-4.7-flashx` | |
|
||||
| `zai/glm-4.6` | |
|
||||
| `zai/glm-4.6v` | |
|
||||
| `zai/glm-4.5` | |
|
||||
| `zai/glm-4.5-air` | |
|
||||
| `zai/glm-4.5-flash` | |
|
||||
| `zai/glm-4.5v` | |
|
||||
|
||||
## Примітки
|
||||
<Tip>
|
||||
Моделі GLM доступні як `zai/<model>` (приклад: `zai/glm-5`). Вбудоване посилання на модель за замовчуванням — `zai/glm-5.1`.
|
||||
</Tip>
|
||||
|
||||
- Моделі GLM доступні як `zai/<model>` (приклад: `zai/glm-5`).
|
||||
- Базове посилання на вбудовану модель: `zai/glm-5.1`
|
||||
- Невідомі ідентифікатори `glm-5*` все одно розв’язуються через шлях вбудованого провайдера
|
||||
шляхом синтезу метаданих провайдера на основі шаблону `glm-4.7`, коли ідентифікатор
|
||||
відповідає поточній формі сімейства GLM-5.
|
||||
- `tool_stream` увімкнено за замовчуванням для потокової передачі викликів інструментів у Z.AI. Установіть
|
||||
`agents.defaults.models["zai/<model>"].params.tool_stream` в `false`, щоб вимкнути це.
|
||||
- Див. [/providers/glm](/uk/providers/glm), щоб ознайомитися з оглядом сімейства моделей.
|
||||
- Z.AI використовує Bearer-автентифікацію з вашим API-ключем.
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Пряме резолювання невідомих моделей GLM-5">
|
||||
Невідомі ідентифікатори `glm-5*` усе ще напряму резолюються через шлях вбудованого провайдера
|
||||
шляхом синтезу метаданих, що належать провайдеру, із шаблону `glm-4.7`, коли ідентифікатор
|
||||
відповідає поточній формі сімейства GLM-5.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Потокове передавання викликів інструментів">
|
||||
`tool_stream` увімкнено за замовчуванням для потокового передавання викликів інструментів Z.AI. Щоб вимкнути це:
|
||||
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
models: {
|
||||
"zai/<model>": {
|
||||
params: { tool_stream: false },
|
||||
},
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Деталі автентифікації">
|
||||
- Z.AI використовує Bearer auth з вашим API-ключем.
|
||||
- Варіант онбордингу `zai-api-key` автоматично визначає відповідний endpoint Z.AI за префіксом ключа.
|
||||
- Використовуйте явні регіональні варіанти (`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`), якщо хочете примусово вибрати певну поверхню API.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Сімейство моделей GLM" href="/uk/providers/glm" icon="microchip">
|
||||
Огляд сімейства моделей GLM.
|
||||
</Card>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user