chore(i18n): refresh uk translations
This commit is contained in:
parent
b4373d3ebd
commit
dfd9559dbc
@ -1,15 +1,15 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати моделі OpenAI в OpenClaw
|
||||
- Ви хочете використовувати автентифікацію за підпискою Codex замість ключів API
|
||||
- Ви хочете автентифікацію через підписку Codex замість API-ключів
|
||||
- Вам потрібна суворіша поведінка виконання агента GPT-5
|
||||
summary: Використовуйте OpenAI через ключі API або підписку Codex в OpenClaw
|
||||
summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw
|
||||
title: OpenAI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-21T20:52:33Z"
|
||||
generated_at: "2026-04-22T13:02:14Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 692615b77885c0387d339d47c02ff056ba95d3608aa681882893a46d2a0f723f
|
||||
source_hash: 7b0035cb879563a169294269e2fb39884194ec219373bc6e3edb1a8b47660b29
|
||||
source_path: providers/openai.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -18,22 +18,22 @@ x-i18n:
|
||||
|
||||
OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два шляхи автентифікації:
|
||||
|
||||
- **Ключ API** — прямий доступ до OpenAI Platform з оплатою за використання (моделі `openai/*`)
|
||||
- **Підписка Codex** — вхід через ChatGPT/Codex з доступом за підпискою (моделі `openai-codex/*`)
|
||||
- **API key** — прямий доступ до OpenAI Platform з тарифікацією за використання (`openai/*` моделі)
|
||||
- **Codex subscription** — вхід через ChatGPT/Codex з доступом за підпискою (`openai-codex/*` моделі)
|
||||
|
||||
OpenAI офіційно підтримує використання OAuth за підпискою в зовнішніх інструментах і робочих процесах, таких як OpenClaw.
|
||||
OpenAI явно підтримує використання OAuth-підписки у зовнішніх інструментах і робочих процесах, таких як OpenClaw.
|
||||
|
||||
## Початок роботи
|
||||
|
||||
Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
|
||||
Оберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Ключ API (OpenAI Platform)">
|
||||
**Найкраще підходить для:** прямого доступу до API та оплати за використання.
|
||||
<Tab title="API key (OpenAI Platform)">
|
||||
**Найкраще підходить для:** прямого доступу до API та тарифікації за використання.
|
||||
|
||||
<Steps>
|
||||
<Step title="Отримайте свій ключ API">
|
||||
Створіть або скопіюйте ключ API з [панелі OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
<Step title="Отримайте свій API key">
|
||||
Створіть або скопіюйте API key з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
</Step>
|
||||
<Step title="Запустіть початкове налаштування">
|
||||
```bash
|
||||
@ -46,14 +46,14 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Переконайтеся, що модель доступна">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider openai
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Підсумок маршруту
|
||||
### Підсумок маршрутів
|
||||
|
||||
| Посилання на модель | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
@ -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>
|
||||
|
||||
### Приклад конфігурації
|
||||
@ -79,8 +79,8 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Підписка Codex">
|
||||
**Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого ключа API. Для Codex cloud потрібен вхід через ChatGPT.
|
||||
<Tab title="Codex subscription">
|
||||
**Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу в ChatGPT.
|
||||
|
||||
<Steps>
|
||||
<Step title="Запустіть Codex OAuth">
|
||||
@ -94,27 +94,27 @@ 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
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Підсумок маршруту
|
||||
### Підсумок маршрутів
|
||||
|
||||
| Посилання на модель | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Вхід Codex |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід Codex (залежить від доступу) |
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Вхід через Codex |
|
||||
| `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 key для прямого доступу до Platform, а `openai-codex/*` — для доступу через підписку Codex.
|
||||
</Note>
|
||||
|
||||
### Приклад конфігурації
|
||||
@ -126,7 +126,7 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
```
|
||||
|
||||
<Tip>
|
||||
Якщо під час початкового налаштування повторно використовується наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex.
|
||||
Якщо початкове налаштування повторно використовує наявний вхід Codex CLI, цими обліковими даними надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex і записує оновлені облікові дані назад у сховище Codex.
|
||||
</Tip>
|
||||
|
||||
### Обмеження вікна контексту
|
||||
@ -135,10 +135,10 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
|
||||
Для `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>
|
||||
@ -163,13 +163,13 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
|
||||
Вбудований Plugin `openai` реєструє генерацію зображень через інструмент `image_generate`.
|
||||
|
||||
| Можливість | Значення |
|
||||
| ------------------------- | ---------------------------------- |
|
||||
| Модель за замовчуванням | `openai/gpt-image-2` |
|
||||
| Макс. кількість зображень на запит | 4 |
|
||||
| Можливість | Значення |
|
||||
| ------------------------- | ------------------------------------ |
|
||||
| Модель за замовчуванням | `openai/gpt-image-2` |
|
||||
| Макс. кількість зображень на запит | 4 |
|
||||
| Режим редагування | Увімкнено (до 5 еталонних зображень) |
|
||||
| Перевизначення розміру | Підтримується, зокрема розміри 2K/4K |
|
||||
| Співвідношення сторін / роздільна здатність | Не передаються до OpenAI Images API |
|
||||
| Перевизначення розміру | Підтримується, включно з розмірами 2K/4K |
|
||||
| Співвідношення сторін / роздільна здатність | Не передається до OpenAI Images API |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -182,33 +182,33 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
```
|
||||
|
||||
<Note>
|
||||
Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку аварійного перемикання.
|
||||
Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
|
||||
</Note>
|
||||
|
||||
`gpt-image-2` є моделлю за замовчуванням як для генерації зображень із тексту в OpenAI, так і для редагування зображень. `gpt-image-1` і надалі можна використовувати як явне перевизначення моделі, але нові робочі процеси OpenAI для зображень мають використовувати `openai/gpt-image-2`.
|
||||
`gpt-image-2` є типовою моделлю як для генерації зображень з тексту в OpenAI, так і для редагування зображень. `gpt-image-1` і далі можна використовувати як явне перевизначення моделі, але нові робочі процеси OpenAI для зображень мають використовувати `openai/gpt-image-2`.
|
||||
|
||||
Генерація:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Відполірований постер запуску для OpenClaw на macOS" size=3840x2160 count=1
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Відполірований постер запуску OpenClaw на macOS" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
Редагування:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Збережи форму об’єкта, зміни матеріал на напівпрозоре скло" image=/path/to/reference.png size=1024x1536
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Збережи форму об’єкта, зміни матеріал на прозоре скло" image=/path/to/reference.png size=1024x1536
|
||||
```
|
||||
|
||||
## Генерація відео
|
||||
|
||||
Вбудований Plugin `openai` реєструє генерацію відео через інструмент `video_generate`.
|
||||
|
||||
| Можливість | Значення |
|
||||
| ---------------- | --------------------------------------------------------------------------------- |
|
||||
| Модель за замовчуванням | `openai/sora-2` |
|
||||
| Режими | Текст у відео, зображення у відео, редагування одного відео |
|
||||
| Вхідні еталонні дані | 1 зображення або 1 відео |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Можливість | Значення |
|
||||
| ---------------- | -------------------------------------------------------------------------------- |
|
||||
| Модель за замовчуванням | `openai/sora-2` |
|
||||
| Режими | Текст у відео, зображення у відео, редагування одного відео |
|
||||
| Еталонні вхідні дані | 1 зображення або 1 відео |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента |
|
||||
|
||||
```json5
|
||||
@ -222,23 +222,25 @@ OpenAI офіційно підтримує використання OAuth за
|
||||
```
|
||||
|
||||
<Note>
|
||||
Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку аварійного перемикання.
|
||||
Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
|
||||
</Note>
|
||||
|
||||
## Внесок у промпт GPT-5
|
||||
## Внесок у prompt GPT-5
|
||||
|
||||
OpenClaw додає внесок у промпт GPT-5, специфічний для OpenAI, для запусків сімейства GPT-5 `openai/*` і `openai-codex/*`. Він розташований у вбудованому Plugin OpenAI, застосовується до ідентифікаторів моделей, таких як `gpt-5`, `gpt-5.2`, `gpt-5.4` і `gpt-5.4-mini`, і не застосовується до старіших моделей GPT-4.x.
|
||||
OpenClaw додає специфічний для OpenAI внесок у prompt 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 додає контракт поведінки з тегами для збереження персони, безпеки виконання, дисципліни використання інструментів, форми виводу, перевірок завершення та верифікації. Специфічна для каналу поведінка відповіді та тихих повідомлень залишається у спільному системному промпті OpenClaw і політиці вихідної доставки. Настанови GPT-5 завжди ввімкнені для відповідних моделей. Шар дружнього стилю взаємодії є окремим і налаштовуваним.
|
||||
Вбудований провайдер нативного harness Codex (`codex/*`) застосовує ту саму поведінку GPT-5 і накладення Heartbeat через інструкції розробника app-server Codex, тому сесії `codex/gpt-5.x` зберігають ту саму наполегливість у доведенні справ до кінця та проактивні вказівки Heartbeat, навіть попри те, що рештою prompt harness керує Codex.
|
||||
|
||||
| Значення | Ефект |
|
||||
| ---------------------- | ------------------------------------------- |
|
||||
| `"friendly"` (за замовчуванням) | Увімкнути шар дружнього стилю взаємодії |
|
||||
| `"on"` | Псевдонім для `"friendly"` |
|
||||
| `"off"` | Вимкнути лише шар дружнього стилю |
|
||||
Внесок GPT-5 додає позначений контракт поведінки для збереження персонажу, безпеки виконання, дисципліни використання інструментів, форми виводу, перевірок завершення та верифікації. Поведінка відповіді та тихих повідомлень, специфічна для каналу, залишається у спільному системному prompt OpenClaw і політиці вихідної доставки. Вказівки GPT-5 завжди увімкнені для відповідних моделей. Рівень дружнього стилю взаємодії є окремим і налаштовуваним.
|
||||
|
||||
| Значення | Ефект |
|
||||
| --------------------- | -------------------------------------------- |
|
||||
| `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії |
|
||||
| `"on"` | Псевдонім для `"friendly"` |
|
||||
| `"off"` | Вимкнути лише рівень дружнього стилю |
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Конфігурація">
|
||||
<Tab title="Config">
|
||||
```json5
|
||||
{
|
||||
plugins: {
|
||||
@ -257,7 +259,7 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
</Tabs>
|
||||
|
||||
<Tip>
|
||||
Під час виконання значення нечутливі до регістру, тому і `"Off"`, і `"off"` вимикають шар дружнього стилю.
|
||||
Під час виконання значення нечутливі до регістру, тож і `"Off"`, і `"off"` вимикають рівень дружнього стилю.
|
||||
</Tip>
|
||||
|
||||
## Голос і мовлення
|
||||
@ -266,15 +268,15 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
<Accordion title="Синтез мовлення (TTS)">
|
||||
Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`.
|
||||
|
||||
| Налаштування | Шлях конфігурації | За замовчуванням |
|
||||
| Налаштування | Шлях конфігурації | Типово |
|
||||
|---------|------------|---------|
|
||||
| Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
|
||||
| Голос | `messages.tts.providers.openai.voice` | `coral` |
|
||||
| Швидкість | `messages.tts.providers.openai.speed` | (не встановлено) |
|
||||
| Інструкції | `messages.tts.providers.openai.instructions` | (не встановлено, лише `gpt-4o-mini-tts`) |
|
||||
| Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових повідомлень, `mp3` для файлів |
|
||||
| Ключ API | `messages.tts.providers.openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
| Базовий URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
| Швидкість | `messages.tts.providers.openai.speed` | (не задано) |
|
||||
| Інструкції | `messages.tts.providers.openai.instructions` | (не задано, лише `gpt-4o-mini-tts`) |
|
||||
| Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових нотаток, `mp3` для файлів |
|
||||
| API key | `messages.tts.providers.openai.apiKey` | З резервним поверненням до `OPENAI_API_KEY` |
|
||||
| Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
|
||||
Доступні моделі: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Доступні голоси: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`.
|
||||
|
||||
@ -291,20 +293,20 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
```
|
||||
|
||||
<Note>
|
||||
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS без впливу на кінцеву точку API чату.
|
||||
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на кінцеву точку chat API.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Транскрибування в реальному часі">
|
||||
Вбудований Plugin `openai` реєструє транскрибування в реальному часі для Plugin Voice Call.
|
||||
<Accordion title="Транскрипція в реальному часі">
|
||||
Вбудований Plugin `openai` реєструє транскрипцію в реальному часі для Plugin Voice Call.
|
||||
|
||||
| Налаштування | Шлях конфігурації | За замовчуванням |
|
||||
| Налаштування | Шлях конфігурації | Типово |
|
||||
|---------|------------|---------|
|
||||
| Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `800` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| Ключ API | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
| API key | `...openai.apiKey` | З резервним поверненням до `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law.
|
||||
@ -315,17 +317,17 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
<Accordion title="Голос у реальному часі">
|
||||
Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call.
|
||||
|
||||
| Налаштування | Шлях конфігурації | За замовчуванням |
|
||||
| Налаштування | Шлях конфігурації | Типово |
|
||||
|---------|------------|---------|
|
||||
| Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
|
||||
| Голос | `...openai.voice` | `alloy` |
|
||||
| Температура | `...openai.temperature` | `0.8` |
|
||||
| Temperature | `...openai.temperature` | `0.8` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `500` |
|
||||
| Ключ API | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` |
|
||||
| API key | `...openai.apiKey` | З резервним поверненням до `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонаправлений виклик інструментів. Використовує аудіоформат G.711 u-law.
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двобічний виклик інструментів. Використовує формат аудіо G.711 u-law.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
@ -339,13 +341,13 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
|
||||
У режимі `"auto"` OpenClaw:
|
||||
- Повторює одну ранню помилку WebSocket перед переходом на SSE
|
||||
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE протягом охолодження
|
||||
- Додає стабільні заголовки ідентифікації сесії та ходу для повторних спроб і повторних підключень
|
||||
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження
|
||||
- Додає стабільні заголовки ідентичності сесії та ходу для повторних спроб і повторних підключень
|
||||
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту
|
||||
|
||||
| Значення | Поведінка |
|
||||
|-------|----------|
|
||||
| `"auto"` (за замовчуванням) | Спочатку WebSocket, резервно SSE |
|
||||
| `"auto"` (типово) | WebSocket first, резервний перехід на SSE |
|
||||
| `"sse"` | Примусово лише SSE |
|
||||
| `"websocket"` | Примусово лише WebSocket |
|
||||
|
||||
@ -364,16 +366,16 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
```
|
||||
|
||||
Пов’язана документація OpenAI:
|
||||
- [Realtime API через WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Потокові відповіді API (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
- [Realtime API with WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Streaming API responses (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Прогрів WebSocket">
|
||||
OpenClaw за замовчуванням вмикає прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу.
|
||||
<Accordion title="Розігрів WebSocket">
|
||||
OpenClaw типово вмикає розігрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу.
|
||||
|
||||
```json5
|
||||
// Вимкнути прогрів
|
||||
// Вимкнути розігрів
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
@ -392,8 +394,8 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
<Accordion title="Швидкий режим">
|
||||
OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`:
|
||||
|
||||
- **Чат/UI:** `/fast status|on|off`
|
||||
- **Конфігурація:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
- **Chat/UI:** `/fast status|on|off`
|
||||
- **Config:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
|
||||
Коли його ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`.
|
||||
|
||||
@ -411,7 +413,7 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
```
|
||||
|
||||
<Note>
|
||||
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого значення за замовчуванням.
|
||||
Перевизначення сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в UI Sessions повертає сесію до налаштованого типового значення.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
@ -440,15 +442,15 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Compaction на боці сервера (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Compaction на боці сервера:
|
||||
<Accordion title="Server-side Compaction (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає server-side Compaction:
|
||||
|
||||
- Примусово встановлює `store: true` (якщо тільки сумісність моделі не задає `supportsStore: false`)
|
||||
- Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- `compact_threshold` за замовчуванням: 70% від `contextWindow` (або `80000`, якщо значення недоступне)
|
||||
- Примусово встановлює `store: true` (якщо лише сумісність моделі не задає `supportsStore: false`)
|
||||
- Впроваджує `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- Типове значення `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо воно недоступне)
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Явно ввімкнути">
|
||||
<Tab title="Увімкнути явно">
|
||||
Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses:
|
||||
|
||||
```json5
|
||||
@ -501,7 +503,7 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
`responsesServerCompaction` керує лише вставкою `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`.
|
||||
`responsesServerCompaction` керує лише впровадженням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
@ -520,30 +522,30 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
```
|
||||
|
||||
Із `strict-agentic` OpenClaw:
|
||||
- Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
|
||||
- Повторює хід із вказівкою діяти негайно
|
||||
- Більше не вважає хід лише з планом успішним прогресом, якщо доступна дія з інструментом
|
||||
- Повторює хід із вказівкою діяти зараз
|
||||
- Автоматично вмикає `update_plan` для суттєвої роботи
|
||||
- Показує явний заблокований стан, якщо модель продовжує планувати без дій
|
||||
- Показує явний заблокований стан, якщо модель продовжує планувати без дії
|
||||
|
||||
<Note>
|
||||
Застосовується лише до запусків сімейства GPT-5 OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається стандартна поведінка.
|
||||
Обмежено лише запуском сімейства GPT-5 для OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають типову поведінку.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Нативні маршрути та OpenAI-сумісні маршрути">
|
||||
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI та загальні OpenAI-сумісні проксі `/v1`:
|
||||
<Accordion title="Нативні маршрути та маршрути, сумісні з OpenAI">
|
||||
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними проксі `/v1`, сумісними з OpenAI:
|
||||
|
||||
**Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI):
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують значення OpenAI `none` для effort
|
||||
- Пропускають вимкнене reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"`
|
||||
- За замовчуванням використовують строгий режим для схем інструментів
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують OpenAI `none` effort
|
||||
- Пропускають вимкнений reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"`
|
||||
- Типово встановлюють суворий режим для схем інструментів
|
||||
- Додають приховані заголовки атрибуції лише на перевірених нативних хостах
|
||||
- Зберігають формування запитів, специфічне для OpenAI (`service_tier`, `store`, сумісність reasoning, підказки prompt-cache)
|
||||
|
||||
**Проксі/сумісні маршрути:**
|
||||
- Використовують м’якшу поведінку сумісності
|
||||
- Не примушують строгі схеми інструментів або заголовки, призначені лише для нативних маршрутів
|
||||
- Не примусово встановлюють суворі схеми інструментів або заголовки, специфічні для нативних маршрутів
|
||||
|
||||
Azure OpenAI використовує нативний транспорт і поведінку сумісності, але не отримує приховані заголовки атрибуції.
|
||||
|
||||
@ -554,7 +556,7 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки аварійного перемикання.
|
||||
Вибір провайдерів, посилань на моделі та поведінки failover.
|
||||
</Card>
|
||||
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
|
||||
Спільні параметри інструмента зображень і вибір провайдера.
|
||||
@ -563,6 +565,6 @@ OpenClaw додає внесок у промпт GPT-5, специфічний
|
||||
Спільні параметри інструмента відео і вибір провайдера.
|
||||
</Card>
|
||||
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
|
||||
Докладніше про автентифікацію та правила повторного використання облікових даних.
|
||||
Докладно про автентифікацію та правила повторного використання облікових даних.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user