diff --git a/docs/uk/providers/alibaba.md b/docs/uk/providers/alibaba.md index 9599874e5..fcfc2a12b 100644 --- a/docs/uk/providers/alibaba.md +++ b/docs/uk/providers/alibaba.md @@ -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", + + + ```bash + openclaw onboard --auth-choice qwen-standard-api-key + ``` + + + ```json5 + { + agents: { + defaults: { + videoGenerationModel: { + primary: "alibaba/wan2.6-t2v", + }, + }, }, - }, - }, -} -``` + } + ``` + + + ```bash + openclaw models list --provider alibaba + ``` + + + + +Підійде будь-який із підтримуваних ключів автентифікації (`MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY`). Варіант онбордингу `qwen-standard-api-key` налаштовує спільні облікові дані DashScope. + ## Вбудовані моделі 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 + +Режим референсного зображення/відео наразі вимагає **віддалених URL `http(s)`**. Локальні шляхи до файлів для референсних вхідних даних не підтримуються. + -Вбудований провайдер `qwen` також використовує розміщені Alibaba кінцеві точки DashScope для -генерації відео Wan. Використовуйте: +## Розширена конфігурація -- `qwen/...`, якщо вам потрібна канонічна поверхня провайдера Qwen -- `alibaba/...`, якщо вам потрібна пряма поверхня генерації відео Wan від постачальника + + + Вбудований провайдер `qwen` також використовує розміщені Alibaba кінцеві точки DashScope для + генерації відео Wan. Використовуйте: + + - `qwen/...`, якщо вам потрібна канонічна поверхня провайдера Qwen + - `alibaba/...`, якщо вам потрібна пряма поверхня генерації відео Wan, що належить постачальнику + + Докладніше див. у [документації провайдера Qwen](/uk/providers/qwen). + + + + + OpenClaw перевіряє ключі автентифікації в такому порядку: + + 1. `MODELSTUDIO_API_KEY` (бажано) + 2. `DASHSCOPE_API_KEY` + 3. `QWEN_API_KEY` + + Будь-який із цих ключів автентифікує провайдер `alibaba`. + + + ## Пов’язане -- [Генерація відео](/uk/tools/video-generation) -- [Qwen](/uk/providers/qwen) -- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) + + + Спільні параметри інструмента відео та вибір провайдера. + + + Налаштування провайдера Qwen та інтеграція DashScope. + + + Значення агента за замовчуванням і конфігурація моделей. + + diff --git a/docs/uk/providers/cloudflare-ai-gateway.md b/docs/uk/providers/cloudflare-ai-gateway.md index c220c83b1..e16a8e340 100644 --- a/docs/uk/providers/cloudflare-ai-gateway.md +++ b/docs/uk/providers/cloudflare-ai-gateway.md @@ -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///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///anthropic` | +| Типова модель | `cloudflare-ai-gateway/claude-sonnet-4-5` | +| Ключ API | `CLOUDFLARE_AI_GATEWAY_API_KEY` (ваш ключ API провайдера для запитів через Gateway) | -Для моделей Anthropic використовуйте свій API-ключ Anthropic. + +Для моделей Anthropic, що маршрутизуються через Cloudflare AI Gateway, використовуйте свій **ключ API Anthropic** як ключ провайдера. + -## Швидкий початок +## Початок роботи -1. Установіть 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" }, - }, - }, -} -``` + + + Додайте модель до конфігурації OpenClaw: + + ```json5 + { + agents: { + defaults: { + model: { primary: "cloudflare-ai-gateway/claude-sonnet-4-5" }, + }, + }, + } + ``` + + + + ```bash + openclaw models list --provider cloudflare-ai-gateway + ``` + + ## Неінтерактивний приклад +Для сценаріїв або налаштувань 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-ключа провайдера). + + + Якщо ви ввімкнули автентифікацію Gateway у Cloudflare, додайте заголовок `cf-aig-authorization`. Це **додатково до** ключа API вашого провайдера. -```json5 -{ - models: { - providers: { - "cloudflare-ai-gateway": { - headers: { - "cf-aig-authorization": "Bearer ", + ```json5 + { + models: { + providers: { + "cloudflare-ai-gateway": { + headers: { + "cf-aig-authorization": "Bearer ", + }, + }, }, }, - }, - }, -} -``` + } + ``` -## Примітка щодо середовища + + Заголовок `cf-aig-authorization` автентифікує в самому Cloudflare Gateway, тоді як ключ API провайдера (наприклад, ваш ключ Anthropic) автентифікує у висхідного провайдера. + -Якщо Gateway працює як служба (launchd/systemd), переконайтеся, що `CLOUDFLARE_AI_GATEWAY_API_KEY` доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через `env.shellEnv`). + + + + Якщо Gateway працює як демон (launchd/systemd), переконайтеся, що `CLOUDFLARE_AI_GATEWAY_API_KEY` доступний для цього процесу. + + + Ключ, що зберігається лише в `~/.profile`, не допоможе демону launchd/systemd, якщо це середовище не імпортовано також туди. Установіть ключ у `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його прочитати. + + + + + +## Пов’язане + + + + Вибір провайдерів, посилань на моделі та поведінки перемикання на резервний варіант. + + + Загальне усунення несправностей і поширені запитання. + + diff --git a/docs/uk/providers/fireworks.md b/docs/uk/providers/fireworks.md index b766c0c0e..80ee38eb1 100644 --- a/docs/uk/providers/fireworks.md +++ b/docs/uk/providers/fireworks.md @@ -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 через онбординг: + + + ```bash + openclaw onboard --auth-choice fireworks-api-key + ``` -```bash -openclaw onboard --auth-choice fireworks-api-key -``` + Це зберігає ваш ключ Fireworks у конфігурації OpenClaw і встановлює стартову модель Fire Pass як модель за замовчуванням. -Це збереже ваш ключ Fireworks у конфігурації OpenClaw і встановить стартову модель Fire Pass як типову. + + + ```bash + openclaw models list --provider fireworks + ``` + + ## Неінтерактивний приклад +Для сценаріїв або налаштувань 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 + +Якщо Fireworks опублікує новішу модель, наприклад новий випуск Qwen або Gemma, ви можете переключитися на неї напряму, використовуючи її ідентифікатор моделі Fireworks, не чекаючи оновлення вбудованого каталогу. + -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 без очікування оновлення вбудованого каталогу. + + + Кожне посилання на модель Fireworks в OpenClaw починається з `fireworks/`, після якого йде точний ідентифікатор або шлях маршрутизатора з платформи Fireworks. Наприклад: + + - Модель маршрутизатора: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo` + - Пряма модель: `fireworks/accounts/fireworks/models/` + + OpenClaw видаляє префікс `fireworks/` під час формування API-запиту й надсилає решту шляху до кінцевої точки Fireworks. + + + + + Якщо Gateway працює поза вашою інтерактивною оболонкою, переконайтеся, що `FIREWORKS_API_KEY` також доступний для цього процесу. + + + Ключ, що знаходиться лише в `~/.profile`, не допоможе демону launchd/systemd, якщо це середовище також не імпортоване туди. Установіть ключ у `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його прочитати. + + + + + +## Пов’язане + + + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. + + + Загальне усунення несправностей і поширені запитання. + + diff --git a/docs/uk/providers/mistral.md b/docs/uk/providers/mistral.md index 80922a3d2..2996a7337 100644 --- a/docs/uk/providers/mistral.md +++ b/docs/uk/providers/mistral.md @@ -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) + + + Створіть ключ API в [Mistral Console](https://console.mistral.ai/). + + + ```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" + ``` + + + + ```json5 + { + env: { MISTRAL_API_KEY: "sk-..." }, + agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } }, + } + ``` + + + ```bash + openclaw models list --provider mistral + ``` + + ## Вбудований каталог 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`) + +Шлях транскрипції медіа використовує `/v1/audio/transcriptions`. Моделлю аудіо за замовчуванням для Mistral є `voxtral-mini-latest`. + -`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: + + + `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` | -## Примітки + + Інші моделі у вбудованому каталозі Mistral не використовують цей параметр. Продовжуйте використовувати моделі `magistral-*`, якщо вам потрібна нативна поведінка Mistral, орієнтована насамперед на міркування. + -- Для автентифікації 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`). + + + + Mistral може надавати ембединги пам’яті через `/v1/embeddings` (модель за замовчуванням: `mistral-embed`). + + ```json5 + { + memorySearch: { provider: "mistral" }, + } + ``` + + + + + - Автентифікація Mistral використовує `MISTRAL_API_KEY`. + - Базовий URL провайдера за замовчуванням: `https://api.mistral.ai/v1`. + - Модель онбордингу за замовчуванням — `mistral/mistral-large-latest`. + - Z.AI використовує Bearer-автентифікацію з вашим ключем API. + + + +## Пов’язане + + + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. + + + Налаштування транскрипції аудіо та вибір провайдера. + + diff --git a/docs/uk/providers/zai.md b/docs/uk/providers/zai.md index e323d82c1..a87270846 100644 --- a/docs/uk/providers/zai.md +++ b/docs/uk/providers/zai.md @@ -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 + + + **Найкраще для:** більшості користувачів. OpenClaw визначає відповідний endpoint Z.AI за ключем і автоматично застосовує правильний базовий URL. -# Coding Plan CN (регіон Китай), рекомендовано для користувачів Coding Plan -openclaw onboard --auth-choice zai-coding-cn + + + ```bash + openclaw onboard --auth-choice zai-api-key + ``` + + + ```json5 + { + env: { ZAI_API_KEY: "sk-..." }, + agents: { defaults: { model: { primary: "zai/glm-5.1" } } }, + } + ``` + + + ```bash + openclaw models list --provider zai + ``` + + -# Загальний API -openclaw onboard --auth-choice zai-global + -# Загальний API CN (регіон Китай) -openclaw onboard --auth-choice zai-cn -``` + + **Найкраще для:** користувачів, які хочуть примусово вибрати певний Coding Plan або загальну поверхню API. -## Фрагмент конфігурації + + + ```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 + ``` + + + ```json5 + { + env: { ZAI_API_KEY: "sk-..." }, + agents: { defaults: { model: { primary: "zai/glm-5.1" } } }, + } + ``` + + + ```bash + openclaw models list --provider zai + ``` + + + + + ## Вбудований каталог 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` | | -## Примітки + +Моделі GLM доступні як `zai/` (приклад: `zai/glm-5`). Вбудоване посилання на модель за замовчуванням — `zai/glm-5.1`. + -- Моделі GLM доступні як `zai/` (приклад: `zai/glm-5`). -- Базове посилання на вбудовану модель: `zai/glm-5.1` -- Невідомі ідентифікатори `glm-5*` все одно розв’язуються через шлях вбудованого провайдера - шляхом синтезу метаданих провайдера на основі шаблону `glm-4.7`, коли ідентифікатор - відповідає поточній формі сімейства GLM-5. -- `tool_stream` увімкнено за замовчуванням для потокової передачі викликів інструментів у Z.AI. Установіть - `agents.defaults.models["zai/"].params.tool_stream` в `false`, щоб вимкнути це. -- Див. [/providers/glm](/uk/providers/glm), щоб ознайомитися з оглядом сімейства моделей. -- Z.AI використовує Bearer-автентифікацію з вашим API-ключем. +## Розширена конфігурація + + + + Невідомі ідентифікатори `glm-5*` усе ще напряму резолюються через шлях вбудованого провайдера + шляхом синтезу метаданих, що належать провайдеру, із шаблону `glm-4.7`, коли ідентифікатор + відповідає поточній формі сімейства GLM-5. + + + + `tool_stream` увімкнено за замовчуванням для потокового передавання викликів інструментів Z.AI. Щоб вимкнути це: + + ```json5 + { + agents: { + defaults: { + models: { + "zai/": { + params: { tool_stream: false }, + }, + }, + }, + }, + } + ``` + + + + + - Z.AI використовує Bearer auth з вашим API-ключем. + - Варіант онбордингу `zai-api-key` автоматично визначає відповідний endpoint Z.AI за префіксом ключа. + - Використовуйте явні регіональні варіанти (`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`), якщо хочете примусово вибрати певну поверхню API. + + + +## Пов’язане + + + + Огляд сімейства моделей GLM. + + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. + +