--- read_when: - Налаштування мислення, швидкого режиму або розбору директиви докладності чи значень за замовчуванням summary: Синтаксис директив для /think, /fast, /verbose, /trace та видимості міркувань title: Рівні мислення x-i18n: generated_at: "2026-05-11T21:02:51Z" model: gpt-5.5 provider: openai source_hash: c75e2360a260aaf4571f2da6c7519fb4987e4c8c7947e3dc37f94a0ad260ad55 source_path: tools/thinking.md workflow: 16 --- ## Що це робить - Вбудована директива в будь-якому вхідному тілі: `/t `, `/think:` або `/thinking `. - Рівні (псевдоніми): `off | minimal | low | medium | high | xhigh | adaptive | max` - minimal → "think" - low → "think hard" - medium → "think harder" - high → "ultrathink" (максимальний бюджет) - xhigh → "ultrathink+" (моделі GPT-5.2+ і Codex, а також effort Anthropic Claude Opus 4.7) - adaptive → адаптивне мислення, кероване провайдером (підтримується для Claude 4.6 на Anthropic/Bedrock, Anthropic Claude Opus 4.7 і динамічного мислення Google Gemini) - max → максимальне reasoning провайдера (Anthropic Claude Opus 4.7; Ollama зіставляє це зі своїм найвищим нативним effort `think`) - `x-high`, `x_high`, `extra-high`, `extra high` і `extra_high` зіставляються з `xhigh`. - `highest` зіставляється з `high`. - Примітки щодо провайдерів: - Меню та вибір thinking визначаються профілем провайдера. Provider Plugins оголошують точний набір рівнів для вибраної моделі, включно з мітками на кшталт бінарного `on`. - `adaptive`, `xhigh` і `max` показуються лише для профілів провайдера/моделі, які їх підтримують. Типізовані директиви для непідтримуваних рівнів відхиляються з чинними параметрами цієї моделі. - Наявні збережені непідтримувані рівні перепризначаються за рангом профілю провайдера. `adaptive` повертається до `medium` на неадаптивних моделях, тоді як `xhigh` і `max` повертаються до найбільшого підтримуваного рівня не `off` для вибраної моделі. - Моделі Anthropic Claude 4.6 типово використовують `adaptive`, коли явний рівень thinking не задано. - Anthropic Claude Opus 4.7 не використовує адаптивне мислення типово. Його типовий API effort залишається у власності провайдера, якщо ви явно не задасте рівень thinking. - Anthropic Claude Opus 4.7 зіставляє `/think xhigh` з адаптивним мисленням плюс `output_config.effort: "xhigh"`, оскільки `/think` є директивою thinking, а `xhigh` є налаштуванням effort для Opus 4.7. - Anthropic Claude Opus 4.7 також надає `/think max`; він зіставляється з тим самим шляхом максимального effort, що належить провайдеру. - Прямі моделі DeepSeek V4 надають `/think xhigh|max`; обидва значення зіставляються з DeepSeek `reasoning_effort: "max"`, тоді як нижчі рівні не `off` зіставляються з `high`. - Моделі DeepSeek V4, маршрутизовані через OpenRouter, надають `/think xhigh` і надсилають підтримувані OpenRouter значення `reasoning_effort`. Збережені перевизначення `max` повертаються до `xhigh`. - Моделі Ollama з підтримкою thinking надають `/think low|medium|high|max`; `max` зіставляється з нативним `think: "high"`, оскільки нативний API Ollama приймає рядки effort `low`, `medium` і `high`. - Моделі OpenAI GPT зіставляють `/think` через підтримку effort Responses API, специфічну для моделі. `/think off` надсилає `reasoning.effort: "none"` лише коли цільова модель це підтримує; інакше OpenClaw пропускає вимкнений payload reasoning замість надсилання непідтримуваного значення. - Користувацькі записи каталогу, сумісні з OpenAI, можуть увімкнути `/think xhigh`, задавши `models.providers..models[].compat.supportedReasoningEfforts` так, щоб він містив `"xhigh"`. Це використовує ті самі метадані сумісності, які зіставляють вихідні payload effort reasoning OpenAI, тож меню, валідація сесії, agent CLI і `llm-task` узгоджуються з поведінкою транспорту. - Застарілі налаштовані refs OpenRouter Hunter Alpha пропускають ін’єкцію proxy reasoning, оскільки цей вилучений маршрут міг повертати текст фінальної відповіді через поля reasoning. - Google Gemini зіставляє `/think adaptive` з динамічним мисленням Gemini, що належить провайдеру. Запити Gemini 3 пропускають фіксований `thinkingLevel`, тоді як запити Gemini 2.5 надсилають `thinkingBudget: -1`; фіксовані рівні й надалі зіставляються з найближчим Gemini `thinkingLevel` або бюджетом для цієї сім’ї моделей. - MiniMax (`minimax/*`) на streaming-шляху, сумісному з Anthropic, типово використовує `thinking: { type: "disabled" }`, якщо ви явно не задасте thinking у параметрах моделі або параметрах запиту. Це запобігає витоку дельт `reasoning_content` з ненативного формату Anthropic stream від MiniMax. - Z.AI (`zai/*`) підтримує лише бінарне thinking (`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. Резервний варіант: типове значення, оголошене провайдером, коли доступне; інакше моделі з підтримкою reasoning визначаються як `medium` або найближчий підтримуваний рівень не `off` для цієї моделі, а моделі без reasoning залишаються `off`. ## Налаштування типового значення сесії - Надішліть повідомлення, що містить **лише** директиву (пробіли дозволені), наприклад `/think:medium` або `/t high`. - Це закріплюється для поточної сесії (типово для кожного відправника). Використовуйте `/think default`, щоб очистити перевизначення сесії та успадкувати налаштоване/провайдерське типове значення; псевдоніми: `inherit`, `clear`, `reset` і `unpin`. - `/think off` зберігає явне перевизначення off. Воно вимикає thinking, доки ви не зміните або не очистите перевизначення сесії. - Надсилається відповідь-підтвердження (`Thinking level set to high.` / `Thinking disabled.`). Якщо рівень недійсний (наприклад, `/thinking big`), команда відхиляється з підказкою, а стан сесії залишається без змін. - Надішліть `/think` (або `/think:`) без аргументу, щоб побачити поточний рівень thinking. ## Застосування за агентом - **Вбудований Pi**: визначений рівень передається до runtime агента Pi у процесі. - **Бекенд Claude CLI**: рівні не off передаються до Claude Code як `--effort` під час використання `claude-cli`; див. [CLI-бекенди](/uk/gateway/cli-backends). ## Швидкий режим (/fast) - Рівні: `on|off|default`. - Повідомлення, що містить лише директиву, перемикає перевизначення швидкого режиму сесії та відповідає `Fast mode enabled.` / `Fast mode disabled.`. Використовуйте `/fast default`, щоб очистити перевизначення сесії та успадкувати налаштоване типове значення; псевдоніми: `inherit`, `clear`, `reset` і `unpin`. - Надішліть `/fast` (або `/fast status`) без режиму, щоб побачити поточний ефективний стан швидкого режиму. - OpenClaw визначає швидкий режим у такому порядку: 1. Вбудоване/директивне перевизначення `/fast on|off` (`/fast default` очищає цей шар) 2. Перевизначення сесії 3. Типове значення для агента (`agents.list[].fastModeDefault`) 4. Конфігурація для моделі: `agents.defaults.models["/"].params.fastMode` 5. Резервний варіант: `off` - Для `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 для базових URL proxy, які не є Anthropic. - `/status` показує `Fast` лише коли швидкий режим увімкнено. ## Директиви докладності (/verbose або /v) - Рівні: `on` (мінімальний) | `full` | `off` (типово). - Повідомлення, що містить лише директиву, перемикає докладність сесії та відповідає `Verbose logging enabled.` / `Verbose logging disabled.`; недійсні рівні повертають підказку без зміни стану. - `/verbose off` зберігає явне перевизначення сесії; очистьте його через інтерфейс Sessions, вибравши `inherit`. - Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні типові значення. - Надішліть `/verbose` (або `/verbose:`) без аргументу, щоб побачити поточний рівень докладності. - Коли докладність увімкнено, агенти, що випускають структуровані результати інструментів (Pi, інші JSON-агенти), надсилають кожен виклик інструмента назад як власне повідомлення лише з метаданими, з префіксом ` : `, коли доступно. Ці підсумки інструментів надсилаються одразу після запуску кожного інструмента (окремими бульбашками), а не як streaming-дельти. - Підсумки помилок інструментів залишаються видимими у звичайному режимі, але суфікси з сирими деталями помилок приховані, якщо докладність не `on` або `full`. - Коли докладність дорівнює `full`, вивід інструментів також пересилається після завершення (окрема бульбашка, обрізана до безпечної довжини). Якщо перемкнути `/verbose on|full|off`, поки виконання ще триває, наступні бульбашки інструментів враховуватимуть нове налаштування. - `agents.defaults.toolProgressDetail` керує формою підсумків інструментів `/verbose` і рядків інструментів у progress-draft. Використовуйте `"explain"` (типово) для компактних людських міток, як-от `🛠️ Exec: checking JS syntax`; використовуйте `"raw"`, коли також потрібне додавання сирої команди/деталі для налагодження. `agents.list[].toolProgressDetail` для агента перевизначає типове значення. - `explain`: `🛠️ Exec: check JS syntax for /tmp/app.js` - `raw`: `🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js` ## Директиви трасування Plugin (/trace) - Рівні: `on` | `off` (типово). - Повідомлення, що містить лише директиву, перемикає вивід трасування Plugin сесії та відповідає `Plugin trace enabled.` / `Plugin trace disabled.`. - Вбудована директива впливає лише на це повідомлення; інакше застосовуються типові значення сесії/глобальні типові значення. - Надішліть `/trace` (або `/trace:`) без аргументу, щоб побачити поточний рівень трасування. - `/trace` вужчий за `/verbose`: він відкриває лише рядки трасування/налагодження, що належать Plugin, наприклад підсумки налагодження Active Memory. - Рядки трасування можуть з’являтися в `/status` і як подальше діагностичне повідомлення після звичайної відповіді асистента. ## Видимість reasoning (/reasoning) - Рівні: `on|off|stream`. - Повідомлення, що містить лише директиву, перемикає, чи показуються блоки thinking у відповідях. - Коли увімкнено, reasoning надсилається як **окреме повідомлення** з префіксом `Reasoning:`. - `stream` (лише Telegram): транслює reasoning у draft-бульбашку Telegram, поки генерується відповідь, а потім надсилає фінальну відповідь без reasoning. - Псевдонім: `/reason`. - Надішліть `/reasoning` (або `/reasoning:`) без аргументу, щоб побачити поточний рівень reasoning. - Порядок визначення: вбудована директива, потім перевизначення сесії, потім типове значення для агента (`agents.list[].reasoningDefault`), потім глобальне типове значення (`agents.defaults.reasoningDefault`), потім резервний варіант (`off`). Неправильно сформовані теги reasoning локальної моделі обробляються консервативно. Закриті блоки `...` залишаються прихованими у звичайних відповідях, і незакритий reasoning після вже видимого тексту також приховується. Якщо відповідь повністю обгорнута в один незакритий відкривальний тег і інакше була б доставлена як порожній текст, OpenClaw видаляє неправильний відкривальний тег і доставляє решту тексту. ## Пов’язане - Документація elevated mode міститься в [Elevated mode](/uk/tools/elevated). ## Heartbeats - Тіло проби Heartbeat — це налаштований prompt 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 типово обмежується лише фінальним payload. Щоб також надіслати окреме повідомлення `Reasoning:` (коли доступне), задайте `agents.defaults.heartbeat.includeReasoning: true` або для агента `agents.list[].heartbeat.includeReasoning: true`. ## Вебінтерфейс чату - Селектор мислення у вебчаті під час завантаження сторінки відображає збережений рівень сеансу з вхідного сховища/конфігурації сеансу. - Вибір іншого рівня негайно записує перевизначення сеансу через `sessions.patch`; він не чекає наступного надсилання й не є одноразовим перевизначенням `thinkingOnce`. - Перший варіант завжди є вибором очищення перевизначення. Він показує `Inherited: `, коли сеанс успадковує ненульове ефективне значення за замовчуванням, або `Off`, коли успадковане мислення вимкнено. - Явні варіанти селектора позначаються як перевизначення, зберігаючи мітки провайдера, якщо вони наявні (наприклад, `Override: maximum` для варіанта `max`, позначеного провайдером). - Селектор використовує `thinkingLevels`, повернені рядком/значеннями за замовчуванням сеансу Gateway, а `thinkingOptions` зберігається як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни володіють наборами рівнів, специфічними для моделей. - `/think:` і далі працює та оновлює той самий збережений рівень сеансу, тож директиви чату й селектор залишаються синхронізованими. ## Профілі провайдерів - Плагіни провайдерів можуть відкривати `resolveThinkingProfile(ctx)`, щоб визначати підтримувані моделлю рівні та значення за замовчуванням. - Плагіни провайдерів, які проксіюють моделі Claude, мають повторно використовувати `resolveClaudeThinkingProfile(modelId)` з `openclaw/plugin-sdk/provider-model-shared`, щоб прямі каталоги Anthropic і проксі-каталоги залишалися узгодженими. - Кожен рівень профілю має збережений канонічний `id` (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` або `max`) і може містити відображувану `label`. Бінарні провайдери використовують `{ id: "low", label: "on" }`. - Інструментальні плагіни, яким потрібно перевіряти явне перевизначення мислення, мають використовувати `api.runtime.agent.resolveThinkingPolicy({ provider, model })` разом із `api.runtime.agent.normalizeThinkingLevel(...)`; вони не мають зберігати власні списки рівнів провайдерів/моделей. - Інструментальні плагіни з доступом до налаштованих метаданих користувацьких моделей можуть передавати `catalog` у `resolveThinkingPolicy`, щоб увімкнення `compat.supportedReasoningEfforts` відображалися у валідації на боці плагіна. - Опубліковані застарілі хуки (`supportsXHighThinking`, `isBinaryThinking` і `resolveDefaultThinkingLevel`) залишаються адаптерами сумісності, але нові користувацькі набори рівнів мають використовувати `resolveThinkingProfile`. - Рядки/значення за замовчуванням Gateway відкривають `thinkingLevels`, `thinkingOptions` і `thinkingDefault`, щоб клієнти ACP/чату відображали ті самі ідентифікатори й мітки профілю, які використовує валідація під час виконання.