chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-12 10:19:48 +00:00
parent 6f33330176
commit da6d13a990
5 changed files with 741 additions and 514 deletions

View File

@ -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.
<Warning>
Цей шлях — лише технічна сумісність. У минулому Anthropic блокувала певне використання
підписки поза Claude Code. Ви маєте самостійно вирішити, чи використовувати
це, і перевірити поточні умови Anthropic, перш ніж покладатися на нього.
Цей шлях є лише технічною сумісністю. У минулому Anthropic блокував певне
використання підписки поза Claude Code. Ви повинні самостійно вирішити, чи
використовувати це, і перевірити актуальні умови Anthropic, перш ніж покладатися на нього.
</Warning>
## Навіщо це використовувати?
| Підхід | Вартість | Найкраще підходить для |
| ----------------------- | --------------------------------------------------- | ------------------------------------------ |
| 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
<Steps>
<Step title="Встановіть проксі">
Потрібні 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
```
### Запуск сервера
</Step>
<Step title="Запустіть сервер">
```bash
claude-max-api
# Server runs at http://localhost:3456
```
</Step>
<Step title="Перевірте проксі">
```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
</Step>
<Step title="Налаштуйте OpenClaw">
Спрямуйте 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 проксі
</Step>
</Steps>
## Доступні моделі
| 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, щоб автоматично запускати проксі:
<AccordionGroup>
<Accordion title="Нотатки щодо проксі-стилю сумісності з OpenAI">
Цей шлях використовує той самий маршрут сумісності з OpenAI у стилі проксі, що й інші користувацькі
бекенди `/v1`:
```bash
cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.claude-max-api</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/node</string>
<string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
</array>
<key>EnvironmentVariables</key>
<dict>
<key>PATH</key>
<string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
</dict>
</dict>
</plist>
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
```
</Accordion>
<Accordion title="Автозапуск на macOS за допомогою LaunchAgent">
Створіть LaunchAgent, щоб автоматично запускати проксі:
```bash
cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.claude-max-api</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/node</string>
<string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
</array>
<key>EnvironmentVariables</key>
<dict>
<key>PATH</key>
<string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
</dict>
</dict>
</plist>
EOF
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist
```
</Accordion>
</AccordionGroup>
## Посилання
- **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
- Проксі працює локально й не надсилає дані на жодні сторонні сервери
- Потокові відповіді повністю підтримуються
## Дивіться також
<Note>
Для нативної інтеграції Anthropic з CLI Claude або API-ключами див. [провайдер Anthropic](/uk/providers/anthropic). Для підписок OpenAI/Codex див. [провайдер OpenAI](/uk/providers/openai).
</Note>
- [Провайдер Anthropic](/providers/anthropic) - Власна інтеграція OpenClaw із Claude CLI або API-ключами
- [Провайдер OpenAI](/providers/openai) - Для підписок OpenAI/Codex
## Пов’язане
<CardGroup cols={2}>
<Card title="Провайдер Anthropic" href="/uk/providers/anthropic" icon="bolt">
Нативна інтеграція OpenClaw з CLI Claude або API-ключами.
</Card>
<Card title="Провайдер OpenAI" href="/uk/providers/openai" icon="robot">
Для підписок OpenAI/Codex.
</Card>
<Card title="Провайдери моделей" href="/uk/concepts/model-providers" icon="layers">
Огляд усіх провайдерів, посилань на моделі та поведінки відмовостійкості.
</Card>
<Card title="Налаштування" href="/uk/gateway/configuration" icon="gear">
Повний довідник з конфігурації.
</Card>
</CardGroup>

View File

