chore(i18n): refresh uk translations
This commit is contained in:
parent
e71262a5a1
commit
511ce98511
@ -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>
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user