chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-21 04:01:22 +00:00
parent a86fc1ae6f
commit c723444602
2 changed files with 152 additions and 150 deletions

View File

@ -1,61 +1,61 @@
---
read_when:
- Ви хочете використовувати моделі OpenAI в OpenClaw
- Ви хочете автентифікацію підписки Codex замість API-ключів
- Ви хочете автентифікацію за підпискою Codex замість API-ключів
- Вам потрібна суворіша поведінка виконання агента GPT-5
summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw
title: OpenAI
x-i18n:
generated_at: "2026-04-21T01:46:58Z"
generated_at: "2026-04-21T04:00:21Z"
model: gpt-5.4
provider: openai
source_hash: 348c864a1bcdec93534dd1a08748788013abf530ac91823fa5f0deb95b20a72c
source_hash: e9ed926ed4d3cd7a0fd4e9e9859fcd81ab62134de625ccf0c66fc92c4273449f
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 key** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` models)
- **Codex subscription** — вхід через ChatGPT/Codex із доступом за підпискою (`openai-codex/*` models)
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
openclaw onboard --auth-choice openai-api-key
```
Або передайте ключ безпосередньо:
Або передайте ключ напряму:
```bash
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
```
</Step>
<Step title="Переконайтеся, що модель доступна">
<Step title="Перевірте, що модель доступна">
```bash
openclaw models list --provider openai
```
</Step>
</Steps>
### Підсумок маршрутів
### Короткий опис маршруту
| Посилання на модель | Маршрут | Автентифікація |
| Model ref | Маршрут | Автентифікація |
|-----------|-------|------|
| `openai/gpt-5.4` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
| `openai/gpt-5.4-pro` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
@ -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.
<Tab title="Codex subscription">
**Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу в ChatGPT.
<Steps>
<Step title="Запустіть Codex OAuth">
@ -88,7 +88,7 @@ OpenAI прямо підтримує використання OAuth підпис
openclaw onboard --auth-choice openai-codex
```
Або запустіть OAuth безпосередньо:
Або запустіть OAuth напряму:
```bash
openclaw models auth login --provider openai-codex
@ -99,22 +99,22 @@ OpenAI прямо підтримує використання OAuth підпис
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>
### Підсумок маршрутів
### Короткий опис маршруту
| Посилання на модель | Маршрут | Автентифікація |
| Model ref | Маршрут | Автентифікація |
|-----------|-------|------|
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Вхід Codex |
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід Codex (залежить від entitlement) |
| `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,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,19 +182,19 @@ OpenAI прямо підтримує використання OAuth підпис
```
<Note>
Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
Дивіться [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
</Note>
## Генерація відео
Вбудований Plugin `openai` реєструє генерацію відео через інструмент `video_generate`.
| Можливість | Значення |
| Можливість | Значення |
| ---------------- | --------------------------------------------------------------------------------- |
| Модель за замовчуванням | `openai/sora-2` |
| Режими | Текст у відео, зображення у відео, редагування одного відео |
| Еталонні входи | 1 зображення або 1 відео |
| Перевизначення розміру | Підтримується |
| Модель за замовчуванням | `openai/sora-2` |
| Режими | Text-to-video, image-to-video, редагування одного відео |
| Еталонні вхідні дані | 1 зображення або 1 відео |
| Перевизначення розміру | Підтримується |
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента |
```json5
@ -208,20 +208,20 @@ OpenAI прямо підтримує використання OAuth підпис
```
<Note>
Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
Дивіться [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover.
</Note>
## Внесок у промпт GPT-5
## Внесок підказки 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"` (за замовчуванням) | Увімкнути рівень дружнього стилю взаємодії |
| `"on"` | Псевдонім для `"friendly"` |
| `"off"` | Вимкнути лише рівень дружнього стилю |
| Значення | Ефект |
| ---------------------- | ------------------------------------------- |
| `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії |
| `"on"` | Псевдонім для `"friendly"` |
| `"off"` | Вимкнути лише рівень дружнього стилю |
<Tabs>
<Tab title="Конфігурація">
@ -252,14 +252,14 @@ OpenClaw додає специфічний для OpenAI внесок у про
<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` |
| 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`.
@ -277,7 +277,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
```
<Note>
Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на кінцеву точку API чату.
Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS, не впливаючи на кінцеву точку chat API.
</Note>
</Accordion>
@ -285,12 +285,12 @@ OpenClaw додає специфічний для OpenAI внесок у про
<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.
@ -301,17 +301,17 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Голос у реальному часі">
Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call.
| Налаштування | Шлях конфігурації | За замовчуванням |
| Налаштування | Шлях конфігурації | Типово |
|---------|------------|---------|
| Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
| Голос | `...openai.voice` | `alloy` |
| 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>
@ -320,18 +320,18 @@ OpenClaw додає специфічний для OpenAI внесок у про
## Розширена конфігурація
<AccordionGroup>
<Accordion title="Транспорт (WebSocket проти SSE)">
OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`.
<Accordion title="Транспорт (WebSocket vs SSE)">
OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`.
У режимі `"auto"` OpenClaw:
- Повторює одну ранню помилку WebSocket перед переходом на SSE
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження
- Прикріплює стабільні заголовки ідентифікації сесії та ходу для повторів і повторних підключень
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) у різних варіантах транспорту
- Повторює одну ранню невдачу WebSocket перед переходом на SSE
- Після збою позначає WebSocket як degraded приблизно на 60 секунд і використовує SSE під час охолодження
- Прикріплює стабільні заголовки ідентичності сеансу та ходу для повторів і перепідключень
- Нормалізує лічильники використання (`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: {
@ -378,10 +378,10 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Швидкий режим">
OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`:
- **Чат/UI:** `/fast status|on|off`
- **Chat/UI:** `/fast status|on|off`
- **Конфігурація:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
Коли ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`.
Коли його ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`.
```json5
{
@ -397,7 +397,7 @@ OpenClaw додає специфічний для OpenAI внесок у про
```
<Note>
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого значення за замовчуванням.
Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в інтерфейсі Sessions повертає сеанс до налаштованого значення за замовчуванням.
</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,12 +429,12 @@ OpenClaw додає специфічний для OpenAI внесок у про
<Accordion title="Server-side Compaction (Responses API)">
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Server-side Compaction:
- Примусово встановлює `store: true` (якщо сумісність моделі не задає `supportsStore: false`)
- Примусово встановлює `store: true` (якщо тільки сумісність моделі не задає `supportsStore: false`)
- Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]`
- `compact_threshold` за замовчуванням: 70% від `contextWindow` (або `80000`, якщо недоступно)
- Типовий `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо воно недоступне)
<Tabs>
<Tab title="Явно ввімкнути">
<Tab title="Увімкнути явно">
Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses:
```json5
@ -487,13 +487,13 @@ OpenClaw додає специфічний для OpenAI внесок у про
</Tabs>
<Note>
`responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо сумісність не задає `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
{
@ -507,30 +507,31 @@ OpenClaw додає специфічний для OpenAI внесок у про
З `strict-agentic` OpenClaw:
- Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
- Повторює хід зі спрямуванням на негайну дію
- Повторює хід із настановою діяти негайно
- Автоматично вмикає `update_plan` для суттєвої роботи
- Показує явний заблокований стан, якщо модель продовжує планувати без дій
- Показує явний стан блокування, якщо модель продовжує планувати без дії
<Note>
Поширюється лише на запуски сімейства GPT-5 OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають поведінку за замовчуванням.
Застосовується лише до запусків сімейства GPT-5 OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається типова поведінка.
</Note>
</Accordion>
<Accordion title="Нативні маршрути проти OpenAI-compatible маршрутів">
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-compatible проксі `/v1`:
<Accordion title="Нативні маршрути та маршрути, сумісні з OpenAI">
OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними проксі `/v1`, сумісними з OpenAI:
**Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI):
- Зберігають `reasoning: { effort: "none" }` без змін, коли reasoning явно вимкнено
- За замовчуванням використовують строгий режим для схем інструментів
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують OpenAI effort `none`
- Пропускають вимкнений reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"`
- Типово використовують строгий режим для схем інструментів
- Додають приховані заголовки атрибуції лише на перевірених нативних хостах
- Зберігають формування запитів лише для OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу промптів)
- Зберігають формування запитів, властиве лише OpenAI (`service_tier`, `store`, сумісність reasoning, підказки кешу підказок)
**Проксі/сумісні маршрути:**
- Використовують м’якшу сумісну поведінку
- Не примушують строгі схеми інструментів або нативні заголовки
- Використовують м’якшу поведінку сумісності
- Не примушують до строгих схем інструментів або заголовків, властивих лише нативним маршрутам
Azure OpenAI використовує нативний транспорт і сумісну поведінку, але не отримує приховані заголовки атрибуції.
Azure OpenAI використовує нативний транспорт і поведінку сумісності, але не отримує прихованих заголовків атрибуції.
</Accordion>
</AccordionGroup>
@ -542,12 +543,12 @@ OpenClaw додає специфічний для OpenAI внесок у про
Вибір провайдерів, посилань на моделі та поведінки failover.
</Card>
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
Спільні параметри інструмента зображень і вибір провайдера.
Спільні параметри інструмента для зображень і вибір провайдера.
</Card>
<Card title="Генерація відео" href="/uk/tools/video-generation" icon="video">
Спільні параметри інструмента відео і вибір провайдера.
Спільні параметри інструмента для відео і вибір провайдера.
</Card>
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
Докладніше про автентифікацію та правила повторного використання облікових даних.
Відомості про автентифікацію та правила повторного використання облікових даних.
</Card>
</CardGroup>

View File

@ -1,121 +1,122 @@
---
read_when:
- Налаштування розбору директив мислення, швидкого режиму або докладності чи значень за замовчуванням
- Налаштування аналбору директив мислення, швидкого режиму або докладного режиму чи значень за замовчуванням
summary: Синтаксис директив для /think, /fast, /verbose, /trace і видимості міркувань
title: Рівні мислення
x-i18n:
generated_at: "2026-04-17T00:29:52Z"
generated_at: "2026-04-21T04:00:16Z"
model: gpt-5.4
provider: openai
source_hash: 1cb44a7bf75546e5a8c3204e12f3297221449b881161d173dea4983da3921649
source_hash: c41d7bd19bf1dc25ba9e6bc2d706a2963e8466eeaa1c62fd01ac782ad1fc99f0
source_path: tools/thinking.md
workflow: 15
---
# Рівні мислення (директиви /think)
# Рівні мислення (/think директиви)
## Що це робить
- Вбудована директива в будь-якому вхідному тексті: `/t <level>`, `/think:<level>` або `/thinking <level>`.
- Вбудована директива в будь-якому вхідному тілі: `/t <level>`, `/think:<level>` або `/thinking <level>`.
- Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive`
- minimal → “think
- low → “think hard
- medium → “think harder
- minimal → “думати
- low → “думати ретельно
- medium → “думати ще ретельніше
- high → “ultrathink” (максимальний бюджет)
- xhigh → “ultrathink+” (GPT-5.2 + моделі Codex і зусилля Anthropic Claude Opus 4.7)
- adaptive → adaptive-мислення під керуванням провайдера (підтримується для Anthropic Claude 4.6 і Opus 4.7)
- xhigh → “ultrathink+” (зусилля GPT-5.2 + Codex models і Anthropic Claude Opus 4.7)
- adaptive → адаптивне мислення під керуванням провайдера (підтримується для Anthropic Claude 4.6 і Opus 4.7)
- `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`.
- `highest`, `max` зіставляються з `high`.
- Примітки щодо провайдерів:
- Для моделей Anthropic Claude 4.6 за замовчуванням використовується `adaptive`, якщо явний рівень мислення не задано.
- Anthropic Claude Opus 4.7 не використовує adaptive-мислення за замовчуванням. Типове значення effort у його API залишається на боці провайдера, якщо ви явно не задасте рівень мислення.
- Для Anthropic Claude Opus 4.7 `/think xhigh` зіставляється з adaptive-мисленням плюс `output_config.effort: "xhigh"`, оскільки `/think` — це директива мислення, а `xhigh` — це налаштування effort для Opus 4.7.
- MiniMax (`minimax/*`) на Anthropic-сумісному потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте мислення в параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` із ненативного Anthropic-формату потоку MiniMax.
- Z.AI (`zai/*`) підтримує лише двійкове мислення (`on`/`off`). Будь-який рівень, відмінний від `off`, обробляється як `on` (зіставляється з `low`).
- Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли мислення увімкнене, Moonshot приймає лише `tool_choice` `auto|none`; OpenClaw нормалізує несумісні значення до `auto`.
- Моделі Anthropic Claude 4.6 за замовчуванням використовують `adaptive`, якщо явний рівень мислення не задано.
- Anthropic Claude Opus 4.7 не використовує адаптивне мислення за замовчуванням. Стандартне значення effort в його API лишається на боці провайдера, якщо ви явно не встановите рівень мислення.
- Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з адаптивним мисленням плюс `output_config.effort: "xhigh"`, тому що `/think` — це директива мислення, а `xhigh` — це параметр effort для Opus 4.7.
- Моделі OpenAI GPT зіставляють `/think` через підтримку effort у Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише тоді, коли цільова модель це підтримує; інакше OpenClaw пропускає payload вимкненого reasoning замість надсилання непідтримуваного значення.
- MiniMax (`minimax/*`) на сумісному з Anthropic потоковому шляху за замовчуванням використовує `thinking: { type: "disabled" }`, якщо ви явно не встановите thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` з ненативного для Anthropic потокового формату MiniMax.
- Z.AI (`zai/*`) підтримує лише двійкове мислення (`on`/`off`). Будь-який рівень, відмінний від `off`, розглядається як `on` (зіставляється з `low`).
- Moonshot (`moonshot/*`) зіставляє `/think off` з `thinking: { type: "disabled" }`, а будь-який рівень, відмінний від `off`, — з `thinking: { type: "enabled" }`. Коли thinking увімкнено, Moonshot приймає для `tool_choice` лише `auto|none`; OpenClaw нормалізує несумісні значення до `auto`.
## Порядок визначення
1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення).
2. Перевизначення сеансу (встановлюється надсиланням повідомлення, що містить лише директиву).
3. Типове значення для агента (`agents.list[].thinkingDefault` у конфігурації).
4. Глобальне типове значення (`agents.defaults.thinkingDefault` у конфігурації).
5. Резервний варіант: `adaptive` для моделей Anthropic Claude 4.6, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано явно, `low` для інших моделей із підтримкою міркування, `off` — в інших випадках.
2. Перевизначення для сесії (встановлюється надсиланням повідомлення лише з директивою).
3. Значення за замовчуванням для агента (`agents.list[].thinkingDefault` у конфігурації).
4. Глобальне значення за замовчуванням (`agents.defaults.thinkingDefault` у конфігурації).
5. Резервний варіант: `adaptive` для моделей Anthropic Claude 4.6, `off` для Anthropic Claude Opus 4.7, якщо явно не налаштовано, `low` для інших моделей із підтримкою reasoning, інакше `off`.
## Установлення типового значення для сеансу
## Встановлення значення за замовчуванням для сесії
- Надішліть повідомлення, яке **містить лише** директиву (пробіли дозволені), наприклад `/think:medium` або `/t high`.
- Це закріплюється за поточним сеансом (типово для кожного відправника окремо); скидається через `/think:off` або скидання через неактивність сеансу.
- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сеансу залишається без змін.
- Це закріплюється для поточної сесії (типово для кожного відправника окремо); скидається через `/think:off` або через скидання після простою сесії.
- Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команду буде відхилено з підказкою, а стан сесії залишиться без змін.
- Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень мислення.
## Застосування за агентом
- **Embedded Pi**: визначений рівень передається до внутрішньопроцесного середовища виконання агента Pi.
- **Вбудований Pi**: визначений рівень передається в рантайм агента Pi у процесі.
## Швидкий режим (/fast)
- Рівні: `on|off`.
- Повідомлення, що містить лише директиву, перемикає перевизначення швидкого режиму для сеансу і повертає `Fast mode enabled.` / `Fast mode disabled.`.
- Повідомлення лише з директивою вмикає або вимикає перевизначення швидкого режиму для сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`.
- Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму.
- OpenClaw визначає швидкий режим у такому порядку:
1. Вбудована директива/директива-єдине-повідомлення `/fast on|off`
2. Перевизначення сеансу
3. Типове значення для агента (`agents.list[].fastModeDefault`)
1. Вбудована директива/повідомлення лише з директивою `/fast on|off`
2. Перевизначення для сесії
3. Значення за замовчуванням для агента (`agents.list[].fastModeDefault`)
4. Конфігурація для моделі: `agents.defaults.models["<provider>/<model>"].params.fastMode`
5. Резервний варіант: `off`
- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI шляхом надсилання `service_tier=priority` у підтримуваних запитах Responses.
- Для `openai/*` швидкий режим зіставляється з пріоритетною обробкою OpenAI через надсилання `service_tier=priority` у підтримуваних запитах Responses.
- Для `openai-codex/*` швидкий режим надсилає той самий прапорець `service_tier=priority` у Codex Responses. OpenClaw зберігає один спільний перемикач `/fast` для обох шляхів автентифікації.
- Для прямих публічних запитів `anthropic/*`, включно з трафіком, автентифікованим через OAuth і надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` встановлює `service_tier=auto`, `/fast off` встановлює `service_tier=standard_only`.
- Для `minimax/*` на Anthropic-сумісному шляху `/fast on` (або `params.fastMode: true`) переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.
- Явні параметри моделі Anthropic `serviceTier` / `service_tier` мають пріоритет над типовим значенням швидкого режиму, якщо задано обидва. OpenClaw усе одно пропускає ін’єкцію рівня сервісу Anthropic для не-Anthropic проксі-URL бази.
- Для прямих публічних запитів `anthropic/*`, включно з трафіком із OAuth-автентифікацією, надісланим до `api.anthropic.com`, швидкий режим зіставляється з рівнями сервісу Anthropic: `/fast on` встановлює `service_tier=auto`, `/fast off` встановлює `service_tier=standard_only`.
- Для `minimax/*` на сумісному з Anthropic шляху `/fast on` (або `params.fastMode: true`) переписує `MiniMax-M2.7` на `MiniMax-M2.7-highspeed`.
- Явні параметри моделі Anthropic `serviceTier` / `service_tier` мають пріоритет над значенням швидкого режиму за замовчуванням, якщо задано обидва. OpenClaw, як і раніше, пропускає додавання рівня сервісу Anthropic для проксі-базових URL, що не належать Anthropic.
## Директиви докладності (/verbose або /v)
## Докладні директиви (/verbose або /v)
- Рівні: `on` (мінімальний) | `full` | `off` (типово).
- Повідомлення, що містить лише директиву, перемикає докладність сеансу і повертає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану.
- `/verbose off` зберігає явне перевизначення сеансу; очистьте його через інтерфейс Sessions, вибравши `inherit`.
- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення.
- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності.
- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом `<emoji> <tool-name>: <arg>`, коли доступно (шлях/команда). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти.
- Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховуються, якщо verbose не `on` або `full`.
- Коли verbose має значення `full`, після завершення також пересилаються виводи інструментів (окрема бульбашка, скорочена до безпечної довжини). Якщо ви перемикаєте `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів враховують нове налаштування.
- Рівні: `on` (мінімальний) | `full` | `off` (за замовчуванням).
- Повідомлення лише з директивою вмикає або вимикає докладний режим для сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; для недійсних рівнів повертається підказка без зміни стану.
- `/verbose off` зберігає явне перевизначення для сесії; очистити його можна через інтерфейс Sessions, вибравши `inherit`.
- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні.
- Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень verbose.
- Коли verbose увімкнено, агенти, які видають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом `<emoji> <tool-name>: <arg>`, коли це доступно (path/command). Ці зведення по інструментах надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти.
- Зведення про збої інструментів залишаються видимими в нормальному режимі, але сирі суфікси з деталями помилок приховуються, якщо verbose не має значення `on` або `full`.
- Коли verbose має значення `full`, вихідні дані інструментів також пересилаються після завершення (окремою бульбашкою, обрізані до безпечної довжини). Якщо ви перемкнете `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів врахують нове налаштування.
## Директиви трасування Plugin (/trace)
- Рівні: `on` | `off` (типово).
- Повідомлення, що містить лише директиву, перемикає вивід трасування Plugin для сеансу і повертає `Plugin trace enabled.` / `Plugin trace disabled.`.
- Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сеансу/глобальні типові значення.
- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування.
- `/trace` вужчий за `/verbose`: він показує лише рядки трасування/налагодження, що належать Plugin, такі як зведення налагодження Active Memory.
- Рядки трасування можуть з’являтися в `/status` і як додаткове діагностичне повідомлення після звичайної відповіді помічника.
- Рівні: `on` | `off` (за замовчуванням).
- Повідомлення лише з директивою вмикає або вимикає вивід трасування Plugin для сесії та відповідає `Plugin trace enabled.` / `Plugin trace disabled.`.
- Вбудована директива впливає лише на це повідомлення; інакше застосовуються значення за замовчуванням для сесії/глобальні.
- Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень trace.
- `/trace` вужче за `/verbose`: воно показує лише рядки trace/debug, що належать Plugin, наприклад зведення налагодження Active Memory.
- Рядки трасування можуть з’являтися в `/status` і як діагностичне повідомлення після звичайної відповіді асистента.
## Видимість міркувань (/reasoning)
## Видимість reasoning (/reasoning)
- Рівні: `on|off|stream`.
- Повідомлення, що містить лише директиву, перемикає, чи показуються блоки мислення у відповідях.
- Коли ввімкнено, міркування надсилаються як **окреме повідомлення** з префіксом `Reasoning:`.
- `stream` (лише Telegram): транслює міркування в чернеткову бульбашку Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без міркувань.
- Повідомлення лише з директивою вмикає або вимикає показ блоків мислення у відповідях.
- Коли це увімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`.
- `stream` (лише Telegram): транслює reasoning у чернеткову бульбашку Telegram під час генерації відповіді, а потім надсилає фінальну відповідь без reasoning.
- Псевдонім: `/reason`.
- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень видимості міркувань.
- Порядок визначення: вбудована директива, потім перевизначення сеансу, потім типове значення для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`).
- Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning.
- Порядок визначення: вбудована директива, потім перевизначення для сесії, потім значення за замовчуванням для агента (`agents.list[].reasoningDefault`), потім резервний варіант (`off`).
## Пов’язане
- Документація для Elevated mode розміщена в [Elevated mode](/uk/tools/elevated).
- Документація щодо підвищеного режиму міститься в [Elevated mode](/uk/tools/elevated).
## Heartbeats
- Текст запиту Heartbeat — це налаштований промпт heartbeat (типово: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні heartbeat застосовуються як завжди (але уникайте зміни типових значень сеансу через heartbeats).
- Доставка Heartbeat типово надсилає лише фінальне корисне навантаження. Щоб також надсилати окреме повідомлення `Reasoning:` (коли доступне), встановіть `agents.defaults.heartbeat.includeReasoning: true` або для конкретного агента `agents.list[].heartbeat.includeReasoning: true`.
- Тіло проби Heartbeat — це налаштований запит Heartbeat (за замовчуванням: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Вбудовані директиви в повідомленні heartbeat застосовуються як звичайно (але уникайте зміни значень за замовчуванням для сесії через heartbeat).
- Доставка Heartbeat за замовчуванням надсилає лише фінальний payload. Щоб також надсилати окреме повідомлення `Reasoning:` (коли воно доступне), встановіть `agents.defaults.heartbeat.includeReasoning: true` або для окремого агента `agents.list[].heartbeat.includeReasoning: true`.
## Вебінтерфейс чату
## Інтерфейс вебчату
- Селектор мислення у вебчаті під час завантаження сторінки відображає збережений рівень сеансу зі сховища вхідного сеансу/конфігурації.
- Вибір іншого рівня одразу записує перевизначення сеансу через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
- Перший варіант завжди `Default (<resolved level>)`, де визначене типове значення береться з активної моделі сеансу: `adaptive` для Claude 4.6 на Anthropic, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано, `low` для інших моделей із підтримкою міркування, `off` — в інших випадках.
- Селектор мислення у вебчаті відображає збережений для сесії рівень із вхідного сховища сесії/конфігурації під час завантаження сторінки.
- Вибір іншого рівня негайно записує перевизначення для сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`.
- Перший варіант завжди `Default (<resolved level>)`, де визначене значення за замовчуванням береться з активної моделі сесії: `adaptive` для Claude 4.6 в Anthropic, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано, `low` для інших моделей із підтримкою reasoning, інакше `off`.
- Засіб вибору залишається обізнаним про провайдера:
- більшість провайдерів показують `off | minimal | low | medium | high | adaptive`
- Anthropic Claude Opus 4.7 показує `off | minimal | low | medium | high | xhigh | adaptive`
- Z.AI показує двійкові `off | on`
- `/think:<level>` як і раніше працює та оновлює той самий збережений рівень сеансу, тому директиви чату й засіб вибору залишаються синхронізованими.
- Z.AI показує двійковий варіант `off | on`
- `/think:<level>` усе ще працює й оновлює той самий збережений рівень сесії, тому директиви чату й засіб вибору залишаються синхронізованими.