diff --git a/docs/uk/providers/claude-max-api-proxy.md b/docs/uk/providers/claude-max-api-proxy.md
index 12b2e90f9..31edf9424 100644
--- a/docs/uk/providers/claude-max-api-proxy.md
+++ b/docs/uk/providers/claude-max-api-proxy.md
@@ -1,170 +1,197 @@
---
read_when:
- - Ви хочете використовувати підписку Claude Max з OpenAI-сумісними інструментами
- - Ви хочете локальний API-сервер, який обгортає Claude Code CLI
- - Ви хочете оцінити доступ до Anthropic на основі підписки порівняно з доступом через API-ключ
-summary: Спільнотний проксі для відкриття облікових даних підписки Claude як OpenAI-сумісного endpoint
-title: Claude Max API Proxy
+ - Ви хочете використовувати підписку Claude Max з інструментами, сумісними з OpenAI
+ - Ви хочете локальний API-сервер, який обгортає CLI Claude Code
+ - Ви хочете оцінити доступ Anthropic на основі підписки порівняно з доступом на основі API-ключа
+summary: Проксі від спільноти для надання облікових даних підписки Claude як сумісної з OpenAI кінцевої точки
+title: Проксі API Claude Max
x-i18n:
- generated_at: "2026-04-05T18:13:49Z"
+ generated_at: "2026-04-12T10:19:22Z"
model: gpt-5.4
provider: openai
- source_hash: 2e125a6a46e48371544adf1331137a1db51e93e905b8c44da482cf2fba180a09
+ source_hash: 534bc3d189e68529fb090258eb0d6db6d367eb7e027ad04b1f0be55f6aa7d889
source_path: providers/claude-max-api-proxy.md
workflow: 15
---
-# Claude Max API Proxy
+# Проксі API Claude Max
-**claude-max-api-proxy** — це інструмент спільноти, який відкриває вашу підписку Claude Max/Pro як OpenAI-сумісний API endpoint. Це дозволяє використовувати вашу підписку з будь-яким інструментом, що підтримує формат OpenAI API.
+**claude-max-api-proxy** — це інструмент спільноти, який надає вашу підписку Claude Max/Pro як API-ендпойнт, сумісний з OpenAI. Це дає змогу використовувати вашу підписку з будь-яким інструментом, що підтримує формат API OpenAI.
-Цей шлях — лише технічна сумісність. У минулому Anthropic блокувала певне використання
-підписки поза Claude Code. Ви маєте самостійно вирішити, чи використовувати
-це, і перевірити поточні умови Anthropic, перш ніж покладатися на нього.
+Цей шлях є лише технічною сумісністю. У минулому Anthropic блокував певне
+використання підписки поза Claude Code. Ви повинні самостійно вирішити, чи
+використовувати це, і перевірити актуальні умови Anthropic, перш ніж покладатися на нього.
## Навіщо це використовувати?
-| Підхід | Вартість | Найкраще підходить для |
-| ----------------------- | --------------------------------------------------- | ------------------------------------------ |
-| Anthropic API | Оплата за токен (~$15/млн вхідних, $75/млн вихідних для Opus) | Продукційні застосунки, великі обсяги |
-| Claude Max subscription | $200/місяць фіксовано | Особистого використання, розробки, необмеженого використання |
+| Підхід | Вартість | Найкраще підходить для |
+| ----------------------- | --------------------------------------------------- | ----------------------------------------- |
+| API Anthropic | Оплата за токен (~$15/млн вхідних, $75/млн вихідних для Opus) | Продакшн-застосунків, великих обсягів |
+| Підписка Claude Max | $200/місяць фіксовано | Особистого використання, розробки, необмеженого використання |
-Якщо у вас є підписка Claude Max і ви хочете використовувати її з OpenAI-сумісними інструментами, цей проксі може знизити витрати для деяких сценаріїв. API-ключі залишаються більш зрозумілим з погляду політик шляхом для використання у production.
+Якщо у вас є підписка Claude Max і ви хочете використовувати її з інструментами, сумісними з OpenAI, цей проксі може зменшити витрати для деяких робочих процесів. API-ключі залишаються більш зрозумілим шляхом з погляду політик для використання у продакшні.
## Як це працює
-```
-Ваш застосунок → claude-max-api-proxy → Claude Code CLI → Anthropic (через підписку)
- (формат OpenAI) (перетворює формат) (використовує ваш вхід)
+```plaintext
+Ваш застосунок → claude-max-api-proxy → CLI Claude Code → Anthropic (через підписку)
+ (формат OpenAI) (перетворює формат) (використовує ваш вхід)
```
Проксі:
-1. Приймає запити у форматі OpenAI за адресою `http://localhost:3456/v1/chat/completions`
-2. Перетворює їх на команди Claude Code CLI
-3. Повертає відповіді у форматі OpenAI (підтримується streaming)
+1. Приймає запити у форматі OpenAI на `http://localhost:3456/v1/chat/completions`
+2. Перетворює їх на команди CLI Claude Code
+3. Повертає відповіді у форматі OpenAI (підтримується потокова передача)
-## Встановлення
+## Початок роботи
-```bash
-# Requires Node.js 20+ and Claude Code CLI
-npm install -g claude-max-api-proxy
+
+
+ Потрібні Node.js 20+ і CLI Claude Code.
-# Verify Claude CLI is authenticated
-claude --version
-```
+ ```bash
+ npm install -g claude-max-api-proxy
-## Використання
+ # Verify Claude CLI is authenticated
+ claude --version
+ ```
-### Запуск сервера
+
+
+ ```bash
+ claude-max-api
+ # Server runs at http://localhost:3456
+ ```
+
+
+ ```bash
+ # Health check
+ curl http://localhost:3456/health
-```bash
-claude-max-api
-# Server runs at http://localhost:3456
-```
+ # List models
+ curl http://localhost:3456/v1/models
-### Перевірка
+ # Chat completion
+ curl http://localhost:3456/v1/chat/completions \
+ -H "Content-Type: application/json" \
+ -d '{
+ "model": "claude-opus-4",
+ "messages": [{"role": "user", "content": "Hello!"}]
+ }'
+ ```
-```bash
-# Health check
-curl http://localhost:3456/health
+
+
+ Спрямуйте OpenClaw на проксі як на користувацький ендпойнт, сумісний з OpenAI:
-# List models
-curl http://localhost:3456/v1/models
+ ```json5
+ {
+ env: {
+ OPENAI_API_KEY: "not-needed",
+ OPENAI_BASE_URL: "http://localhost:3456/v1",
+ },
+ agents: {
+ defaults: {
+ model: { primary: "openai/claude-opus-4" },
+ },
+ },
+ }
+ ```
-# Chat completion
-curl http://localhost:3456/v1/chat/completions \
- -H "Content-Type: application/json" \
- -d '{
- "model": "claude-opus-4",
- "messages": [{"role": "user", "content": "Hello!"}]
- }'
-```
-
-### З OpenClaw
-
-Ви можете вказати для OpenClaw цей проксі як користувацький OpenAI-сумісний endpoint:
-
-```json5
-{
- env: {
- OPENAI_API_KEY: "not-needed",
- OPENAI_BASE_URL: "http://localhost:3456/v1",
- },
- agents: {
- defaults: {
- model: { primary: "openai/claude-opus-4" },
- },
- },
-}
-```
-
-Цей шлях використовує той самий проксі-подібний OpenAI-сумісний маршрут, що й інші користувацькі
-бекенди `/v1`:
-
-- власне формування запитів лише для OpenAI не застосовується
-- немає `service_tier`, немає `store` для Responses, немає підказок prompt-cache і немає
- формування payload сумісності з reasoning OpenAI
-- приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`)
- не додаються до URL проксі
+
+
## Доступні моделі
-| ID моделі | Відповідає |
-| ----------------- | ---------------- |
-| `claude-opus-4` | Claude Opus 4 |
-| `claude-sonnet-4` | Claude Sonnet 4 |
-| `claude-haiku-4` | Claude Haiku 4 |
+| ID моделі | Відповідає |
+| ----------------- | --------------- |
+| `claude-opus-4` | Claude Opus 4 |
+| `claude-sonnet-4` | Claude Sonnet 4 |
+| `claude-haiku-4` | Claude Haiku 4 |
-## Автозапуск на macOS
+## Додатково
-Створіть LaunchAgent, щоб автоматично запускати проксі:
+
+
+ Цей шлях використовує той самий маршрут сумісності з OpenAI у стилі проксі, що й інші користувацькі
+ бекенди `/v1`:
-```bash
-cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
-
-
-
-
- Label
- com.claude-max-api
- RunAtLoad
-
- KeepAlive
-
- ProgramArguments
-
- /usr/local/bin/node
- /usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js
-
- EnvironmentVariables
-
- PATH
- /usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin
-
-
-
-EOF
+ - Власне OpenAI-специфічне формування запитів не застосовується
+ - Немає `service_tier`, немає Responses `store`, немає підказок кешу промптів і немає
+ формування payload сумісності міркування OpenAI
+ - Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`)
+ не додаються до URL проксі
-launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
-```
+
+
+
+ Створіть LaunchAgent, щоб автоматично запускати проксі:
+
+ ```bash
+ cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
+
+
+
+
+ Label
+ com.claude-max-api
+ RunAtLoad
+
+ KeepAlive
+
+ ProgramArguments
+
+ /usr/local/bin/node
+ /usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js
+
+ EnvironmentVariables
+
+ PATH
+ /usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin
+
+
+
+ EOF
+
+ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
+ ```
+
+
+
## Посилання
- **npm:** [https://www.npmjs.com/package/claude-max-api-proxy](https://www.npmjs.com/package/claude-max-api-proxy)
- **GitHub:** [https://github.com/atalovesyou/claude-max-api-proxy](https://github.com/atalovesyou/claude-max-api-proxy)
-- **Issues:** [https://github.com/atalovesyou/claude-max-api-proxy/issues](https://github.com/atalovesyou/claude-max-api-proxy/issues)
+- **Проблеми:** [https://github.com/atalovesyou/claude-max-api-proxy/issues](https://github.com/atalovesyou/claude-max-api-proxy/issues)
## Примітки
-- Це **інструмент спільноти**, який офіційно не підтримується ні Anthropic, ні OpenClaw
-- Потрібна активна підписка Claude Max/Pro з автентифікованим Claude Code CLI
-- Проксі працює локально і не надсилає дані на жодні сторонні сервери
-- Streaming-відповіді повністю підтримуються
+- Це **інструмент спільноти**, який не підтримується офіційно Anthropic або OpenClaw
+- Потрібна активна підписка Claude Max/Pro з автентифікованим CLI Claude Code
+- Проксі працює локально й не надсилає дані на жодні сторонні сервери
+- Потокові відповіді повністю підтримуються
-## Дивіться також
+
+Для нативної інтеграції Anthropic з CLI Claude або API-ключами див. [провайдер Anthropic](/uk/providers/anthropic). Для підписок OpenAI/Codex див. [провайдер OpenAI](/uk/providers/openai).
+
-- [Провайдер Anthropic](/providers/anthropic) - Власна інтеграція OpenClaw із Claude CLI або API-ключами
-- [Провайдер OpenAI](/providers/openai) - Для підписок OpenAI/Codex
+## Пов’язане
+
+
+
+ Нативна інтеграція OpenClaw з CLI Claude або API-ключами.
+
+
+ Для підписок OpenAI/Codex.
+
+
+ Огляд усіх провайдерів, посилань на моделі та поведінки відмовостійкості.
+
+
+ Повний довідник з конфігурації.
+
+
diff --git a/docs/uk/providers/litellm.md b/docs/uk/providers/litellm.md
index 67c7b4511..902d09ce8 100644
--- a/docs/uk/providers/litellm.md
+++ b/docs/uk/providers/litellm.md
@@ -1,56 +1,71 @@
---
read_when:
- - Ви хочете маршрутизувати OpenClaw через проксі LiteLLM
- - Вам потрібні відстеження витрат, журналювання або маршрутизація моделей через LiteLLM
+ - Ви хочете спрямувати OpenClaw через проксі LiteLLM
+ - Вам потрібне відстеження витрат, журналювання або маршрутизація моделей через LiteLLM
summary: Запускайте OpenClaw через LiteLLM Proxy для уніфікованого доступу до моделей і відстеження витрат
title: LiteLLM
x-i18n:
- generated_at: "2026-04-05T18:14:21Z"
+ generated_at: "2026-04-12T10:19:21Z"
model: gpt-5.4
provider: openai
- source_hash: 4e8ca73458186285bc06967b397b8a008791dc58eea1159d6c358e1a794982d1
+ source_hash: 766692eb83a1be83811d8e09a970697530ffdd4f3392247cfb2927fd590364a0
source_path: providers/litellm.md
workflow: 15
---
# LiteLLM
-[LiteLLM](https://litellm.ai) — це open-source шлюз LLM, який надає уніфікований API для 100+ провайдерів моделей. Маршрутизуйте OpenClaw через LiteLLM, щоб отримати централізоване відстеження витрат, журналювання та гнучкість перемикання між бекендами без змін у конфігурації OpenClaw.
+[LiteLLM](https://litellm.ai) — це шлюз LLM з відкритим кодом, який надає уніфікований API до понад 100 постачальників моделей. Спрямуйте OpenClaw через LiteLLM, щоб отримати централізоване відстеження витрат, журналювання та гнучкість перемикання між бекендами без змін у конфігурації OpenClaw.
-## Навіщо використовувати LiteLLM з OpenClaw?
+
+**Чому варто використовувати LiteLLM з OpenClaw?**
-- **Відстеження витрат** — бачте точні витрати OpenClaw на всі моделі
-- **Маршрутизація моделей** — перемикайтеся між Claude, GPT-4, Gemini, Bedrock без змін у конфігурації
-- **Віртуальні ключі** — створюйте ключі з лімітами витрат для OpenClaw
-- **Журналювання** — повні журнали запитів/відповідей для налагодження
-- **Резервні сценарії** — автоматичне перемикання у разі відмови, якщо ваш основний провайдер недоступний
+- **Відстеження витрат** — Бачте, скільки саме OpenClaw витрачає на всі моделі
+- **Маршрутизація моделей** — Перемикайтеся між Claude, GPT-4, Gemini, Bedrock без змін конфігурації
+- **Virtual keys** — Створюйте ключі з лімітами витрат для OpenClaw
+- **Журналювання** — Повні журнали запитів/відповідей для налагодження
+- **Резервні перемикання** — Автоматичне перемикання у разі збою, якщо ваш основний постачальник недоступний
+
## Швидкий старт
-### Через онбординг
+
+
+ **Найкраще для:** найшвидшого шляху до робочого налаштування LiteLLM.
-```bash
-openclaw onboard --auth-choice litellm-api-key
-```
+
+
+ ```bash
+ openclaw onboard --auth-choice litellm-api-key
+ ```
+
+
-### Ручне налаштування
+
-1. Запустіть LiteLLM Proxy:
+
+ **Найкраще для:** повного контролю над встановленням і конфігурацією.
-```bash
-pip install 'litellm[proxy]'
-litellm --model claude-opus-4-6
-```
+
+
+ ```bash
+ pip install 'litellm[proxy]'
+ litellm --model claude-opus-4-6
+ ```
+
+
+ ```bash
+ export LITELLM_API_KEY="your-litellm-key"
-2. Спрямуйте OpenClaw до LiteLLM:
+ openclaw
+ ```
-```bash
-export LITELLM_API_KEY="your-litellm-key"
+ Ось і все. Тепер OpenClaw працює через LiteLLM.
+
+
-openclaw
-```
-
-Ось і все. Тепер OpenClaw маршрутизується через LiteLLM.
+
+
## Конфігурація
@@ -99,67 +114,88 @@ export LITELLM_API_KEY="sk-litellm-key"
}
```
-## Віртуальні ключі
+## Розширені теми
-Створіть окремий ключ для OpenClaw із лімітами витрат:
+
+
+ Створіть окремий ключ для OpenClaw з лімітами витрат:
-```bash
-curl -X POST "http://localhost:4000/key/generate" \
- -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
- -H "Content-Type: application/json" \
- -d '{
- "key_alias": "openclaw",
- "max_budget": 50.00,
- "budget_duration": "monthly"
- }'
-```
+ ```bash
+ curl -X POST "http://localhost:4000/key/generate" \
+ -H "Authorization: Bearer $LITELLM_MASTER_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "key_alias": "openclaw",
+ "max_budget": 50.00,
+ "budget_duration": "monthly"
+ }'
+ ```
-Використовуйте згенерований ключ як `LITELLM_API_KEY`.
+ Використовуйте згенерований ключ як `LITELLM_API_KEY`.
-## Маршрутизація моделей
+
-LiteLLM може маршрутизувати запити до моделей на різні бекенди. Налаштуйте це у вашому `config.yaml` LiteLLM:
+
+ LiteLLM може маршрутизувати запити до моделей на різні бекенди. Налаштуйте це у своєму `config.yaml` LiteLLM:
-```yaml
-model_list:
- - model_name: claude-opus-4-6
- litellm_params:
- model: claude-opus-4-6
- api_key: os.environ/ANTHROPIC_API_KEY
+ ```yaml
+ model_list:
+ - model_name: claude-opus-4-6
+ litellm_params:
+ model: claude-opus-4-6
+ api_key: os.environ/ANTHROPIC_API_KEY
- - model_name: gpt-4o
- litellm_params:
- model: gpt-4o
- api_key: os.environ/OPENAI_API_KEY
-```
+ - model_name: gpt-4o
+ litellm_params:
+ model: gpt-4o
+ api_key: os.environ/OPENAI_API_KEY
+ ```
-OpenClaw і далі запитує `claude-opus-4-6` — маршрутизацію виконує LiteLLM.
+ OpenClaw і далі запитуватиме `claude-opus-4-6` — маршрутизацією керуватиме LiteLLM.
-## Перегляд використання
+
-Перевіряйте панель керування LiteLLM або API:
+
+ Перевіряйте панель керування LiteLLM або API:
-```bash
-# Key info
-curl "http://localhost:4000/key/info" \
- -H "Authorization: Bearer sk-litellm-key"
+ ```bash
+ # Інформація про ключ
+ curl "http://localhost:4000/key/info" \
+ -H "Authorization: Bearer sk-litellm-key"
-# Spend logs
-curl "http://localhost:4000/spend/logs" \
- -H "Authorization: Bearer $LITELLM_MASTER_KEY"
-```
+ # Журнали витрат
+ curl "http://localhost:4000/spend/logs" \
+ -H "Authorization: Bearer $LITELLM_MASTER_KEY"
+ ```
-## Примітки
+
-- LiteLLM за замовчуванням працює на `http://localhost:4000`
-- OpenClaw підключається через сумісну з OpenAI кінцеву точку `/v1` у проксі-стилі LiteLLM
-- Нативне формування запитів лише для OpenAI не застосовується через LiteLLM:
- немає `service_tier`, немає `store` для Responses, немає підказок кешу prompt, а також немає
- формування payload для сумісності з reasoning в OpenAI
-- Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`)
- не додаються для користувацьких base URL LiteLLM
+
+ - LiteLLM за замовчуванням працює на `http://localhost:4000`
+ - OpenClaw підключається через OpenAI-сумісну `/v1` кінцеву точку LiteLLM у стилі проксі
+ - Власне формування запитів лише для OpenAI не застосовується через LiteLLM:
+ немає `service_tier`, немає `store` для Responses, немає підказок кешу промптів і немає формування OpenAI reasoning-compat payload
+ - Приховані заголовки атрибуції OpenClaw (`originator`, `version`, `User-Agent`) не додаються для користувацьких базових URL LiteLLM
+
+
-## Див. також
+
+Загальні відомості про конфігурацію постачальників і поведінку резервного перемикання див. у [Model Providers](/uk/concepts/model-providers).
+
-- [LiteLLM Docs](https://docs.litellm.ai)
-- [Model Providers](/uk/concepts/model-providers)
+## Пов’язане
+
+
+
+ Офіційна документація LiteLLM і довідник API.
+
+
+ Огляд усіх постачальників, посилань на моделі та поведінки резервного перемикання.
+
+
+ Повний довідник конфігурації.
+
+
+ Як вибирати та налаштовувати моделі.
+
+
diff --git a/docs/uk/providers/stepfun.md b/docs/uk/providers/stepfun.md
index 44ed68f6d..2337b20ae 100644
--- a/docs/uk/providers/stepfun.md
+++ b/docs/uk/providers/stepfun.md
@@ -2,158 +2,236 @@
read_when:
- Ви хочете моделі StepFun в OpenClaw
- Вам потрібні вказівки з налаштування StepFun
-summary: Використання моделей StepFun з OpenClaw
+summary: Використовуйте моделі StepFun з OpenClaw
title: StepFun
x-i18n:
- generated_at: "2026-04-05T18:15:05Z"
+ generated_at: "2026-04-12T10:19:20Z"
model: gpt-5.4
provider: openai
- source_hash: 3154852556577b4cfb387a2de281559f2b173c774bfbcaea996abe5379ae684a
+ source_hash: a463bed0951d33802dcdb3a7784406272ee206b731e9864ea020323e67b4d159
source_path: providers/stepfun.md
workflow: 15
---
# StepFun
-OpenClaw містить вбудований plugin provider StepFun із двома ID provider:
+OpenClaw містить вбудований Plugin провайдера StepFun із двома ідентифікаторами провайдерів:
-- `stepfun` для стандартної кінцевої точки
-- `stepfun-plan` для кінцевої точки Step Plan
+- `stepfun` для стандартного endpoint
+- `stepfun-plan` для endpoint Step Plan
-Наразі вбудовані каталоги відрізняються за поверхнею:
+
+Standard і Step Plan — це **окремі провайдери** з різними endpoint та префіксами ref моделей (`stepfun/...` vs `stepfun-plan/...`). Використовуйте China key з endpoint `.com` і global key з endpoint `.ai`.
+
-- Standard: `step-3.5-flash`
-- Step Plan: `step-3.5-flash`, `step-3.5-flash-2603`
+## Огляд регіонів і endpoint
-## Огляд регіонів і кінцевих точок
+| Endpoint | China (`.com`) | Global (`.ai`) |
+| --------- | -------------------------------------- | ------------------------------------- |
+| Standard | `https://api.stepfun.com/v1` | `https://api.stepfun.ai/v1` |
+| Step Plan | `https://api.stepfun.com/step_plan/v1` | `https://api.stepfun.ai/step_plan/v1` |
-- Стандартна кінцева точка China: `https://api.stepfun.com/v1`
-- Стандартна кінцева точка Global: `https://api.stepfun.ai/v1`
-- Кінцева точка China Step Plan: `https://api.stepfun.com/step_plan/v1`
-- Кінцева точка Global Step Plan: `https://api.stepfun.ai/step_plan/v1`
-- Змінна середовища auth: `STEPFUN_API_KEY`
-
-Використовуйте ключ China з кінцевими точками `.com`, а global-ключ — з
-кінцевими точками `.ai`.
-
-## Налаштування CLI
-
-Інтерактивне налаштування:
-
-```bash
-openclaw onboard
-```
-
-Виберіть один із цих варіантів auth:
-
-- `stepfun-standard-api-key-cn`
-- `stepfun-standard-api-key-intl`
-- `stepfun-plan-api-key-cn`
-- `stepfun-plan-api-key-intl`
-
-Неінтерактивні приклади:
-
-```bash
-openclaw onboard --auth-choice stepfun-standard-api-key-intl --stepfun-api-key "$STEPFUN_API_KEY"
-openclaw onboard --auth-choice stepfun-plan-api-key-intl --stepfun-api-key "$STEPFUN_API_KEY"
-```
-
-## Посилання на моделі
-
-- Стандартна модель за замовчуванням: `stepfun/step-3.5-flash`
-- Модель Step Plan за замовчуванням: `stepfun-plan/step-3.5-flash`
-- Альтернативна модель Step Plan: `stepfun-plan/step-3.5-flash-2603`
+Змінна середовища для автентифікації: `STEPFUN_API_KEY`
## Вбудовані каталоги
Standard (`stepfun`):
-| Посилання на модель | Контекст | Макс. вивід | Примітки |
-| ------------------------ | -------- | ----------- | --------------------------- |
-| `stepfun/step-3.5-flash` | 262,144 | 65,536 | Стандартна модель за замовчуванням |
+| Ref моделі | Контекст | Макс. вивід | Примітки |
+| ----------------------- | -------- | ----------- | ------------------------ |
+| `stepfun/step-3.5-flash` | 262,144 | 65,536 | Стандартна модель за замовчуванням |
Step Plan (`stepfun-plan`):
-| Посилання на модель | Контекст | Макс. вивід | Примітки |
-| ---------------------------------- | -------- | ----------- | ----------------------------- |
-| `stepfun-plan/step-3.5-flash` | 262,144 | 65,536 | Модель Step Plan за замовчуванням |
-| `stepfun-plan/step-3.5-flash-2603` | 262,144 | 65,536 | Додаткова модель Step Plan |
+| Ref моделі | Контекст | Макс. вивід | Примітки |
+| --------------------------------- | -------- | ----------- | --------------------------- |
+| `stepfun-plan/step-3.5-flash` | 262,144 | 65,536 | Модель Step Plan за замовчуванням |
+| `stepfun-plan/step-3.5-flash-2603` | 262,144 | 65,536 | Додаткова модель Step Plan |
-## Фрагменти конфігурації
+## Початок роботи
-Стандартний provider:
+Виберіть потрібний інтерфейс провайдера та виконайте кроки налаштування.
-```json5
-{
- env: { STEPFUN_API_KEY: "your-key" },
- agents: { defaults: { model: { primary: "stepfun/step-3.5-flash" } } },
- models: {
- mode: "merge",
- providers: {
- stepfun: {
- baseUrl: "https://api.stepfun.ai/v1",
- api: "openai-completions",
- apiKey: "${STEPFUN_API_KEY}",
- models: [
- {
- id: "step-3.5-flash",
- name: "Step 3.5 Flash",
- reasoning: true,
- input: ["text"],
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
- contextWindow: 262144,
- maxTokens: 65536,
+
+
+ **Найкраще підходить для:** використання загального призначення через стандартний endpoint StepFun.
+
+
+
+ | Варіант автентифікації | Endpoint | Регіон |
+ | -------------------------------- | -------------------------------- | ------------- |
+ | `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1` | Міжнародний |
+ | `stepfun-standard-api-key-cn` | `https://api.stepfun.com/v1` | China |
+
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-standard-api-key-intl
+ ```
+
+ Або для endpoint China:
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-standard-api-key-cn
+ ```
+
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-standard-api-key-intl \
+ --stepfun-api-key "$STEPFUN_API_KEY"
+ ```
+
+
+ ```bash
+ openclaw models list --provider stepfun
+ ```
+
+
+
+ ### Ref моделей
+
+ - Модель за замовчуванням: `stepfun/step-3.5-flash`
+
+
+
+
+ **Найкраще підходить для:** endpoint міркувань Step Plan.
+
+
+
+ | Варіант автентифікації | Endpoint | Регіон |
+ | ---------------------------- | --------------------------------------- | ------------- |
+ | `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1` | Міжнародний |
+ | `stepfun-plan-api-key-cn` | `https://api.stepfun.com/step_plan/v1` | China |
+
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-plan-api-key-intl
+ ```
+
+ Або для endpoint China:
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-plan-api-key-cn
+ ```
+
+
+ ```bash
+ openclaw onboard --auth-choice stepfun-plan-api-key-intl \
+ --stepfun-api-key "$STEPFUN_API_KEY"
+ ```
+
+
+ ```bash
+ openclaw models list --provider stepfun-plan
+ ```
+
+
+
+ ### Ref моделей
+
+ - Модель за замовчуванням: `stepfun-plan/step-3.5-flash`
+ - Альтернативна модель: `stepfun-plan/step-3.5-flash-2603`
+
+
+
+
+## Додатково
+
+
+
+ ```json5
+ {
+ env: { STEPFUN_API_KEY: "your-key" },
+ agents: { defaults: { model: { primary: "stepfun/step-3.5-flash" } } },
+ models: {
+ mode: "merge",
+ providers: {
+ stepfun: {
+ baseUrl: "https://api.stepfun.ai/v1",
+ api: "openai-completions",
+ apiKey: "${STEPFUN_API_KEY}",
+ models: [
+ {
+ id: "step-3.5-flash",
+ name: "Step 3.5 Flash",
+ reasoning: true,
+ input: ["text"],
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+ contextWindow: 262144,
+ maxTokens: 65536,
+ },
+ ],
},
- ],
+ },
},
- },
- },
-}
-```
+ }
+ ```
+
-Provider Step Plan:
-
-```json5
-{
- env: { STEPFUN_API_KEY: "your-key" },
- agents: { defaults: { model: { primary: "stepfun-plan/step-3.5-flash" } } },
- models: {
- mode: "merge",
- providers: {
- "stepfun-plan": {
- baseUrl: "https://api.stepfun.ai/step_plan/v1",
- api: "openai-completions",
- apiKey: "${STEPFUN_API_KEY}",
- models: [
- {
- id: "step-3.5-flash",
- name: "Step 3.5 Flash",
- reasoning: true,
- input: ["text"],
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
- contextWindow: 262144,
- maxTokens: 65536,
+
+ ```json5
+ {
+ env: { STEPFUN_API_KEY: "your-key" },
+ agents: { defaults: { model: { primary: "stepfun-plan/step-3.5-flash" } } },
+ models: {
+ mode: "merge",
+ providers: {
+ "stepfun-plan": {
+ baseUrl: "https://api.stepfun.ai/step_plan/v1",
+ api: "openai-completions",
+ apiKey: "${STEPFUN_API_KEY}",
+ models: [
+ {
+ id: "step-3.5-flash",
+ name: "Step 3.5 Flash",
+ reasoning: true,
+ input: ["text"],
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+ contextWindow: 262144,
+ maxTokens: 65536,
+ },
+ {
+ id: "step-3.5-flash-2603",
+ name: "Step 3.5 Flash 2603",
+ reasoning: true,
+ input: ["text"],
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+ contextWindow: 262144,
+ maxTokens: 65536,
+ },
+ ],
},
- {
- id: "step-3.5-flash-2603",
- name: "Step 3.5 Flash 2603",
- reasoning: true,
- input: ["text"],
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
- contextWindow: 262144,
- maxTokens: 65536,
- },
- ],
+ },
},
- },
- },
-}
-```
+ }
+ ```
+
-## Примітки
+
+ - Провайдер вбудований в OpenClaw, тому окремий крок встановлення Plugin не потрібен.
+ - `step-3.5-flash-2603` наразі доступна лише в `stepfun-plan`.
+ - Єдиний потік автентифікації записує профілі з відповідним регіоном для `stepfun` і `stepfun-plan`, тож обидва інтерфейси можна виявляти разом.
+ - Використовуйте `openclaw models list` і `openclaw models set `, щоб переглядати або перемикати моделі.
+
+
-- Provider вбудований в OpenClaw, тому окремий крок встановлення plugin не потрібен.
-- `step-3.5-flash-2603` наразі доступна лише в `stepfun-plan`.
-- Один потік auth записує профілі для обох `stepfun` і `stepfun-plan`, що відповідають регіону, тому обидві поверхні можна виявити разом.
-- Використовуйте `openclaw models list` і `openclaw models set `, щоб переглядати або перемикати моделі.
-- Загальний огляд provider див. у [Model providers](/uk/concepts/model-providers).
+
+Загальний огляд провайдерів див. у [Провайдери моделей](/uk/concepts/model-providers).
+
+
+## Пов’язане
+
+
+
+ Огляд усіх провайдерів, ref моделей і поведінки резервного перемикання.
+
+
+ Повна схема конфігурації для провайдерів, моделей і Plugin.
+
+
+ Як вибирати й налаштовувати моделі.
+
+
+ Керування API-ключами StepFun і документація.
+
+
diff --git a/docs/uk/providers/vydra.md b/docs/uk/providers/vydra.md
index f23cbd640..c54ceaa9c 100644
--- a/docs/uk/providers/vydra.md
+++ b/docs/uk/providers/vydra.md
@@ -1,150 +1,181 @@
---
read_when:
- Ви хочете генерацію медіа Vydra в OpenClaw
- - Вам потрібні вказівки з налаштування ключа API Vydra
+ - Вам потрібні вказівки щодо налаштування API-ключа Vydra
summary: Використовуйте зображення, відео та мовлення Vydra в OpenClaw
title: Vydra
x-i18n:
- generated_at: "2026-04-06T18:49:50Z"
+ generated_at: "2026-04-12T10:19:22Z"
model: gpt-5.4
provider: openai
- source_hash: 24006a687ed6f9792e7b2b10927cc7ad71c735462a92ce03d5fa7c2b2ee2fcc2
+ source_hash: ab623d14b656ce0b68d648a6393fcee3bb880077d6583e0d5c1012e91757f20e
source_path: providers/vydra.md
workflow: 15
---
# Vydra
-Вбудований плагін Vydra додає:
+Вбудований Plugin Vydra додає:
-- генерацію зображень через `vydra/grok-imagine`
-- генерацію відео через `vydra/veo3` і `vydra/kling`
-- синтез мовлення через маршрут TTS Vydra на базі ElevenLabs
+- Генерацію зображень через `vydra/grok-imagine`
+- Генерацію відео через `vydra/veo3` і `vydra/kling`
+- Синтез мовлення через TTS-маршрут Vydra на базі ElevenLabs
-OpenClaw використовує один і той самий `VYDRA_API_KEY` для всіх трьох можливостей.
+OpenClaw використовує той самий `VYDRA_API_KEY` для всіх трьох можливостей.
-## Важлива базова URL-адреса
+
+Використовуйте `https://www.vydra.ai/api/v1` як базову URL-адресу.
-Використовуйте `https://www.vydra.ai/api/v1`.
-
-Аpex-хост Vydra (`https://vydra.ai/api/v1`) наразі перенаправляє на `www`. Деякі HTTP-клієнти скидають `Authorization` під час такого перенаправлення між хостами, через що дійсний ключ API перетворюється на оманливу помилку автентифікації. Вбудований плагін використовує базову URL-адресу `www` напряму, щоб уникнути цього.
+Базовий хост Vydra (`https://vydra.ai/api/v1`) наразі перенаправляє на `www`. Деякі HTTP-клієнти скидають `Authorization` під час такого міжхостового перенаправлення, через що дійсний API-ключ перетворюється на оманливу помилку автентифікації. Щоб уникнути цього, вбудований Plugin безпосередньо використовує базову URL-адресу `www`.
+
## Налаштування
-Інтерактивне онбординг-налаштування:
+
+
+ ```bash
+ openclaw onboard --auth-choice vydra-api-key
+ ```
-```bash
-openclaw onboard --auth-choice vydra-api-key
-```
+ Або встановіть змінну середовища напряму:
-Або встановіть змінну середовища напряму:
+ ```bash
+ export VYDRA_API_KEY="vydra_live_..."
+ ```
-```bash
-export VYDRA_API_KEY="vydra_live_..."
-```
+
+
+ Виберіть одну або кілька наведених нижче можливостей (зображення, відео або мовлення) і застосуйте відповідну конфігурацію.
+
+
-## Генерація зображень
+## Можливості
-Типова модель зображень:
+
+
+ Типова модель зображень:
-- `vydra/grok-imagine`
+ - `vydra/grok-imagine`
-Зробіть її типовим постачальником зображень:
+ Зробіть її типовим постачальником зображень:
-```json5
-{
- agents: {
- defaults: {
- imageGenerationModel: {
- primary: "vydra/grok-imagine",
- },
- },
- },
-}
-```
-
-Поточна вбудована підтримка охоплює лише генерацію зображень із тексту. Хостовані маршрути редагування Vydra очікують віддалені URL-адреси зображень, а OpenClaw поки що не додає у вбудований плагін місток завантаження, специфічний для Vydra.
-
-Див. [Генерація зображень](/uk/tools/image-generation) для спільної поведінки інструмента.
-
-## Генерація відео
-
-Зареєстровані моделі відео:
-
-- `vydra/veo3` для генерації відео з тексту
-- `vydra/kling` для генерації відео із зображення
-
-Зробіть Vydra типовим постачальником відео:
-
-```json5
-{
- agents: {
- defaults: {
- videoGenerationModel: {
- primary: "vydra/veo3",
- },
- },
- },
-}
-```
-
-Примітки:
-
-- `vydra/veo3` у вбудованому вигляді підтримує лише генерацію відео з тексту.
-- `vydra/kling` наразі вимагає посилання на віддалену URL-адресу зображення. Завантаження локальних файлів одразу відхиляються.
-- Поточний HTTP-маршрут `kling` у Vydra працює непослідовно щодо того, чи вимагає він `image_url` або `video_url`; вбудований провайдер підставляє ту саму віддалену URL-адресу зображення в обидва поля.
-- Вбудований плагін дотримується консервативного підходу й не передає недокументовані параметри стилю, як-от співвідношення сторін, роздільна здатність, водяний знак або згенерований звук.
-
-Специфічне для провайдера live-покриття:
-
-```bash
-OPENCLAW_LIVE_TEST=1 \
-OPENCLAW_LIVE_VYDRA_VIDEO=1 \
-pnpm test:live -- extensions/vydra/vydra.live.test.ts
-```
-
-Тепер вбудований live-файл Vydra охоплює:
-
-- `vydra/veo3` для генерації відео з тексту
-- `vydra/kling` для генерації відео із зображення з використанням віддаленої URL-адреси зображення
-
-За потреби перевизначте фікстуру віддаленого зображення:
-
-```bash
-export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
-```
-
-Див. [Генерація відео](/uk/tools/video-generation) для спільної поведінки інструмента.
-
-## Синтез мовлення
-
-Налаштуйте Vydra як провайдера мовлення:
-
-```json5
-{
- messages: {
- tts: {
- provider: "vydra",
- providers: {
- vydra: {
- apiKey: "${VYDRA_API_KEY}",
- voiceId: "21m00Tcm4TlvDq8ikWAM",
+ ```json5
+ {
+ agents: {
+ defaults: {
+ imageGenerationModel: {
+ primary: "vydra/grok-imagine",
+ },
},
},
- },
- },
-}
-```
+ }
+ ```
-Типові значення:
+ Поточна вбудована підтримка охоплює лише text-to-image. Розміщені в Vydra маршрути редагування очікують віддалені URL-адреси зображень, а OpenClaw поки що не додає у вбудованому Plugin Vydra-специфічний міст для завантаження.
-- model: `elevenlabs/tts`
-- voice id: `21m00Tcm4TlvDq8ikWAM`
+
+ Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.
+
-Вбудований плагін наразі надає один перевірений типовий голос і повертає аудіофайли MP3.
+
+
+
+ Зареєстровані моделі відео:
+
+ - `vydra/veo3` для text-to-video
+ - `vydra/kling` для image-to-video
+
+ Зробіть Vydra типовим постачальником відео:
+
+ ```json5
+ {
+ agents: {
+ defaults: {
+ videoGenerationModel: {
+ primary: "vydra/veo3",
+ },
+ },
+ },
+ }
+ ```
+
+ Примітки:
+
+ - `vydra/veo3` у вбудованому варіанті підтримується лише як text-to-video.
+ - `vydra/kling` наразі вимагає посилання на віддалену URL-адресу зображення. Завантаження локальних файлів відхиляються одразу.
+ - Поточний HTTP-маршрут `kling` у Vydra поводиться непослідовно щодо того, чи вимагає він `image_url` або `video_url`; вбудований постачальник зіставляє ту саму віддалену URL-адресу зображення з обома полями.
+ - Вбудований Plugin дотримується консервативного підходу і не передає недокументовані параметри стилю, як-от співвідношення сторін, роздільна здатність, водяний знак або згенероване аудіо.
+
+
+ Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.
+
+
+
+
+
+ Спеціальне live-покриття для постачальника:
+
+ ```bash
+ OPENCLAW_LIVE_TEST=1 \
+ OPENCLAW_LIVE_VYDRA_VIDEO=1 \
+ pnpm test:live -- extensions/vydra/vydra.live.test.ts
+ ```
+
+ Вбудований live-файл Vydra тепер охоплює:
+
+ - `vydra/veo3` text-to-video
+ - `vydra/kling` image-to-video з використанням віддаленої URL-адреси зображення
+
+ За потреби перевизначте віддалений фікстур зображення:
+
+ ```bash
+ export OPENCLAW_LIVE_VYDRA_KLING_IMAGE_URL="https://example.com/reference.png"
+ ```
+
+
+
+
+ Задайте Vydra як постачальника мовлення:
+
+ ```json5
+ {
+ messages: {
+ tts: {
+ provider: "vydra",
+ providers: {
+ vydra: {
+ apiKey: "${VYDRA_API_KEY}",
+ voiceId: "21m00Tcm4TlvDq8ikWAM",
+ },
+ },
+ },
+ },
+ }
+ ```
+
+ Типові значення:
+
+ - Модель: `elevenlabs/tts`
+ - ID голосу: `21m00Tcm4TlvDq8ikWAM`
+
+ Вбудований Plugin наразі надає один перевірений типовий голос і повертає аудіофайли MP3.
+
+
+
## Пов’язане
-- [Каталог провайдерів](/uk/providers/index)
-- [Генерація зображень](/uk/tools/image-generation)
-- [Генерація відео](/uk/tools/video-generation)
+
+
+ Перегляньте всіх доступних постачальників.
+
+
+ Спільні параметри інструмента зображень і вибір постачальника.
+
+
+ Спільні параметри інструмента відео і вибір постачальника.
+
+
+ Типові значення агентів і конфігурація моделей.
+
+
diff --git a/docs/uk/providers/xai.md b/docs/uk/providers/xai.md
index 9d0244ce3..eeb1dfef7 100644
--- a/docs/uk/providers/xai.md
+++ b/docs/uk/providers/xai.md
@@ -5,124 +5,179 @@ read_when:
summary: Використовуйте моделі xAI Grok в OpenClaw
title: xAI
x-i18n:
- generated_at: "2026-04-05T22:23:18Z"
+ generated_at: "2026-04-12T10:19:22Z"
model: gpt-5.4
provider: openai
- source_hash: 64bc899655427cc10bdc759171c7d1ec25ad9f1e4f9d803f1553d3d586c6d71d
+ source_hash: 064aa758f9791f704dc6b0cc0059bb73b7de68ae2edd731bb87dbc26730eea9f
source_path: providers/xai.md
workflow: 15
---
# xAI
-OpenClaw постачається з вбудованим plugin провайдера `xai` для моделей Grok.
+OpenClaw постачається з вбудованим Plugin провайдера `xai` для моделей Grok.
-## Налаштування
+## Початок роботи
-1. Створіть API-ключ у консолі xAI.
-2. Встановіть `XAI_API_KEY` або виконайте:
+
+
+ Створіть API-ключ у [консолі xAI](https://console.x.ai/).
+
+
+ Установіть `XAI_API_KEY` або виконайте:
-```bash
-openclaw onboard --auth-choice xai-api-key
-```
+ ```bash
+ openclaw onboard --auth-choice xai-api-key
+ ```
-3. Виберіть модель, наприклад:
+
+
+ ```json5
+ {
+ agents: { defaults: { model: { primary: "xai/grok-4" } } },
+ }
+ ```
+
+
-```json5
-{
- agents: { defaults: { model: { primary: "xai/grok-4" } } },
-}
-```
-
-Тепер OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Той самий
-`XAI_API_KEY` також можна використовувати для `web_search` на базі Grok, нативного `x_search`
-і віддаленого `code_execution`.
+
+OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Той самий
+`XAI_API_KEY` також може забезпечувати роботу `web_search` на базі Grok, вбудованого `x_search`
+та віддаленого `code_execution`.
Якщо ви зберігаєте ключ xAI у `plugins.entries.xai.config.webSearch.apiKey`,
-вбудований провайдер моделей xAI тепер також повторно використовує цей ключ як резервний варіант.
-Налаштування `code_execution` розміщено в `plugins.entries.xai.config.codeExecution`.
+вбудований провайдер моделей xAI також повторно використовує цей ключ як резервний варіант.
+Налаштування `code_execution` розміщуються в `plugins.entries.xai.config.codeExecution`.
+
-## Поточний каталог вбудованих моделей
+## Каталог вбудованих моделей
-OpenClaw тепер містить ці сімейства моделей xAI з коробки:
+OpenClaw містить такі сімейства моделей xAI з коробки:
-- `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast`
-- `grok-4`, `grok-4-0709`
-- `grok-4-fast`, `grok-4-fast-non-reasoning`
-- `grok-4-1-fast`, `grok-4-1-fast-non-reasoning`
-- `grok-4.20-beta-latest-reasoning`, `grok-4.20-beta-latest-non-reasoning`
-- `grok-code-fast-1`
+| Сімейство | Ідентифікатори моделей |
+| ------------- | -------------------------------------------------------------------------- |
+| Grok 3 | `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast` |
+| Grok 4 | `grok-4`, `grok-4-0709` |
+| Grok 4 Fast | `grok-4-fast`, `grok-4-fast-non-reasoning` |
+| Grok 4.1 Fast | `grok-4-1-fast`, `grok-4-1-fast-non-reasoning` |
+| Grok 4.20 Beta | `grok-4.20-beta-latest-reasoning`, `grok-4.20-beta-latest-non-reasoning` |
+| Grok Code | `grok-code-fast-1` |
-Plugin також напряму визначає новіші ідентифікатори `grok-4*` і `grok-code-fast*`, коли
+Plugin також перенаправлено розпізнає новіші ідентифікатори `grok-4*` і `grok-code-fast*`, коли
вони відповідають тій самій формі API.
-Примітки щодо швидких моделей:
+
+`grok-4-fast`, `grok-4-1-fast` і варіанти `grok-4.20-beta-*` —
+це поточні посилання Grok з підтримкою зображень у вбудованому каталозі.
+
-- `grok-4-fast`, `grok-4-1-fast` і варіанти `grok-4.20-beta-*` — це
- поточні посилання Grok з підтримкою зображень у вбудованому каталозі.
-- `/fast on` або `agents.defaults.models["xai/"].params.fastMode: true`
- переписує нативні запити xAI таким чином:
- - `grok-3` -> `grok-3-fast`
- - `grok-3-mini` -> `grok-3-mini-fast`
- - `grok-4` -> `grok-4-fast`
- - `grok-4-0709` -> `grok-4-fast`
+### Відображення Fast-mode
-Застарілі псевдоніми сумісності, як і раніше, нормалізуються до канонічних вбудованих ідентифікаторів. Наприклад:
+`/fast on` або `agents.defaults.models["xai/"].params.fastMode: true`
+перезаписує нативні запити xAI таким чином:
-- `grok-4-fast-reasoning` -> `grok-4-fast`
-- `grok-4-1-fast-reasoning` -> `grok-4-1-fast`
-- `grok-4.20-reasoning` -> `grok-4.20-beta-latest-reasoning`
-- `grok-4.20-non-reasoning` -> `grok-4.20-beta-latest-non-reasoning`
+| Вихідна модель | Ціль Fast-mode |
+| -------------- | ----------------- |
+| `grok-3` | `grok-3-fast` |
+| `grok-3-mini` | `grok-3-mini-fast` |
+| `grok-4` | `grok-4-fast` |
+| `grok-4-0709` | `grok-4-fast` |
-## Вебпошук
+### Застарілі аліаси сумісності
-Вбудований провайдер вебпошуку `grok` також використовує `XAI_API_KEY`:
+Застарілі аліаси й далі нормалізуються до канонічних вбудованих ідентифікаторів:
-```bash
-openclaw config set tools.web.search.provider grok
-```
+| Застарілий аліас | Канонічний ідентифікатор |
+| ------------------------ | ----------------------------------- |
+| `grok-4-fast-reasoning` | `grok-4-fast` |
+| `grok-4-1-fast-reasoning` | `grok-4-1-fast` |
+| `grok-4.20-reasoning` | `grok-4.20-beta-latest-reasoning` |
+| `grok-4.20-non-reasoning` | `grok-4.20-beta-latest-non-reasoning` |
-## Генерація відео
+## Можливості
-Вбудований plugin `xai` також реєструє генерацію відео через спільний
-інструмент `video_generate`.
+
+
+ Вбудований провайдер веб-пошуку `grok` також використовує `XAI_API_KEY`:
-- Модель відео за замовчуванням: `xai/grok-imagine-video`
-- Режими: text-to-video, image-to-video і віддалені потоки редагування/розширення відео
-- Підтримує `aspectRatio` і `resolution`
-- Поточне обмеження: локальні відеобуфери не приймаються; використовуйте віддалені URL-адреси `http(s)`
- для вхідних даних відео-посилань/редагування
+ ```bash
+ openclaw config set tools.web.search.provider grok
+ ```
-Щоб використовувати xAI як провайдера відео за замовчуванням:
+
-```json5
-{
- agents: {
- defaults: {
- videoGenerationModel: {
- primary: "xai/grok-imagine-video",
+
+ Вбудований Plugin `xai` реєструє генерацію відео через спільний
+ інструмент `video_generate`.
+
+ - Модель відео за замовчуванням: `xai/grok-imagine-video`
+ - Режими: text-to-video, image-to-video та віддалені потоки редагування/розширення відео
+ - Підтримує `aspectRatio` і `resolution`
+
+
+ Локальні буфери відео не приймаються. Використовуйте віддалені URL `http(s)` для
+ посилань на відео та вхідних даних редагування.
+
+
+ Щоб використовувати xAI як провайдера відео за замовчуванням:
+
+ ```json5
+ {
+ agents: {
+ defaults: {
+ videoGenerationModel: {
+ primary: "xai/grok-imagine-video",
+ },
+ },
},
- },
- },
-}
-```
+ }
+ ```
-Перегляньте [Генерація відео](/uk/tools/video-generation) для спільних параметрів
-інструмента, вибору провайдера та поведінки failover.
+
+ Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента,
+ вибір провайдера та поведінку перемикання на резервний варіант.
+
-## Відомі обмеження
+
-- Наразі автентифікація підтримується лише через API-ключ. Потоку OAuth/device-code для xAI в OpenClaw поки немає.
-- `grok-4.20-multi-agent-experimental-beta-0304` не підтримується у звичайному шляху провайдера xAI, оскільки він потребує іншої поверхні API вищого рівня, ніж стандартний транспорт xAI в OpenClaw.
+
+ - Наразі автентифікація підтримується лише через API-ключ. У
+ OpenClaw поки немає потоку xAI OAuth або device-code.
+ - `grok-4.20-multi-agent-experimental-beta-0304` не підтримується у
+ звичайному шляху провайдера xAI, оскільки він вимагає іншої поверхні
+ upstream API, ніж стандартний транспорт xAI в OpenClaw.
+
-## Примітки
+
+ - OpenClaw автоматично застосовує виправлення сумісності, специфічні для xAI, для схем інструментів і викликів інструментів
+ у спільному шляху виконання.
+ - Для нативних запитів xAI за замовчуванням використовується `tool_stream: true`. Установіть
+ `agents.defaults.models["xai/"].params.tool_stream` у `false`, щоб
+ вимкнути це.
+ - Вбудована обгортка xAI вилучає непідтримувані строгі прапорці схем інструментів і
+ ключі payload reasoning перед надсиланням нативних запитів xAI.
+ - `web_search`, `x_search` і `code_execution` доступні як інструменти OpenClaw.
+ OpenClaw вмикає конкретний вбудований інструмент xAI, який потрібен, усередині кожного запиту інструмента,
+ замість того щоб прикріплювати всі нативні інструменти до кожного ходу чату.
+ - `x_search` і `code_execution` належать вбудованому Plugin xAI, а не
+ жорстко закодовані в основному середовищі виконання моделі.
+ - `code_execution` — це віддалене виконання в пісочниці xAI, а не локальний
+ [`exec`](/uk/tools/exec).
+
+
-- OpenClaw автоматично застосовує виправлення сумісності, специфічні для xAI, для схем інструментів і викликів інструментів на спільному шляху виконання.
-- Для нативних запитів xAI за замовчуванням встановлено `tool_stream: true`. Встановіть
- `agents.defaults.models["xai/"].params.tool_stream` у `false`, щоб
- вимкнути це.
-- Вбудована обгортка xAI видаляє непідтримувані прапорці strict tool-schema і
- ключі payload reasoning перед надсиланням нативних запитів xAI.
-- `web_search`, `x_search` і `code_execution` надаються як інструменти OpenClaw. OpenClaw вмикає конкретну вбудовану можливість xAI, яка потрібна для кожного запиту інструмента, замість того щоб додавати всі нативні інструменти до кожного ходу чату.
-- `x_search` і `code_execution` належать вбудованому plugin xAI, а не жорстко закодовані в основне середовище виконання моделей.
-- `code_execution` — це віддалене виконання в sandbox xAI, а не локальний [`exec`](/uk/tools/exec).
-- Загальний огляд провайдерів див. у розділі [Провайдери моделей](/uk/providers/index).
+## Пов’язані матеріали
+
+
+
+ Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
+
+
+ Спільні параметри інструмента відео та вибір провайдера.
+
+
+ Ширший огляд провайдерів.
+
+
+ Поширені проблеми та способи їх вирішення.
+
+