From c723444602d06765147246acc1042e38e08bc9c3 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Tue, 21 Apr 2026 04:01:22 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/providers/openai.md | 177 ++++++++++++++++++------------------ docs/uk/tools/thinking.md | 125 ++++++++++++------------- 2 files changed, 152 insertions(+), 150 deletions(-) diff --git a/docs/uk/providers/openai.md b/docs/uk/providers/openai.md index 1000d8be6..1b70eb266 100644 --- a/docs/uk/providers/openai.md +++ b/docs/uk/providers/openai.md @@ -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. ## Початок роботи Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування. - - **Найкраще підходить для:** прямого доступу до API та тарифікації за використанням. + + **Найкраще підходить для:** прямого доступу до API та оплати за використання. - - Створіть або скопіюйте API-ключ з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). + + Створіть або скопіюйте API key з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). ```bash openclaw onboard --auth-choice openai-api-key ``` - Або передайте ключ безпосередньо: + Або передайте ключ напряму: ```bash openclaw onboard --openai-api-key "$OPENAI_API_KEY" ``` - + ```bash openclaw models list --provider openai ``` - ### Підсумок маршрутів + ### Короткий опис маршруту - | Посилання на модель | Маршрут | Автентифікація | + | 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 підпис ``` - OpenClaw **не** надає `openai/gpt-5.3-codex-spark` у прямому шляху API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex. + OpenClaw **не** надає `openai/gpt-5.3-codex-spark` у прямому шляху API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише для Codex. - - **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud вимагає входу через ChatGPT. + + **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу в ChatGPT. @@ -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 ``` - + ```bash openclaw models list --provider openai-codex ``` - ### Підсумок маршрутів + ### Короткий опис маршруту - | Посилання на модель | Маршрут | Автентифікація | + | 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) | - Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform і `openai-codex/*` для доступу через підписку Codex. + Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API key для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. ### Приклад конфігурації @@ -126,19 +126,19 @@ OpenAI прямо підтримує використання OAuth підпис ``` - Якщо онбординг повторно використовує наявний вхід Codex CLI, ці облікові дані й надалі керуються Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. + Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. ### Обмеження вікна контексту - OpenClaw розглядає метадані моделі та обмеження контексту середовища виконання як окремі значення. + OpenClaw розглядає метадані моделі та обмеження контексту під час виконання як окремі значення. Для `openai-codex/gpt-5.4`: - - Власний `contextWindow`: `1050000` - - Стандартне обмеження середовища виконання `contextTokens`: `272000` + - Нативний `contextWindow`: `1050000` + - Обмеження `contextTokens` під час виконання за замовчуванням: `272000` - Менше стандартне обмеження на практиці має кращі характеристики затримки та якості. Замініть його через `contextTokens`: + Менше обмеження за замовчуванням на практиці забезпечує кращі характеристики затримки та якості. Ви можете перевизначити його через `contextTokens`: ```json5 { @@ -153,7 +153,7 @@ OpenAI прямо підтримує використання OAuth підпис ``` - Використовуйте `contextWindow`, щоб оголосити власні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту середовища виконання. + Використовуйте `contextWindow`, щоб оголосити нативні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання. @@ -166,7 +166,7 @@ OpenAI прямо підтримує використання OAuth підпис | Можливість | Значення | | ------------------------- | ---------------------------------- | | Модель за замовчуванням | `openai/gpt-image-1` | -| Максимум зображень на запит | 4 | +| Макс. кількість зображень на запит | 4 | | Режим редагування | Увімкнено (до 5 еталонних зображень) | | Перевизначення розміру | Підтримується | | Співвідношення сторін / роздільна здатність | Не передається до OpenAI Images API | @@ -182,19 +182,19 @@ OpenAI прямо підтримує використання OAuth підпис ``` -Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. +Дивіться [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. ## Генерація відео Вбудований 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 підпис ``` -Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. +Дивіться [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. -## Внесок у промпт 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"` | Вимкнути лише рівень дружнього стилю | @@ -252,14 +252,14 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований 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 внесок у про ``` - Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на кінцеву точку API чату. + Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS, не впливаючи на кінцеву точку chat API. @@ -285,12 +285,12 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований 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` | Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law. @@ -301,17 +301,17 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований 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` | - Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law. + Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонаправлений виклик інструментів. Використовує формат аудіо G.711 u-law. @@ -320,18 +320,18 @@ OpenClaw додає специфічний для OpenAI внесок у про ## Розширена конфігурація - - OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`. + + 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 внесок у про - - OpenClaw за замовчуванням вмикає попередній прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу. + + OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*`, щоб зменшити затримку першого ходу. ```json5 - // Вимкнути попередній прогрів + // Вимкнути прогрівання { agents: { defaults: { @@ -378,10 +378,10 @@ OpenClaw додає специфічний для OpenAI внесок у про OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`: - - **Чат/UI:** `/fast status|on|off` + - **Chat/UI:** `/fast status|on|off` - **Конфігурація:** `agents.defaults.models["/"].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 внесок у про ``` - Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого значення за замовчуванням. + Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в інтерфейсі Sessions повертає сеанс до налаштованого значення за замовчуванням. @@ -421,7 +421,7 @@ OpenClaw додає специфічний для OpenAI внесок у про Підтримувані значення: `auto`, `default`, `flex`, `priority`. - `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` без змін. @@ -429,12 +429,12 @@ OpenClaw додає специфічний для OpenAI внесок у про Для прямих моделей 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`, якщо воно недоступне) - + Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses: ```json5 @@ -487,13 +487,13 @@ OpenClaw додає специфічний для OpenAI внесок у про - `responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`. + `responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`. - Для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: + Для запусків сімейства GPT-5 через `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: ```json5 { @@ -507,30 +507,31 @@ OpenClaw додає специфічний для OpenAI внесок у про З `strict-agentic` OpenClaw: - Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента - - Повторює хід зі спрямуванням на негайну дію + - Повторює хід із настановою діяти негайно - Автоматично вмикає `update_plan` для суттєвої роботи - - Показує явний заблокований стан, якщо модель продовжує планувати без дій + - Показує явний стан блокування, якщо модель продовжує планувати без дії - Поширюється лише на запуски сімейства GPT-5 OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають поведінку за замовчуванням. + Застосовується лише до запусків сімейства GPT-5 OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається типова поведінка. - - OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-compatible проксі `/v1`: + + 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 використовує нативний транспорт і поведінку сумісності, але не отримує прихованих заголовків атрибуції. @@ -542,12 +543,12 @@ OpenClaw додає специфічний для OpenAI внесок у про Вибір провайдерів, посилань на моделі та поведінки failover. - Спільні параметри інструмента зображень і вибір провайдера. + Спільні параметри інструмента для зображень і вибір провайдера. - Спільні параметри інструмента відео і вибір провайдера. + Спільні параметри інструмента для відео і вибір провайдера. - Докладніше про автентифікацію та правила повторного використання облікових даних. + Відомості про автентифікацію та правила повторного використання облікових даних. diff --git a/docs/uk/tools/thinking.md b/docs/uk/tools/thinking.md index 23b114b47..b7be2b5d4 100644 --- a/docs/uk/tools/thinking.md +++ b/docs/uk/tools/thinking.md @@ -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 `, `/think:` або `/thinking `. +- Вбудована директива в будь-якому вхідному тілі: `/t `, `/think:` або `/thinking `. - Рівні (псевдоніми): `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["/"].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-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли доступно (шлях/команда). Ці зведення інструментів надсилаються щойно кожен інструмент запускається (окремими бульбашками), а не як потокові дельти. -- Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховуються, якщо 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-агенти), надсилають кожен виклик інструмента назад як окреме повідомлення лише з метаданими, з префіксом ` : `, коли це доступно (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 ()`, де визначене типове значення береться з активної моделі сеансу: `adaptive` для Claude 4.6 на Anthropic, `off` для Anthropic Claude Opus 4.7, якщо не налаштовано, `low` для інших моделей із підтримкою міркування, `off` — в інших випадках. +- Селектор мислення у вебчаті відображає збережений для сесії рівень із вхідного сховища сесії/конфігурації під час завантаження сторінки. +- Вибір іншого рівня негайно записує перевизначення для сесії через `sessions.patch`; він не чекає наступного надсилання і не є одноразовим перевизначенням `thinkingOnce`. +- Перший варіант завжди `Default ()`, де визначене значення за замовчуванням береться з активної моделі сесії: `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:` як і раніше працює та оновлює той самий збережений рівень сеансу, тому директиви чату й засіб вибору залишаються синхронізованими. + - Z.AI показує двійковий варіант `off | on` +- `/think:` усе ще працює й оновлює той самий збережений рівень сесії, тому директиви чату й засіб вибору залишаються синхронізованими.