diff --git a/docs/uk/providers/glm.md b/docs/uk/providers/glm.md index 03a4e0cf2..80e90e47d 100644 --- a/docs/uk/providers/glm.md +++ b/docs/uk/providers/glm.md @@ -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 + + + Виберіть варіант онбордингу, що відповідає вашому плану 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 -``` + + + ```bash + openclaw config set agents.defaults.model.primary "zai/glm-5.1" + ``` + + + ```bash + openclaw models list --provider zai + ``` + + -## Фрагмент конфігурації +## Приклад конфігурації ```json5 { @@ -46,30 +62,56 @@ openclaw onboard --auth-choice zai-cn } ``` + `zai-api-key` дає OpenClaw змогу визначити відповідну кінцеву точку Z.AI за ключем і -автоматично застосувати правильну базову URL-адресу. Використовуйте явні регіональні варіанти, якщо -хочете примусово вибрати конкретний Coding Plan або загальний API-інтерфейс. +автоматично застосувати правильний базовий URL. Використовуйте явні регіональні варіанти, якщо +хочете примусово вибрати конкретний план Coding або загальну поверхню API. + -## Поточні вбудовані моделі 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` | | -## Примітки + +Посиланням на вбудовану модель за замовчуванням є `zai/glm-5.1`. Версії GLM і їхня доступність +можуть змінюватися; перевіряйте документацію Z.AI, щоб отримати найактуальнішу інформацію. + -- Версії GLM і їх доступність можуть змінюватися; перевіряйте документацію Z.AI, щоб дізнатися про найновіші дані. -- Типове вбудоване посилання на модель — `zai/glm-5.1`. -- Докладніше про провайдера див. у [/providers/zai](/uk/providers/zai). +## Додаткові примітки + + + + Якщо ви використовуєте варіант автентифікації `zai-api-key`, OpenClaw аналізує формат ключа, + щоб визначити правильний базовий URL Z.AI. Явні регіональні варіанти + (`zai-coding-global`, `zai-coding-cn`, `zai-global`, `zai-cn`) вимикають + автоматичне визначення та напряму фіксують кінцеву точку. + + + + Моделі GLM надаються runtime-провайдером `zai`. Повну інформацію про конфігурацію провайдера, + регіональні кінцеві точки та додаткові можливості дивіться в + [документації провайдера Z.AI](/uk/providers/zai). + + + +## Пов’язане + + + + Повна конфігурація провайдера Z.AI та регіональні кінцеві точки. + + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. + + diff --git a/docs/uk/providers/opencode.md b/docs/uk/providers/opencode.md index bbeac929a..6e144d3ba 100644 --- a/docs/uk/providers/opencode.md +++ b/docs/uk/providers/opencode.md @@ -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 + + + **Найкраще підходить для:** курованого багатомодельного проксі OpenCode (Claude, GPT, Gemini). -```bash -openclaw onboard --auth-choice opencode-zen -openclaw onboard --opencode-zen-api-key "$OPENCODE_API_KEY" -``` + + + ```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" + ``` + + + ```bash + openclaw config set agents.defaults.model.primary "opencode/claude-opus-4-6" + ``` + + + ```bash + openclaw models list --provider opencode + ``` + + -## Фрагмент конфігурації + + + + **Найкраще підходить для:** лінійки Kimi, GLM і MiniMax, розміщеної в OpenCode. + + + + ```bash + openclaw onboard --auth-choice opencode-go + ``` + + Або передайте ключ напряму: + + ```bash + openclaw onboard --opencode-go-api-key "$OPENCODE_API_KEY" + ``` + + + ```bash + openclaw config set agents.defaults.model.primary "opencode-go/kimi-k2.5" + ``` + + + ```bash + openclaw models list --provider opencode-go + ``` + + + + + + +## Приклад конфігурації ```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. + + + `OPENCODE_ZEN_API_KEY` також підтримується як псевдонім для `OPENCODE_API_KEY`. + + + + Введення одного ключа OpenCode під час налаштування зберігає облікові дані для обох провайдерів runtime. + Вам не потрібно проходити онбординг для кожного каталогу окремо. + + + + Ви входите в OpenCode, додаєте платіжні дані та копіюєте свій ключ API. Керування білінгом + і доступністю каталогів здійснюється з панелі керування OpenCode. + + + + Посилання OpenCode на базі Gemini залишаються на шляху proxy-Gemini, тому OpenClaw зберігає + там санітизацію thought-signature Gemini без увімкнення нативної + перевірки повторного відтворення Gemini або переписування bootstrap. + + + + Посилання OpenCode не на базі Gemini зберігають мінімальну політику повторного відтворення, сумісну з OpenAI. + + + + +Введення одного ключа OpenCode під час налаштування зберігає облікові дані для обох провайдерів runtime Zen і +Go, тож вам потрібно пройти онбординг лише один раз. + + +## Пов’язане + + + + Вибір провайдерів, посилань моделей і поведінки резервного перемикання. + + + Повний довідник конфігурації для агентів, моделей і провайдерів. + + diff --git a/docs/uk/providers/perplexity-provider.md b/docs/uk/providers/perplexity-provider.md index 7b7a23dca..c8109f04e 100644 --- a/docs/uk/providers/perplexity-provider.md +++ b/docs/uk/providers/perplexity-provider.md @@ -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. Ця сторінка описує налаштування **провайдера** Perplexity. Для **інструмента** -Perplexity (як агент його використовує) див. [інструмент Perplexity](/tools/perplexity-search). +Perplexity (як агент його використовує) див. [інструмент Perplexity](/uk/tools/perplexity-search). -- Тип: провайдер вебпошуку (не провайдер моделей) -- Автентифікація: `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: + + + Запустіть інтерактивний процес налаштування вебпошуку: -```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 для вебпошуку, якщо його налаштовано. + + + Агент автоматично використовуватиме Perplexity для вебпошуку, щойно ключ + буде налаштовано. Додаткових кроків не потрібно. + + ## Режими пошуку -Плагін автоматично вибирає транспорт за префіксом API key: +Плагін автоматично вибирає транспорт на основі префікса ключа API: + + + + Коли ваш ключ починається з `pplx-`, OpenClaw використовує власний API пошуку + Perplexity. Цей транспорт повертає структуровані результати та підтримує + фільтри домену, мови й дати (див. параметри фільтрації нижче). + + + Коли ваш ключ починається з `sk-or-`, OpenClaw спрямовує запити через + OpenRouter, використовуючи модель Perplexity Sonar. Цей транспорт повертає + синтезовані ШІ відповіді з посиланнями на джерела. + + | Префікс ключа | Транспорт | Можливості | | ------------- | --------------------------- | ----------------------------------------------- | -| `pplx-` | Нативний Search API Perplexity | Структуровані результати, фільтри доменів/мови/дати | -| `sk-or-` | OpenRouter (Sonar) | AI-синтезовані відповіді з цитуванням | +| `pplx-` | Власний API пошуку Perplexity | Структуровані результати, фільтри домену/мови/дати | +| `sk-or-` | OpenRouter (Sonar) | Синтезовані ШІ відповіді з посиланнями на джерела | -## Фільтрація нативного API +## Фільтрація у власному API -При використанні нативного API Perplexity (ключ `pplx-`) пошук підтримує: + +Параметри фільтрації доступні лише під час використання власного API Perplexity +(ключ `pplx-`). Пошук через OpenRouter/Sonar не підтримує ці параметри. + -- **Країна**: дволітерний код країни -- **Мова**: код мови 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`). +## Додаткові примітки + + + + Якщо Gateway OpenClaw працює як фоновий процес (launchd/systemd), переконайтеся, + що `PERPLEXITY_API_KEY` доступний для цього процесу. + + + Ключ, заданий лише в `~/.profile`, не буде видимий для демона launchd/systemd, + якщо це середовище не було явно імпортовано. Установіть ключ у + `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг його + прочитати. + + + + + + Якщо ви хочете спрямовувати пошук Perplexity через OpenRouter, установіть + `OPENROUTER_API_KEY` (префікс `sk-or-`) замість власного ключа Perplexity. + OpenClaw виявить префікс і автоматично переключиться на транспорт Sonar. + + + Транспорт OpenRouter корисний, якщо у вас уже є обліковий запис OpenRouter + і ви хочете консолідоване виставлення рахунків для кількох провайдерів. + + + + + +## Пов’язані матеріали + + + + Як агент викликає пошук Perplexity та інтерпретує результати. + + + Повний довідник із конфігурації, включно із записами плагінів. + + diff --git a/docs/uk/providers/runway.md b/docs/uk/providers/runway.md index 275da6d3d..2b42be8e6 100644 --- a/docs/uk/providers/runway.md +++ b/docs/uk/providers/runway.md @@ -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 буде використано автоматично. + + + ```bash + openclaw onboard --auth-choice runway-api-key + ``` + + + ```bash + openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5" + ``` + + + Попросіть агента згенерувати відео. Runway буде використано автоматично. + + ## Підтримувані режими -| Режим | Модель | Вхідні референси | -| -------------- | ------------------ | ----------------------- | -| Текст у відео | `gen4.5` (типово) | Немає | -| Зображення у відео | `gen4.5` | 1 локальне або віддалене зображення | -| Відео у відео | `gen4_aleph` | 1 локальне або віддалене відео | +| Режим | Модель | Вхідні референсні дані | +| ------------- | ------------------ | ------------------------ | +| Текст у відео | `gen4.5` (типово) | Немає | +| Зображення у відео | `gen4.5` | 1 локальне або віддалене зображення | +| Відео у відео | `gen4_aleph` | 1 локальне або віддалене відео | -- Підтримуються посилання на локальні зображення та відео через URI даних. -- Для режиму відео у відео наразі потрібна саме модель `runway/gen4_aleph`. -- Для запусків лише з текстом наразі доступні співвідношення сторін `16:9` і `9:16`. + +Локальні посилання на зображення та відео підтримуються через URI даних. Для +запусків лише з текстом наразі доступні співвідношення сторін `16:9` і `9:16`. + + + +Режим відео у відео наразі вимагає саме `runway/gen4_aleph`. + ## Конфігурація @@ -64,7 +73,28 @@ openclaw config set agents.defaults.videoGenerationModel.primary "runway/gen4.5" } ``` +## Додаткові примітки + + + + OpenClaw розпізнає і `RUNWAYML_API_SECRET` (канонічна), і `RUNWAY_API_KEY`. + Будь-яка зі змінних забезпечить автентифікацію провайдера Runway. + + + + Runway використовує API на основі задач. Після надсилання запиту на генерацію OpenClaw + опитує `GET /v1/tasks/{id}`, доки відео не буде готове. Додаткова + конфігурація для такої поведінки опитування не потрібна. + + + ## Пов’язане -- [Генерація відео](/uk/tools/video-generation) -- спільні параметри інструмента, вибір провайдера та асинхронна поведінка -- [Довідник з конфігурації](/uk/gateway/configuration-reference#agent-defaults) + + + Спільні параметри інструмента, вибір провайдера та асинхронна поведінка. + + + Типові налаштування агента, зокрема модель генерації відео. + + diff --git a/docs/uk/providers/vercel-ai-gateway.md b/docs/uk/providers/vercel-ai-gateway.md index 267c745ca..98308efc2 100644 --- a/docs/uk/providers/vercel-ai-gateway.md +++ b/docs/uk/providers/vercel-ai-gateway.md @@ -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` | -## Швидкий початок + +OpenClaw автоматично виявляє каталог Gateway `/v1/models`, тому +`/models vercel-ai-gateway` містить актуальні посилання на моделі, як-от +`vercel-ai-gateway/openai/gpt-5.4`. + -1. Установіть API-ключ (рекомендовано: зберегти його для Gateway): +## Початок роботи -```bash -openclaw onboard --auth-choice ai-gateway-api-key -``` + + + Запустіть онбординг і виберіть варіант автентифікації 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" }, - }, - }, -} -``` + + + Додайте модель до вашої конфігурації OpenClaw: + + ```json5 + { + agents: { + defaults: { + model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" }, + }, + }, + } + ``` + + + + ```bash + openclaw models list --provider vercel-ai-gateway + ``` + + ## Неінтерактивний приклад +Для налаштувань через скрипти або в 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` | + + +У вашій конфігурації можна використовувати як скорочений запис, так і повне +посилання на модель. OpenClaw автоматично визначає канонічну форму. + + +## Додаткові примітки + + + + Якщо Gateway OpenClaw працює як демон (launchd/systemd), переконайтеся, що + `AI_GATEWAY_API_KEY` доступна для цього процесу. + + + Ключ, заданий лише в `~/.profile`, не буде видимий демону launchd/systemd, + якщо це середовище не імпортовано явно. Задайте ключ у + `~/.openclaw/.env` або через `env.shellEnv`, щоб процес gateway міг + його прочитати. + + + + + + Vercel AI Gateway маршрутизує запити до висхідного провайдера на основі + префікса посилання на модель. Наприклад, `vercel-ai-gateway/anthropic/claude-opus-4.6` маршрутизується + через Anthropic, а `vercel-ai-gateway/openai/gpt-5.4` — через + OpenAI. Ваш єдиний `AI_GATEWAY_API_KEY` забезпечує автентифікацію для всіх + висхідних провайдерів. + + + +## Пов’язане + + + + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. + + + Загальне усунення несправностей і поширені запитання. + +