chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-21 01:47:59 +00:00
parent 02999cd901
commit 6c246ae5c7

View File

@ -1,27 +1,27 @@
---
read_when:
- Ви хочете використовувати моделі OpenAI в OpenClaw
- Ви хочете автентифікацію за підпискою Codex замість API-ключів
- Ви хочете автентифікацію підписки Codex замість API-ключів
- Вам потрібна суворіша поведінка виконання агента GPT-5
summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw
title: OpenAI
x-i18n:
generated_at: "2026-04-21T01:38:05Z"
generated_at: "2026-04-21T01:46:58Z"
model: gpt-5.4
provider: openai
source_hash: 4db510f037ec0dab5c2b419b242f182324543ad7feeaba515f71ed17f05a9486
source_hash: 348c864a1bcdec93534dd1a08748788013abf530ac91823fa5f0deb95b20a72c
source_path: providers/openai.md
workflow: 15
---
# OpenAI
OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два варіанти автентифікації:
OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два способи автентифікації:
- **API-ключ** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` моделі)
- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (`openai-codex/*` моделі)
- **API-ключ** — прямий доступ до OpenAI Platform з тарифікацією за використанням (моделі `openai/*`)
- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (моделі `openai-codex/*`)
OpenAI прямо підтримує використання OAuth-підписки в зовнішніх інструментах і робочих процесах, таких як OpenClaw.
OpenAI прямо підтримує використання OAuth підписки в зовнішніх інструментах і робочих процесах, таких як OpenClaw.
## Початок роботи
@ -29,11 +29,11 @@ OpenAI прямо підтримує використання OAuth-підпис
<Tabs>
<Tab title="API-ключ (OpenAI Platform)">
**Найкраще підходить для:** прямого доступу до API та оплати за використання.
**Найкраще підходить для:** прямого доступу до API та тарифікації за використанням.
<Steps>
<Step title="Отримайте свій API-ключ">
Створіть або скопіюйте API-ключ у [панелі OpenAI Platform](https://platform.openai.com/api-keys).
Створіть або скопіюйте API-ключ з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys).
</Step>
<Step title="Запустіть онбординг">
```bash
@ -46,7 +46,7 @@ OpenAI прямо підтримує використання OAuth-підпис
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
```
</Step>
<Step title="Перевірте, що модель доступна">
<Step title="Переконайтеся, що модель доступна">
```bash
openclaw models list --provider openai
```
@ -61,7 +61,7 @@ OpenAI прямо підтримує використання OAuth-підпис
| `openai/gpt-5.4-pro` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
<Note>
Вхід через ChatGPT/Codex маршрутизується через `openai-codex/*`, а не `openai/*`.
Вхід через ChatGPT/Codex спрямовується через `openai-codex/*`, а не `openai/*`.
</Note>
### Приклад конфігурації
@ -74,13 +74,13 @@ OpenAI прямо підтримує використання OAuth-підпис
```
<Warning>
OpenClaw **не** надає `openai/gpt-5.3-codex-spark` на прямому шляху API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex.
OpenClaw **не** надає `openai/gpt-5.3-codex-spark` у прямому шляху API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex.
</Warning>
</Tab>
<Tab title="Підписка Codex">
**Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud потребує входу через ChatGPT.
**Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud вимагає входу через ChatGPT.
<Steps>
<Step title="Запустіть Codex OAuth">
@ -94,12 +94,12 @@ OpenAI прямо підтримує використання OAuth-підпис
openclaw models auth login --provider openai-codex
```
</Step>
<Step title="Установіть модель за замовчуванням">
<Step title="Встановіть модель за замовчуванням">
```bash
openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4
```
</Step>
<Step title="Перевірте, що модель доступна">
<Step title="Переконайтеся, що модель доступна">
```bash
openclaw models list --provider openai-codex
```
@ -114,7 +114,7 @@ OpenAI прямо підтримує використання OAuth-підпис
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід Codex (залежить від entitlement) |
<Note>
Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex.
Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform і `openai-codex/*` для доступу через підписку Codex.
</Note>
### Приклад конфігурації
@ -126,19 +126,19 @@ OpenAI прямо підтримує використання OAuth-підпис
```
<Tip>
Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex.
Якщо онбординг повторно використовує наявний вхід Codex CLI, ці облікові дані й надалі керуються Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex.
</Tip>
### Обмеження вікна контексту
OpenClaw розглядає метадані моделі та обмеження контексту під час виконання як окремі значення.
OpenClaw розглядає метадані моделі та обмеження контексту середовища виконання як окремі значення.
Для `openai-codex/gpt-5.4`:
- Нативний `contextWindow`: `1050000`
- Обмеження `contextTokens` під час виконання за замовчуванням: `272000`
- Власний `contextWindow`: `1050000`
- Стандартне обмеження середовища виконання `contextTokens`: `272000`
Менше обмеження за замовчуванням на практиці забезпечує кращі характеристики затримки та якості. Замініть його через `contextTokens`:
Менше стандартне обмеження на практиці має кращі характеристики затримки та якості. Замініть його через `contextTokens`:
```json5
{
@ -153,7 +153,7 @@ OpenAI прямо підтримує використання OAuth-підпис
```
<Note>
Використовуйте `contextWindow`, щоб указати нативні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання.
Використовуйте `contextWindow`, щоб оголосити власні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту середовища виконання.
</Note>
</Tab>
@ -166,7 +166,7 @@ OpenAI прямо підтримує використання OAuth-підпис
| Можливість | Значення |
| ------------------------- | ---------------------------------- |
| Модель за замовчуванням | `openai/gpt-image-1` |
| Макс. кількість зображень на запит | 4 |
| Максимум зображень на запит | 4 |
| Режим редагування | Увімкнено (до 5 еталонних зображень) |
| Перевизначення розміру | Підтримується |
| Співвідношення сторін / роздільна здатність | Не передається до OpenAI Images API |
@ -182,7 +182,7 @@ OpenAI прямо підтримує використання OAuth-підпис
```
<Note>
Дивіться [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
</Note>
## Генерація відео
@ -192,8 +192,8 @@ OpenAI прямо підтримує використання OAuth-підпис
| Можливість | Значення |
| ---------------- | --------------------------------------------------------------------------------- |
| Модель за замовчуванням | `openai/sora-2` |
| Режими | Текст у відео, зображення у відео, редагування одного відео |
| Вхідні посилання | 1 зображення або 1 відео |
| Режими | Текст у відео, зображення у відео, редагування одного відео |
| Еталонні входи | 1 зображення або 1 відео |
| Перевизначення розміру | Підтримується |
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента |
@ -208,18 +208,18 @@ OpenAI прямо підтримує використання OAuth-підпис
```
<Note>
Дивіться [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
</Note>
## Внесок у промпт GPT-5
OpenClaw додає специфічний для OpenAI внесок у промпт GPT-5 для запусків сімейства GPT-5 `openai/*` і `openai-codex/*`. Він міститься у вбудованому Plugin OpenAI, застосовується до ідентифікаторів моделей, таких як `gpt-5`, `gpt-5.2`, `gpt-5.4` і `gpt-5.4-mini`, і не застосовується до старіших моделей GPT-4.x.
OpenClaw додає специфічний для OpenAI внесок у промпт GPT-5 для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*`. Він міститься у вбудованому Plugin OpenAI, застосовується до ідентифікаторів моделей, таких як `gpt-5`, `gpt-5.2`, `gpt-5.4` і `gpt-5.4-mini`, і не застосовується до старіших моделей GPT-4.x.
Внесок GPT-5 за замовчуванням додає стислий формат виводу, інструкції для викликів інструментів і поведінки з ухилом на виконання. Ці інструкції завжди ввімкнені для відповідних моделей GPT-5. Рівень дружнього стилю взаємодії є окремим і налаштовуваним.
Внесок GPT-5 додає позначений контракт поведінки для форми виводу, наполегливості інструментів, перевірок залежностей, паралельного пошуку, перевірок завершення, верифікації та автономності за замовчуванням. Ці настанови завжди ввімкнені для відповідних моделей GPT-5. Рівень дружнього стилю взаємодії є окремим і налаштовуваним.
| Значення | Ефект |
| ---------------------- | ------------------------------------------ |
| `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії |
| `"friendly"` (за замовчуванням) | Увімкнути рівень дружнього стилю взаємодії |
| `"on"` | Псевдонім для `"friendly"` |
| `"off"` | Вимкнути лише рівень дружнього стилю |
@ -252,7 +252,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Синтез мовлення (TTS)">
Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`.
| Налаштування | Шлях конфігурації | Типово |
| Налаштування | Шлях конфігурації | За замовчуванням |
|---------|------------|---------|
| Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
| Голос | `messages.tts.providers.openai.voice` | `coral` |
@ -277,7 +277,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
```
<Note>
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку API чату.
Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на кінцеву точку API чату.
</Note>
</Accordion>
@ -285,7 +285,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Транскрипція в реальному часі">
Вбудований Plugin `openai` реєструє транскрипцію в реальному часі для Plugin Voice Call.
| Налаштування | Шлях конфігурації | Типово |
| Налаштування | Шлях конфігурації | За замовчуванням |
|---------|------------|---------|
| Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
| Тривалість тиші | `...openai.silenceDurationMs` | `800` |
@ -301,7 +301,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Голос у реальному часі">
Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call.
| Налаштування | Шлях конфігурації | Типово |
| Налаштування | Шлях конфігурації | За замовчуванням |
|---------|------------|---------|
| Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
| Голос | `...openai.voice` | `alloy` |
@ -311,7 +311,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
| API-ключ | `...openai.apiKey` | Резервно використовує `OPENAI_API_KEY` |
<Note>
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двоспрямований виклик інструментів. Використовує аудіоформат G.711 u-law.
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law.
</Note>
</Accordion>
@ -320,18 +320,18 @@ OpenClaw додає специфічний для OpenAI внесок у про
## Розширена конфігурація
<AccordionGroup>
<Accordion title="Транспорт (WebSocket чи SSE)">
OpenClaw використовує спочатку WebSocket із резервним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`.
<Accordion title="Транспорт (WebSocket проти SSE)">
OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`.
У режимі `"auto"` OpenClaw:
- Повторює одну ранню помилку WebSocket перед переходом на SSE
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження
- Додає стабільні заголовки ідентифікації сеансу й ходу для повторних спроб і повторних з’єднань
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту
- Прикріплює стабільні заголовки ідентифікації сесії та ходу для повторів і повторних підключень
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) у різних варіантах транспорту
| Значення | Поведінка |
|-------|----------|
| `"auto"` (типово) | Спочатку WebSocket, резервно SSE |
| `"auto"` (за замовчуванням) | Спочатку WebSocket, резервно SSE |
| `"sse"` | Примусово лише SSE |
| `"websocket"` | Примусово лише WebSocket |
@ -355,11 +355,11 @@ OpenClaw додає специфічний для OpenAI внесок у про
</Accordion>
<Accordion title=рогрівання WebSocket">
OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*`, щоб зменшити затримку першого ходу.
<Accordion title=опередній прогрів WebSocket">
OpenClaw за замовчуванням вмикає попередній прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу.
```json5
// Вимкнути прогрівання
// Вимкнути попередній прогрів
{
agents: {
defaults: {
@ -397,7 +397,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
```
<Note>
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI Sessions повертає сеанс до налаштованого значення за замовчуванням.
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого значення за замовчуванням.
</Note>
</Accordion>
@ -421,7 +421,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
Підтримувані значення: `auto`, `default`, `flex`, `priority`.
<Warning>
`serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін.
`serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви спрямовуєте будь-якого з провайдерів через проксі, OpenClaw залишає `service_tier` без змін.
</Warning>
</Accordion>
@ -429,7 +429,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Server-side Compaction (Responses API)">
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Server-side Compaction:
- Примусово встановлює `store: true` (якщо compat моделі не задає `supportsStore: false`)
- Примусово встановлює `store: true` (якщо сумісність моделі не задає `supportsStore: false`)
- Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]`
- `compact_threshold` за замовчуванням: 70% від `contextWindow` (або `80000`, якщо недоступно)
@ -487,13 +487,13 @@ OpenClaw додає специфічний для OpenAI внесок у про
</Tabs>
<Note>
`responsesServerCompaction` керує лише вставкою `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо compat не задає `supportsStore: false`.
`responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`.
</Note>
</Accordion>
<Accordion title="Суворий агентний режим GPT">
Для запусків сімейства GPT-5 на `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання:
Для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання:
```json5
{
@ -506,31 +506,31 @@ OpenClaw додає специфічний для OpenAI внесок у про
```
З `strict-agentic` OpenClaw:
- Більше не вважає хід лише з планом успішним прогресом, якщо доступна дія інструмента
- Повторює хід із вказівкою діяти зараз
- Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
- Повторює хід зі спрямуванням на негайну дію
- Автоматично вмикає `update_plan` для суттєвої роботи
- Показує явний заблокований стан, якщо модель продовжує планувати без дій
<Note>
Застосовується лише до запусків сімейства OpenAI і Codex GPT-5. Інші провайдери та старіші сімейства моделей зберігають типову поведінку.
Поширюється лише на запуски сімейства GPT-5 OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають поведінку за замовчуванням.
</Note>
</Accordion>
<Accordion title="Нативні маршрути та маршрути, сумісні з OpenAI">
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI та загальні сумісні з OpenAI проксі `/v1`:
<Accordion title="Нативні маршрути проти OpenAI-compatible маршрутів">
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-compatible проксі `/v1`:
**Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI):
- Зберігають `reasoning: { effort: "none" }` без змін, коли reasoning явно вимкнено
- За замовчуванням використовують строгий режим для схем інструментів
- Додають приховані заголовки атрибуції лише на перевірених нативних хостах
- Зберігають формування запитів, специфічне для OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу промптів)
- Зберігають формування запитів лише для OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу промптів)
**Проксі/сумісні маршрути:**
- Використовують м’якшу compat-поведінку
- Використовують м’якшу сумісну поведінку
- Не примушують строгі схеми інструментів або нативні заголовки
Azure OpenAI використовує нативний транспорт і compat-поведінку, але не отримує прихованих заголовків атрибуції.
Azure OpenAI використовує нативний транспорт і сумісну поведінку, але не отримує приховані заголовки атрибуції.
</Accordion>
</AccordionGroup>
@ -545,9 +545,9 @@ OpenClaw додає специфічний для OpenAI внесок у про
Спільні параметри інструмента зображень і вибір провайдера.
</Card>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри відеоінструмента й вибір провайдера.
Спільні параметри інструмента відео і вибір провайдера.
</Card>
<Card title="OAuth та автентифікація" href="/uk/gateway/authentication" icon="key">
Деталі автентифікації та правила повторного використання облікових даних.
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
Докладніше про автентифікацію та правила повторного використання облікових даних.
</Card>
</CardGroup>