chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-12 10:37:03 +00:00
parent e71262a5a1
commit 511ce98511
5 changed files with 455 additions and 178 deletions

View File

@ -1,43 +1,59 @@
---
read_when:
- Ви хочете використовувати моделі GLM в OpenClaw
- Вам потрібні правила іменування моделей і налаштування
- Ви хочете моделі GLM в OpenClaw
- Вам потрібні схема іменування моделей і налаштування
summary: Огляд сімейства моделей GLM + як використовувати його в OpenClaw
title: Моделі GLM
x-i18n:
generated_at: "2026-04-08T03:40:13Z"
generated_at: "2026-04-12T10:36:40Z"
model: gpt-5.4
provider: openai
source_hash: 79a55acfa139847b4b85dbc09f1068cbd2febb1e49f984a23ea9e3b43bc910eb
source_hash: 12469bda0298f05fd94dc76a3183ab0e08257ec12e84ad1ed393107880e193de
source_path: providers/glm.md
workflow: 15
---
# Моделі GLM
GLM — це **сімейство моделей** (а не компанія), доступне через платформу Z.AI. В OpenClaw моделі
GLM доступні через провайдера `zai` та ідентифікатори моделей на кшталт `zai/glm-5`.
GLM — це **сімейство моделей** (а не компанія), доступне через платформу Z.AI. У OpenClaw
до моделей GLM звертаються через провайдера `zai` та ідентифікатори моделей на кшталт `zai/glm-5`.
## Налаштування CLI
## Початок роботи
```bash
# Загальне налаштування API-ключа з автоматичним визначенням кінцевої точки
openclaw onboard --auth-choice zai-api-key
<Steps>
<Step title="Виберіть варіант автентифікації та запустіть онбординг">
Виберіть варіант онбордингу, що відповідає вашому плану Z.AI та регіону:
# Coding Plan Global, рекомендовано для користувачів Coding Plan
openclaw onboard --auth-choice zai-coding-global
| Варіант автентифікації | Найкраще підходить для |
| ---------------------- | ---------------------- |
| `zai-api-key` | Загального налаштування через API-ключ з автоматичним визначенням кінцевої точки |
| `zai-coding-global` | Користувачів плану Coding (глобально) |
| `zai-coding-cn` | Користувачів плану Coding (регіон Китай) |
| `zai-global` | Загального API (глобально) |
| `zai-cn` | Загального API (регіон Китай) |
# Coding Plan CN (регіон Китай), рекомендовано для користувачів Coding Plan
openclaw onboard --auth-choice zai-coding-cn
```bash
# Приклад: загальне автоматичне визначення
openclaw onboard --auth-choice zai-api-key
# Загальний API
openclaw onboard --auth-choice zai-global
# Приклад: глобальний план Coding
openclaw onboard --auth-choice zai-coding-global
```
# Загальний API CN (регіон Китай)
openclaw onboard --auth-choice zai-cn
```
</Step>
<Step title="Установіть GLM як модель за замовчуванням">
```bash
openclaw config set agents.defaults.model.primary "zai/glm-5.1"
```
</Step>
<Step title="Переконайтеся, що моделі доступні">
```bash
openclaw models list --provider zai
```
</Step>
</Steps>
## Фрагмент конфігурації
## Приклад конфігурації
```json5
{
@ -46,30 +62,56 @@ openclaw onboard --auth-choice zai-cn
}
```
<Tip>
`zai-api-key` дає OpenClaw змогу визначити відповідну кінцеву точку Z.AI за ключем і
автоматично застосувати правильну базову URL-адресу. Використовуйте явні регіональні варіанти, якщо
хочете примусово вибрати конкретний Coding Plan або загальний API-інтерфейс.
автоматично застосувати правильний базовий URL. Використовуйте явні регіональні варіанти, якщо
хочете примусово вибрати конкретний план Coding або загальну поверхню API.
</Tip>
## Поточні вбудовані моделі GLM
## Вбудовані моделі GLM
Наразі OpenClaw заповнює вбудованого провайдера `zai` такими посиланнями GLM:
Наразі OpenClaw додає до вбудованого провайдера `zai` такі посилання на GLM:
- `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`
| Модель | Модель |
| ---------------- | ----------------- |
| `glm-5.1` | `glm-4.7` |
| `glm-5` | `glm-4.7-flash` |
| `glm-5-turbo` | `glm-4.7-flashx` |
| `glm-5v-turbo` | `glm-4.6` |
| `glm-4.5` | `glm-4.6v` |
| `glm-4.5-air` | |
| `glm-4.5-flash` | |
| `glm-4.5v` | |
## Примітки
<Note>
Посиланням на вбудовану модель за замовчуванням є `zai/glm-5.1`. Версії GLM і їхня доступність
можуть змінюватися; перевіряйте документацію Z.AI, щоб отримати найактуальнішу інформацію.
</Note>
- Версії GLM і їх доступність можуть змінюватися; перевіряйте документацію Z.AI, щоб дізнатися про найновіші дані.
- Типове вбудоване посилання на модель — `zai/glm-5.1`.
- Докладніше про провайдера див. у [/providers/zai](/uk/providers/zai).
## Додаткові примітки
<AccordionGroup>
<Accordion title="Автоматичне визначення кінцевої точки">
Якщо ви використовуєте варіант автентифікації `zai-api-key`, OpenClaw аналізує формат ключа,
щоб визначити правильний базовий URL Z.AI. Явні регіональні варіанти
(`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`) вимикають
автоматичне визначення та напряму фіксують кінцеву точку.
</Accordion>
<Accordion title="Деталі провайдера">
Моделі GLM надаються runtime-провайдером `zai`. Повну інформацію про конфігурацію провайдера,
регіональні кінцеві точки та додаткові можливості дивіться в
[документації провайдера Z.AI](/uk/providers/zai).
</Accordion>
</AccordionGroup>
## Пов’язане
<CardGroup cols={2}>
<Card title="Провайдер Z.AI" href="/uk/providers/zai" icon="server">
Повна конфігурація провайдера Z.AI та регіональні кінцеві точки.
</Card>
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
</Card>
</CardGroup>