@ -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?
<Tip>
**Чому варто використовувати LiteLLM з OpenClaw?**
- **Відстеження витрат** — бачте точні витрати OpenClaw на всі моделі
- **Маршрутизація моделей** — перемикайтеся між Claude, GPT-4, Gemini, Bedrock без змін у конфігурації
- **Віртуальні ключі** — створюйте ключі з лімітами витрат для OpenClaw
- **Журналювання** — повні журнали запитів/відповідей для налагодження
- **Резервні сценарії** — автоматичне перемикання у разі відмови, якщо ваш основний провайдер недоступний
- **Відстеження витрат** — Бачте, скільки саме OpenClaw витрачає на всі моделі
- **Маршрутизація моделей** — Перемикайтеся між Claude, GPT-4, Gemini, Bedrock без змін конфігурації
- **Virtual keys** — Створюйте ключі з лімітами витрат для OpenClaw
- **Журналювання** — Повні журнали запитів/відповідей для налагодження
- **Резервні перемикання** — Автоматичне перемикання у разі збою, якщо ваш основний постачальник недоступний
</Tip>
## Швидкий старт
### Через онбординг
<Tabs>
<Tab title="Онбординг (рекомендовано)">
**Найкраще для:** найшвидшого шляху до робочого налаштування LiteLLM.
```bash
openclaw onboard --auth-choice litellm-api-key
```
<Steps>
<Step title="Запустіть онбординг">
```bash
openclaw onboard --auth-choice litellm-api-key
```
</Step>
</Steps>
### Ручне налаштування
</Tab>
1. Запустіть LiteLLM Proxy:
<Tab title="Ручне налаштування">
**Найкраще для:** повного контролю над встановленням і конфігурацією.
```bash
pip install 'litellm[proxy]'
litellm --model claude-opus-4-6
```
<Steps>
<Step title="Запустіть LiteLLM Proxy">
```bash
pip install 'litellm[proxy]'
litellm --model claude-opus-4-6
```
</Step>
<Step title="Спрямуйте OpenClaw до LiteLLM">
```bash
export LITELLM_API_KEY="your-litellm-key"
2. Спрямуйте OpenClaw до LiteLLM:
openclaw
```
```bash
export LITELLM_API_KEY="your-litellm-key"
Ось і все. Тепер OpenClaw працює через LiteLLM.
</Step>
</Steps>
openclaw
```
Ось і все. Тепер OpenClaw маршрутизується через LiteLLM.
</Tab>
</Tabs>
## Конфігурація
@ -99,67 +114,88 @@ export LITELLM_API_KEY="sk-litellm-key"
}
```
## Віртуальні ключі
## Розширені теми
Створіть окремий ключ для OpenClaw із лімітами витрат:
<AccordionGroup>
<Accordion title="Virtual keys">
Створіть окремий ключ для 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`.
## Маршрутизація моделей
</Accordion>
LiteLLM може маршрутизувати запити до моделей на різні бекенди. Налаштуйте це у вашому `config.yaml` LiteLLM:
<Accordion title="Маршрутизація моделей">
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.
## Перегляд використання
</Accordion>
Перевіряйте панель керування LiteLLM або API:
<Accordion title="Перегляд використання">
Перевіряйте панель керування 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"
```
## Примітки
</Accordion>
- 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
<Accordion title="Нотатки щодо поведінки проксі">
- 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
</Accordion>
</AccordionGroup>
## Див. також
<Note>
Загальні відомості про конфігурацію постачальників і поведінку резервного перемикання див. у [Model Providers](/uk/concepts/model-providers).
</Note>
- [LiteLLM Docs](https://docs.litellm.ai)
- [Model Providers](/uk/concepts/model-providers)
## Пов’язане
<CardGroup cols={2}>
<Card title="Документація LiteLLM" href="https://docs.litellm.ai" icon="book">
Офіційна документація LiteLLM і довідник API.
</Card>
<Card title="Постачальники моделей" href="/uk/concepts/model-providers" icon="layers">
Огляд усіх постачальників, посилань на моделі та поведінки резервного перемикання.
</Card>
<Card title="Конфігурація" href="/uk/gateway/configuration" icon="gear">
Повний довідник конфігурації.
</Card>
<Card title="Вибір моделі" href="/uk/concepts/models" icon="brain">
Як вибирати та налаштовувати моделі.
</Card>
</CardGroup>

View File

@ -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
Наразі вбудовані каталоги відрізняються за поверхнею:
<Warning>
Standard і Step Plan — це **окремі провайдери** з різними endpoint та префіксами ref моделей (`stepfun/...` vs `stepfun-plan/...`). Використовуйте China key з endpoint `.com` і global key з endpoint `.ai`.
</Warning>
- 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,
<Tabs>
<Tab title="Standard">
**Найкраще підходить для:** використання загального призначення через стандартний endpoint StepFun.
<Steps>
<Step title="Виберіть регіон endpoint">
| Варіант автентифікації | Endpoint | Регіон |
| -------------------------------- | -------------------------------- | ------------- |
| `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1` | Міжнародний |
| `stepfun-standard-api-key-cn` | `https://api.stepfun.com/v1` | China |
</Step>
<Step title="Запустіть онбординг">
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl
```
Або для endpoint China:
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-cn
```
</Step>
<Step title="Неінтерактивна альтернатива">
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl \
--stepfun-api-key "$STEPFUN_API_KEY"
```
</Step>
<Step title="Перевірте, що моделі доступні">
```bash
openclaw models list --provider stepfun
```
</Step>
</Steps>
### Ref моделей
- Модель за замовчуванням: `stepfun/step-3.5-flash`
</Tab>
<Tab title="Step Plan">
**Найкраще підходить для:** endpoint міркувань Step Plan.
<Steps>
<Step title="Виберіть регіон endpoint">
| Варіант автентифікації | 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 |
</Step>
<Step title="Запустіть онбординг">
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl
```
Або для endpoint China:
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-cn
```
</Step>
<Step title="Неінтерактивна альтернатива">
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl \
--stepfun-api-key "$STEPFUN_API_KEY"
```
</Step>
<Step title="Перевірте, що моделі доступні">
```bash
openclaw models list --provider stepfun-plan
```
</Step>
</Steps>
### Ref моделей
- Модель за замовчуванням: `stepfun-plan/step-3.5-flash`
- Альтернативна модель: `stepfun-plan/step-3.5-flash-2603`
</Tab>
</Tabs>
## Додатково
<AccordionGroup>
<Accordion title="Повна конфігурація: провайдер Standard">
```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,
},
],
},
],
},
},
},
},
}
```
}
```
</Accordion>
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,
<Accordion title="Повна конфігурація: провайдер 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,
},
{
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,
},
],
},
},
},
},
}
```
}
```
</Accordion>
## Примітки
<Accordion title="Примітки">
- Провайдер вбудований в OpenClaw, тому окремий крок встановлення Plugin не потрібен.
- `step-3.5-flash-2603` наразі доступна лише в `stepfun-plan`.
- Єдиний потік автентифікації записує профілі з відповідним регіоном для `stepfun` і `stepfun-plan`, тож обидва інтерфейси можна виявляти разом.
- Використовуйте `openclaw models list` і `openclaw models set <provider/model>`, щоб переглядати або перемикати моделі.
</Accordion>
</AccordionGroup>
- Provider вбудований в OpenClaw, тому окремий крок встановлення plugin не потрібен.
- `step-3.5-flash-2603` наразі доступна лише в `stepfun-plan`.
- Один потік auth записує профілі для обох `stepfun` і `stepfun-plan`, що відповідають регіону, тому обидві поверхні можна виявити разом.
- Використовуйте `openclaw models list` і `openclaw models set <provider/model>`, щоб переглядати або перемикати моделі.
- Загальний огляд provider див. у [Model providers](/uk/concepts/model-providers).
<Note>
Загальний огляд провайдерів див. у [Провайдери моделей](/uk/concepts/model-providers).
</Note>
## Пов’язане
<CardGroup cols={2}>
<Card title="Провайдери моделей" href="/uk/concepts/model-providers" icon="layers">
Огляд усіх провайдерів, ref моделей і поведінки резервного перемикання.
</Card>
<Card title="Довідник з конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
Повна схема конфігурації для провайдерів, моделей і Plugin.
</Card>
<Card title="Вибір моделі" href="/uk/concepts/models" icon="brain">
Як вибирати й налаштовувати моделі.
</Card>
<Card title="Платформа StepFun" href="https://platform.stepfun.com" icon="globe">
Керування API-ключами StepFun і документація.
</Card>
</CardGroup>

View File

@ -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-адреса
<Warning>
Використовуйте `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`.
</Warning>
## Налаштування
Інтерактивне онбординг-налаштування:
<Steps>
<Step title="Запустіть інтерактивне початкове налаштування">
```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_..."
```
</Step>
<Step title="Виберіть можливість за замовчуванням">
Виберіть одну або кілька наведених нижче можливостей (зображення, відео або мовлення) і застосуйте відповідну конфігурацію.
</Step>
</Steps>
## Генерація зображень
## Можливості
Типова модель зображень:
<AccordionGroup>
<Accordion title="Генерація зображень">
Типова модель зображень:
- `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`
<Note>
Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.
</Note>
Вбудований плагін наразі надає один перевірений типовий голос і повертає аудіофайли MP3.
</Accordion>
<Accordion title="Генерація відео">
Зареєстровані моделі відео:
- `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 дотримується консервативного підходу і не передає недокументовані параметри стилю, як-от співвідношення сторін, роздільна здатність, водяний знак або згенероване аудіо.
<Note>
Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.
</Note>
</Accordion>
<Accordion title="Live-тести відео">
Спеціальне 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"
```
</Accordion>
<Accordion title="Синтез мовлення">
Задайте Vydra як постачальника мовлення:
```json5
{
messages: {
tts: {
provider: "vydra",
providers: {
vydra: {
apiKey: "${VYDRA_API_KEY}",
voiceId: "21m00Tcm4TlvDq8ikWAM",
},
},
},
},
}
```
Типові значення:
- Модель: `elevenlabs/tts`
- ID голосу: `21m00Tcm4TlvDq8ikWAM`
Вбудований Plugin наразі надає один перевірений типовий голос і повертає аудіофайли MP3.
</Accordion>
</AccordionGroup>
## Пов’язане
- [Каталог провайдерів](/uk/providers/index)
- [Генерація зображень](/uk/tools/image-generation)
- [Генерація відео](/uk/tools/video-generation)
<CardGroup cols={2}>
<Card title="Каталог постачальників" href="/uk/providers/index" icon="list">
Перегляньте всіх доступних постачальників.
</Card>
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
Спільні параметри інструмента зображень і вибір постачальника.
</Card>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри інструмента відео і вибір постачальника.
</Card>
<Card title="Довідник із конфігурації" href="/uk/gateway/configuration-reference#agent-defaults" icon="gear">
Типові значення агентів і конфігурація моделей.
</Card>
</CardGroup>

View File

@ -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` або виконайте:
<Steps>
<Step title="Створіть API-ключ">
Створіть API-ключ у [консолі xAI](https://console.x.ai/).
</Step>
<Step title="Установіть свій API-ключ">
Установіть `XAI_API_KEY` або виконайте:
```bash
openclaw onboard --auth-choice xai-api-key
```
```bash
openclaw onboard --auth-choice xai-api-key
```
3. Виберіть модель, наприклад:
</Step>
<Step title="Виберіть модель">
```json5
{
agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
```
</Step>
</Steps>
```json5
{
agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
```
Тепер OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Той самий
`XAI_API_KEY` також можна використовувати для `web_search` на базі Grok, нативного `x_search`
і віддаленого `code_execution`.
<Note>
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`.
</Note>
## Поточний каталог вбудованих моделей
## Каталог вбудованих моделей
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.
Примітки щодо швидких моделей:
<Tip>
`grok-4-fast`, `grok-4-1-fast` і варіанти `grok-4.20-beta-*`
це поточні посилання Grok з підтримкою зображень у вбудованому каталозі.
</Tip>
- `grok-4-fast`, `grok-4-1-fast` і варіанти `grok-4.20-beta-*` — це
поточні посилання Grok з підтримкою зображень у вбудованому каталозі.
- `/fast on` або `agents.defaults.models["xai/<model>"].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/<model>"].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`.
<AccordionGroup>
<Accordion title="Веб-пошук">
Вбудований провайдер веб-пошуку `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 як провайдера відео за замовчуванням:
</Accordion>
```json5
{
agents: {
defaults: {
videoGenerationModel: {
primary: "xai/grok-imagine-video",
<Accordion title="Генерація відео">
Вбудований Plugin `xai` реєструє генерацію відео через спільний
інструмент `video_generate`.
- Модель відео за замовчуванням: `xai/grok-imagine-video`
- Режими: text-to-video, image-to-video та віддалені потоки редагування/розширення відео
- Підтримує `aspectRatio` і `resolution`
<Warning>
Локальні буфери відео не приймаються. Використовуйте віддалені URL `http(s)` для
посилань на відео та вхідних даних редагування.
</Warning>
Щоб використовувати xAI як провайдера відео за замовчуванням:
```json5
{
agents: {
defaults: {
videoGenerationModel: {
primary: "xai/grok-imagine-video",
},
},
},
},
},
}
```
}
```
Перегляньте [Генерація відео](/uk/tools/video-generation) для спільних параметрів
інструмента, вибору провайдера та поведінки failover.
<Note>
Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента,
вибір провайдера та поведінку перемикання на резервний варіант.
</Note>
## Відомі обмеження
</Accordion>
- Наразі автентифікація підтримується лише через API-ключ. Потоку OAuth/device-code для xAI в OpenClaw поки немає.
- `grok-4.20-multi-agent-experimental-beta-0304` не підтримується у звичайному шляху провайдера xAI, оскільки він потребує іншої поверхні API вищого рівня, ніж стандартний транспорт xAI в OpenClaw.
<Accordion title="Відомі обмеження">
- Наразі автентифікація підтримується лише через API-ключ. У
OpenClaw поки немає потоку xAI OAuth або device-code.
- `grok-4.20-multi-agent-experimental-beta-0304` не підтримується у
звичайному шляху провайдера xAI, оскільки він вимагає іншої поверхні
upstream API, ніж стандартний транспорт xAI в OpenClaw.
</Accordion>
## Примітки
<Accordion title="Додаткові примітки">
- OpenClaw автоматично застосовує виправлення сумісності, специфічні для xAI, для схем інструментів і викликів інструментів
у спільному шляху виконання.
- Для нативних запитів xAI за замовчуванням використовується `tool_stream: true`. Установіть
`agents.defaults.models["xai/<model>"].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).
</Accordion>
</AccordionGroup>
- OpenClaw автоматично застосовує виправлення сумісності, специфічні для xAI, для схем інструментів і викликів інструментів на спільному шляху виконання.
- Для нативних запитів xAI за замовчуванням встановлено `tool_stream: true`. Встановіть
`agents.defaults.models["xai/<model>"].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).
## Пов’язані матеріали
<CardGroup cols={2}>
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
Вибір провайдерів, посилань на моделі та поведінки резервного перемикання.
</Card>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри інструмента відео та вибір провайдера.
</Card>
<Card title="Усі провайдери" href="/uk/providers/index" icon="grid-2">
Ширший огляд провайдерів.
</Card>
<Card title="Усунення несправностей" href="/uk/help/troubleshooting" icon="wrench">
Поширені проблеми та способи їх вирішення.
</Card>
</CardGroup>