View File

@ -1,14 +1,14 @@
---
read_when:
- Ви хочете отримати доступ до моделей, що розміщуються в OpenCode
- Вам потрібен доступ до моделей, розміщених у OpenCode
- Ви хочете вибрати між каталогами Zen і Go
summary: Використання каталогів OpenCode Zen і Go з OpenClaw
summary: Використовуйте каталоги OpenCode Zen і Go з OpenClaw
title: OpenCode
x-i18n:
generated_at: "2026-04-05T18:14:36Z"
generated_at: "2026-04-12T10:36:46Z"
model: gpt-5.4
provider: openai
source_hash: c23bc99208d9275afcb1731c28eee250c9f4b7d0578681ace31416135c330865
source_hash: a68444d8c403c3caba4a18ea47f078c7a4c163f874560e1fad0e818afb6e0e60
source_path: providers/opencode.md
workflow: 15
---
@ -17,30 +17,78 @@ x-i18n:
OpenCode надає два розміщені каталоги в OpenClaw:
- `opencode/...` для каталогу **Zen**
- `opencode-go/...` для каталогу **Go**
| Каталог | Префікс | Провайдер runtime |
| ------- | ---------------- | ----------------- |
| **Zen** | `opencode/...` | `opencode` |
| **Go** | `opencode-go/...` | `opencode-go` |
Обидва каталоги використовують той самий API-ключ OpenCode. OpenClaw зберігає ідентифікатори провайдерів runtime
розділеними, щоб маршрутизація окремих моделей на рівні джерела залишалася коректною, але onboarding і документація розглядають їх
Обидва каталоги використовують той самий ключ API OpenCode. OpenClaw зберігає ідентифікатори провайдерів runtime
розділеними, щоб маршрутизація для кожної моделі у вищерозташованому сервісі залишалася коректною, але онбординг і документація розглядають їх
як єдине налаштування OpenCode.
## Налаштування CLI
## Початок роботи
### Каталог Zen
<Tabs>
<Tab title="Zen catalog">
**Найкраще підходить для:** курованого багатомодельного проксі OpenCode (Claude, GPT, Gemini).
```bash
openclaw onboard --auth-choice opencode-zen
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
```
<Steps>
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice opencode-zen
```
### Каталог Go
Або передайте ключ напряму:
```bash
openclaw onboard --auth-choice opencode-go
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
```
```bash
openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY"
```
</Step>
<Step title="Set a Zen model as the default">
```bash
openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6"
```
</Step>
<Step title="Verify models are available">
```bash
openclaw models list --provider opencode
```
</Step>
</Steps>
## Фрагмент конфігурації
</Tab>
<Tab title="Go catalog">
**Найкраще підходить для:** лінійки Kimi, GLM і MiniMax, розміщеної в OpenCode.
<Steps>
<Step title="Run onboarding">
```bash
openclaw onboard --auth-choice opencode-go
```
Або передайте ключ напряму:
```bash
openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
```
</Step>
<Step title="Set a Go model as the default">
```bash
openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.5"
```
</Step>
<Step title="Verify models are available">
```bash
openclaw models list --provider opencode-go
```
</Step>
</Steps>
</Tab>
</Tabs>
## Приклад конфігурації
```json5
{
@ -53,23 +101,58 @@ openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY"
### Zen
- Провайдер runtime: `opencode`
- Приклади моделей: `opencode/claude-opus-4-6`, `opencode/gpt-5.4`, `opencode/gemini-3-pro`
- Найкраще підходить, коли вам потрібен курований багатомодельний проксі OpenCode
| Властивість | Значення |
| ---------------- | ----------------------------------------------------------------------- |
| Провайдер runtime | `opencode` |
| Приклади моделей | `opencode/claude-opus-4-6`, `opencode/gpt-5.4`, `opencode/gemini-3-pro` |
### Go
- Провайдер runtime: `opencode-go`
- Приклади моделей: `opencode-go/kimi-k2.5`, `opencode-go/glm-5`, `opencode-go/minimax-m2.5`
- Найкраще підходить, коли вам потрібна лінійка Kimi/GLM/MiniMax, розміщена в OpenCode
| Властивість | Значення |
| ---------------- | ------------------------------------------------------------------------ |
| Провайдер runtime | `opencode-go` |
| Приклади моделей | `opencode-go/kimi-k2.5`, `opencode-go/glm-5`, `opencode-go/minimax-m2.5` |
## Примітки
## Додаткові примітки
- `OPENCODE_ZEN_API_KEY` також підтримується.
- Введення одного ключа OpenCode під час налаштування зберігає облікові дані для обох провайдерів runtime.
- Ви входите в OpenCode, додаєте платіжні дані та копіюєте свій API-ключ.
- Оплата й доступність каталогів керуються з панелі OpenCode.
- Посилання OpenCode на базі Gemini залишаються на шляху proxy-Gemini, тому OpenClaw зберігає
там санітизацію thought-signature Gemini без увімкнення нативної перевірки replay Gemini
або переписування bootstrap.
- Посилання OpenCode, не пов’язані з Gemini, зберігають мінімальну політику replay, сумісну з OpenAI.
<AccordionGroup>
<Accordion title="API key aliases">
`OPENCODE_ZEN_API_KEY` також підтримується як псевдонім для `OPENCODE_API_KEY`.
</Accordion>
<Accordion title="Shared credentials">
Введення одного ключа OpenCode під час налаштування зберігає облікові дані для обох провайдерів runtime.
Вам не потрібно проходити онбординг для кожного каталогу окремо.
</Accordion>
<Accordion title="Billing and dashboard">
Ви входите в OpenCode, додаєте платіжні дані та копіюєте свій ключ API. Керування білінгом
і доступністю каталогів здійснюється з панелі керування OpenCode.
</Accordion>
<Accordion title="Gemini replay behavior">
Посилання OpenCode на базі Gemini залишаються на шляху proxy-Gemini, тому OpenClaw зберігає
там санітизацію thought-signature Gemini без увімкнення нативної
перевірки повторного відтворення Gemini або переписування bootstrap.
</Accordion>
<Accordion title="Non-Gemini replay behavior">
Посилання OpenCode не на базі Gemini зберігають мінімальну політику повторного відтворення, сумісну з OpenAI.
</Accordion>
</AccordionGroup>
<Tip>
Введення одного ключа OpenCode під час налаштування зберігає облікові дані для обох провайдерів runtime Zen і
Go, тож вам потрібно пройти онбординг лише один раз.
</Tip>
## Пов’язане
<CardGroup cols={2}>
<Card title="Model selection" href="/uk/concepts/model-providers" icon="layers">
Вибір провайдерів, посилань моделей і поведінки резервного перемикання.
</Card>
<Card title="Configuration reference" href="/uk/gateway/configuration-reference" icon="gear">
Повний довідник конфігурації для агентів, моделей і провайдерів.
</Card>
</CardGroup>

View File

@ -1,69 +1,132 @@
---
read_when:
- Ви хочете налаштувати Perplexity як провайдера вебпошуку
- Вам потрібен API key Perplexity або налаштування проксі OpenRouter
summary: Налаштування провайдера вебпошуку Perplexity (API key, режими пошуку, фільтрація)
title: Perplexity (провайдер)
- Ви хочете налаштувати Perplexity як вебпровайдера пошуку
- Вам потрібен ключ API Perplexity або налаштування проксі OpenRouter
summary: Налаштування вебпровайдера пошуку Perplexity (ключ API, режими пошуку, фільтрація)
title: Perplexity (Provider)
x-i18n:
generated_at: "2026-04-05T18:14:42Z"
generated_at: "2026-04-12T10:36:42Z"
model: gpt-5.4
provider: openai
source_hash: df9082d15d6a36a096e21efe8cee78e4b8643252225520f5b96a0b99cf5a7a4b
source_hash: 9a6cfa63541e875869db26e407c9433442b954933a5658f443be206a496aac83
source_path: providers/perplexity-provider.md
workflow: 15
---
# Perplexity (провайдер вебпошуку)
# Perplexity (вебпровайдер пошуку)
Плагін Perplexity надає можливості вебпошуку через Search API Perplexity
Плагін Perplexity надає можливості вебпошуку через API пошуку Perplexity
або Perplexity Sonar через OpenRouter.
<Note>
Ця сторінка описує налаштування **провайдера** Perplexity. Для **інструмента**
Perplexity (як агент його використовує) див. [інструмент Perplexity](/tools/perplexity-search).
Perplexity (як агент його використовує) див. [інструмент Perplexity](/uk/tools/perplexity-search).
</Note>
- Тип: провайдер вебпошуку (не провайдер моделей)
- Автентифікація: `PERPLEXITY_API_KEY` (напряму) або `OPENROUTER_API_KEY` (через OpenRouter)
- Шлях конфігурації: `plugins.entries.perplexity.config.webSearch.apiKey`
| Властивість | Значення |
| ----------- | ---------------------------------------------------------------------- |
| Тип | Вебпровайдер пошуку (не провайдер моделей) |
| Автентифікація | `PERPLEXITY_API_KEY` (напряму) або `OPENROUTER_API_KEY` (через OpenRouter) |
| Шлях конфігурації | `plugins.entries.perplexity.config.webSearch.apiKey` |
## Швидкий старт
## Початок роботи
1. Установіть API key:
<Steps>
<Step title="Установіть ключ API">
Запустіть інтерактивний процес налаштування вебпошуку:
```bash
openclaw configure --section web
```
```bash
openclaw configure --section web
```
Або задайте його напряму:
Або встановіть ключ безпосередньо:
```bash
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
```
```bash
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
```
2. Агент автоматично використовуватиме Perplexity для вебпошуку, якщо його налаштовано.
</Step>
<Step title="Почніть шукати">
Агент автоматично використовуватиме Perplexity для вебпошуку, щойно ключ
буде налаштовано. Додаткових кроків не потрібно.
</Step>
</Steps>
## Режими пошуку
Плагін автоматично вибирає транспорт за префіксом API key:
Плагін автоматично вибирає транспорт на основі префікса ключа API:
<Tabs>
<Tab title="Власний API Perplexity (pplx-)">
Коли ваш ключ починається з `pplx-`, OpenClaw використовує власний API пошуку
Perplexity. Цей транспорт повертає структуровані результати та підтримує
фільтри домену, мови й дати (див. параметри фільтрації нижче).
</Tab>
<Tab title="OpenRouter / Sonar (sk-or-)">
Коли ваш ключ починається з `sk-or-`, OpenClaw спрямовує запити через
OpenRouter, використовуючи модель Perplexity Sonar. Цей транспорт повертає
синтезовані ШІ відповіді з посиланнями на джерела.
</Tab>
</Tabs>
| Префікс ключа | Транспорт | Можливості |
| ------------- | --------------------------- | ----------------------------------------------- |
| `pplx-` | Нативний Search API Perplexity | Структуровані результати, фільтри доменів/мови/дати |
| `sk-or-` | OpenRouter (Sonar) | AI-синтезовані відповіді з цитуванням |
| `pplx-` | Власний API пошуку Perplexity | Структуровані результати, фільтри домену/мови/дати |
| `sk-or-` | OpenRouter (Sonar) | Синтезовані ШІ відповіді з посиланнями на джерела |
## Фільтрація нативного API
## Фільтрація у власному API
При використанні нативного API Perplexity (ключ `pplx-`) пошук підтримує:
<Note>
Параметри фільтрації доступні лише під час використання власного API Perplexity
(ключ `pplx-`). Пошук через OpenRouter/Sonar не підтримує ці параметри.
</Note>
- **Країна**: дволітерний код країни
- **Мова**: код мови ISO 639-1
- **Діапазон дат**: день, тиждень, місяць, рік
- **Фільтри доменів**: allowlist/denylist (максимум 20 доменів)
- **Бюджет вмісту**: `max_tokens`, `max_tokens_per_page`
Під час використання власного API Perplexity пошук підтримує такі фільтри:
## Примітка щодо середовища
| Фільтр | Опис | Приклад |
| -------------- | ----------------------------------------- | ----------------------------------- |
| Країна | 2-літерний код країни | `us`, `de`, `jp` |
| Мова | Код мови ISO 639-1 | `en`, `fr`, `zh` |
| Діапазон дат | Вікно актуальності | `day`, `week`, `month`, `year` |
| Фільтри доменів | Список дозволених або заборонених доменів (макс. 20 доменів) | `example.com` |
| Бюджет вмісту | Обмеження токенів на відповідь / на сторінку | `max_tokens`, `max_tokens_per_page` |
Якщо Gateway працює як daemon (launchd/systemd), переконайтеся, що
`PERPLEXITY_API_KEY` доступна для цього процесу (наприклад, у
`~/.openclaw/.env` або через `env.shellEnv`).
## Додаткові примітки
<AccordionGroup>
<Accordion title="Змінна середовища для фонових процесів">
Якщо Gateway OpenClaw працює як фоновий процес (launchd/systemd), переконайтеся,
що `PERPLEXITY_API_KEY` доступний для цього процесу.
<Warning>
Ключ, заданий лише в `~/.profile`, не буде видимий для демона launchd/systemd,
якщо це середовище не було явно імпортовано. Установіть ключ у
`~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його
прочитати.
</Warning>
</Accordion>
<Accordion title="Налаштування проксі OpenRouter">
Якщо ви хочете спрямовувати пошук Perplexity через OpenRouter, установіть
`OPENROUTER_API_KEY` (префікс `sk-or-`) замість власного ключа Perplexity.
OpenClaw виявить префікс і автоматично переключиться на транспорт Sonar.
<Tip>
Транспорт OpenRouter корисний, якщо у вас уже є обліковий запис OpenRouter
і ви хочете консолідоване виставлення рахунків для кількох провайдерів.
</Tip>
</Accordion>
</AccordionGroup>
## Пов’язані матеріали
<CardGroup cols={2}>
<Card title="Інструмент пошуку Perplexity" href="/uk/tools/perplexity-search" icon="magnifying-glass">
Як агент викликає пошук Perplexity та інтерпретує результати.
</Card>
<Card title="Довідник із конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
Повний довідник із конфігурації, включно із записами плагінів.
</Card>
</CardGroup>

View File

@ -1,54 +1,63 @@
---
read_when:
- Ви хочете використовувати генерацію відео Runway в OpenClaw
- Вам потрібне налаштування ключа API/env для Runway
- Вам потрібне налаштування API-ключа/змінної середовища Runway
- Ви хочете зробити Runway типовим провайдером відео
summary: Налаштування генерації відео Runway в OpenClaw
title: Runway
x-i18n:
generated_at: "2026-04-06T00:33:10Z"
generated_at: "2026-04-12T10:36:40Z"
model: gpt-5.4
provider: openai
source_hash: bc615d1a26f7a4b890d29461e756690c858ecb05024cf3c4d508218022da6e76
source_hash: fb9a2d26687920544222b0769f314743af245629fd45b7f456c0161a47476176
source_path: providers/runway.md
workflow: 15
---
# Runway
OpenClaw постачається зі вбудованим провайдером `runway` для хостингової генерації відео.
OpenClaw постачається з вбудованим провайдером `runway` для хостованої генерації відео.
- Ідентифікатор провайдера: `runway`
- Автентифікація: `RUNWAYML_API_SECRET` (канонічний) або `RUNWAY_API_KEY`
- API: генерація відео Runway на основі завдань (опитування `GET /v1/tasks/{id}`)
| Властивість | Значення |
| ----------- | ------------------------------------------------------------------ |
| ID провайдера | `runway` |
| Автентифікація | `RUNWAYML_API_SECRET` (канонічна) або `RUNWAY_API_KEY` |
| API | Генерація відео Runway на основі задач (`GET /v1/tasks/{id}` polling) |
## Швидкий старт
## Початок роботи
1. Установіть ключ API:
```bash
openclaw onboard --auth-choice runway-api-key
```
2. Установіть Runway як типовий провайдер відео:
```bash
openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
```
3. Попросіть агента згенерувати відео. Runway буде використано автоматично.
<Steps>
<Step title="Встановіть API-ключ">
```bash
openclaw onboard --auth-choice runway-api-key
```
</Step>
<Step title="Зробіть Runway типовим провайдером відео">
```bash
openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
```
</Step>
<Step title="Згенеруйте відео">
Попросіть агента згенерувати відео. Runway буде використано автоматично.
</Step>
</Steps>
## Підтримувані режими
| Режим | Модель | Вхідні референси |
| -------------- | ------------------ | ----------------------- |
| Текст у відео | `gen4.5` (типово) | Немає |
| Зображення у відео | `gen4.5` | 1 локальне або віддалене зображення |
| Відео у відео | `gen4_aleph` | 1 локальне або віддалене відео |
| Режим | Модель | Вхідні референсні дані |
| ------------- | ------------------ | ------------------------ |
| Текст у відео | `gen4.5` (типово) | Немає |
| Зображення у відео | `gen4.5` | 1 локальне або віддалене зображення |
| Відео у відео | `gen4_aleph` | 1 локальне або віддалене відео |
- Підтримуються посилання на локальні зображення та відео через URI даних.
- Для режиму відео у відео наразі потрібна саме модель `runway/gen4_aleph`.
- Для запусків лише з текстом наразі доступні співвідношення сторін `16:9` і `9:16`.
<Note>
Локальні посилання на зображення та відео підтримуються через URI даних. Для
запусків лише з текстом наразі доступні співвідношення сторін `16:9` і `9:16`.
</Note>
<Warning>
Режим відео у відео наразі вимагає саме `runway/gen4_aleph`.
</Warning>
## Конфігурація
@ -64,7 +73,28 @@ openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5"
}
```
## Додаткові примітки
<AccordionGroup>
<Accordion title="Псевдоніми змінних середовища">
OpenClaw розпізнає і `RUNWAYML_API_SECRET` (канонічна), і `RUNWAY_API_KEY`.
Будь-яка зі змінних забезпечить автентифікацію провайдера Runway.
</Accordion>
<Accordion title="Опитування задач">
Runway використовує API на основі задач. Після надсилання запиту на генерацію OpenClaw
опитує `GET /v1/tasks/{id}`, доки відео не буде готове. Додаткова
конфігурація для такої поведінки опитування не потрібна.
</Accordion>
</AccordionGroup>
## Пов’язане
- [Генерація відео](/uk/tools/video-generation) -- спільні параметри інструмента, вибір провайдера та асинхронна поведінка
- [Довідник з конфігурації](/uk/gateway/configuration-reference#agent-defaults)
<CardGroup cols={2}>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри інструмента, вибір провайдера та асинхронна поведінка.
</Card>
<Card title="Довідник із конфігурації" href="/uk/gateway/configuration-reference#agent-defaults" icon="gear">
Типові налаштування агента, зокрема модель генерації відео.
</Card>
</CardGroup>

View File

@ -1,50 +1,72 @@
---
read_when:
- Ви хочете використовувати Vercel AI Gateway з OpenClaw
- Вам потрібна env var API-ключа або варіант auth для CLI
summary: Налаштування Vercel AI Gateway (auth + вибір моделі)
- Вам потрібна змінна середовища ключа API або варіант автентифікації в CLI
summary: Налаштування Vercel AI Gateway (автентифікація + вибір моделі)
title: Vercel AI Gateway
x-i18n:
generated_at: "2026-04-05T18:15:04Z"
generated_at: "2026-04-12T10:36:40Z"
model: gpt-5.4
provider: openai
source_hash: f30768dc3db49708b25042d317906f7ad9a2c72b0fa03263bc04f5eefbf7a507
source_hash: 48c206a645d7a62e201a35ae94232323c8570fdae63129231c38d363ea78a60b
source_path: providers/vercel-ai-gateway.md
workflow: 15
---
# Vercel AI Gateway
[Vercel AI Gateway](https://vercel.com/ai-gateway) надає уніфікований API для доступу до сотень моделей через єдиний endpoint.
[Vercel AI Gateway](https://vercel.com/ai-gateway) надає уніфікований API для доступу
до сотень моделей через єдину кінцеву точку.
- Провайдер: `vercel-ai-gateway`
- Auth: `AI_GATEWAY_API_KEY`
- API: сумісний з Anthropic Messages
- OpenClaw автоматично виявляє каталог Gateway `/v1/models`, тому `/models vercel-ai-gateway`
містить актуальні посилання на моделі, такі як `vercel-ai-gateway/openai/gpt-5.4`.
| Властивість | Значення |
| ------------- | ------------------------------- |
| Провайдер | `vercel-ai-gateway` |
| Автентифікація | `AI_GATEWAY_API_KEY` |
| API | сумісний з Anthropic Messages |
| Каталог моделей | автоматично виявляється через `/v1/models` |
## Швидкий початок
<Tip>
OpenClaw автоматично виявляє каталог Gateway `/v1/models`, тому
`/models vercel-ai-gateway` містить актуальні посилання на моделі, як-от
`vercel-ai-gateway/openai/gpt-5.4`.
</Tip>
1. Установіть API-ключ (рекомендовано: зберегти його для Gateway):
## Початок роботи
```bash
openclaw onboard --auth-choice ai-gateway-api-key
```
<Steps>
<Step title="Встановіть ключ API">
Запустіть онбординг і виберіть варіант автентифікації AI Gateway:
2. Установіть типову модель:
```bash
openclaw onboard --auth-choice ai-gateway-api-key
```
```json5
{
agents: {
defaults: {
model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
},
},
}
```
</Step>
<Step title="Встановіть модель за замовчуванням">
Додайте модель до вашої конфігурації OpenClaw:
```json5
{
agents: {
defaults: {
model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
},
},
}
```
</Step>
<Step title="Перевірте, що модель доступна">
```bash
openclaw models list --provider vercel-ai-gateway
```
</Step>
</Steps>
## Неінтерактивний приклад
Для налаштувань через скрипти або в CI передайте всі значення в командному рядку:
```bash
openclaw onboard --non-interactive \
--mode local \
@ -52,16 +74,53 @@ openclaw onboard --non-interactive \
--ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```
## Примітка щодо середовища
Якщо Gateway працює як служба (launchd/systemd), переконайтеся, що `AI_GATEWAY_API_KEY`
доступний цьому процесу (наприклад, у `~/.openclaw/.env` або через
`env.shellEnv`).
## Скорочений запис ID моделі
OpenClaw приймає скорочені посилання на моделі Claude для Vercel і нормалізує їх
під час runtime:
OpenClaw приймає скорочені посилання на моделі Vercel Claude і нормалізує їх
під час виконання:
- `vercel-ai-gateway/claude-opus-4.6` -> `vercel-ai-gateway/anthropic/claude-opus-4.6`
- `vercel-ai-gateway/opus-4.6` -> `vercel-ai-gateway/anthropic/claude-opus-4-6`
| Скорочений ввід | Нормалізоване посилання на модель |
| ---------------------------------- | --------------------------------------------- |
| `vercel-ai-gateway/claude-opus-4.6` | `vercel-ai-gateway/anthropic/claude-opus-4.6` |
| `vercel-ai-gateway/opus-4.6` | `vercel-ai-gateway/anthropic/claude-opus-4-6` |
<Tip>
У вашій конфігурації можна використовувати як скорочений запис, так і повне
посилання на модель. OpenClaw автоматично визначає канонічну форму.
</Tip>
## Додаткові примітки
<AccordionGroup>
<Accordion title="Змінна середовища для процесів-демонів">
Якщо Gateway OpenClaw працює як демон (launchd/systemd), переконайтеся, що
`AI_GATEWAY_API_KEY` доступна для цього процесу.
<Warning>
Ключ, заданий лише в `~/.profile`, не буде видимий демону launchd/systemd,
якщо це середовище не імпортовано явно. Задайте ключ у
`~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг
його прочитати.
</Warning>
</Accordion>
<Accordion title="Маршрутизація провайдера">
Vercel AI Gateway маршрутизує запити до висхідного провайдера на основі
префікса посилання на модель. Наприклад, `vercel-ai-gateway/anthropic/claude-opus-4.6` маршрутизується
через Anthropic, а `vercel-ai-gateway/openai/gpt-5.4` — через
OpenAI. Ваш єдиний `AI_GATEWAY_API_KEY` забезпечує автентифікацію для всіх
висхідних провайдерів.
</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>