Рівні міркування

Що це робить

• Вбудована директива в будь-якому тілі вхідного повідомлення: /t <рівень>, /think:<рівень> або /thinking <рівень>.
• Рівні (псевдоніми): off | minimal | low | medium | high | xhigh | adaptive | max | ultra, що приблизно відповідають класичній градації магічних слів Anthropic "think" < "think hard" < "think harder" < "ultrathink":
  • minimal ~ "думай"
  • low ~ "думай напружено"
  • medium ~ "думай ще напруженіше"
  • high ~ "надглибоке мислення" (максимальний бюджет)
  • xhigh ~ "надглибоке мислення+" (моделі GPT-5.2+ і Codex, а також рівень зусиль Anthropic Claude Opus 4.7+)
  • adaptive → адаптивне мислення, кероване постачальником (підтримується для Claude 4.6 в Anthropic/Bedrock, Anthropic Claude Opus 4.7+ і динамічного мислення Google Gemini)
  • max → максимальний рівень міркування постачальника (Anthropic Claude Opus 4.7+; Ollama зіставляє його зі своїм найвищим нативним рівнем зусиль think)
  • ultra → максимальний рівень міркування постачальника плюс проактивна оркестрація підагентів, якщо вибрана модель або середовище виконання це підтримує
  • x-high, x_high, extra-high, extra high і extra_high зіставляються з xhigh.
  • highest зіставляється з high.
• Примітки щодо постачальників:
  • Меню та засоби вибору рівня мислення визначаються профілем постачальника. Плагіни постачальників оголошують точний набір рівнів для вибраної моделі, включно з такими позначками, як двійкове on.
  • adaptive, xhigh, max і ultra відображаються лише для профілів постачальника, моделі та середовища виконання, які їх підтримують. Типізовані директиви з непідтримуваними рівнями відхиляються з переліком допустимих варіантів для цієї моделі.
  • Наявні збережені непідтримувані рівні перепризначаються відповідно до рангу профілю постачальника. adaptive повертається до medium для неадаптивних моделей, а xhigh і max — до найбільшого підтримуваного рівня, відмінного від off, для вибраної моделі.
  • Моделі Anthropic Claude 4.6 за замовчуванням використовують adaptive, якщо рівень мислення явно не задано.
  • У Anthropic Claude Opus 4.8 і Opus 4.7 мислення залишається вимкненим, доки ви явно не задасте рівень мислення. Після ввімкнення адаптивного мислення стандартний рівень зусиль Opus 4.8, яким керує постачальник, — high.
  • Anthropic Claude Opus 4.7+ зіставляє /think xhigh з адаптивним мисленням і output_config.effort: "xhigh", оскільки /think є директивою мислення, а xhigh — налаштуванням зусиль Opus.
  • Anthropic Claude Opus 4.7+ також надає /think max; вона зіставляється з тим самим шляхом максимальних зусиль, яким керує постачальник.
  • Моделі Direct DeepSeek V4 надають /think xhigh|max; обидва рівні зіставляються з DeepSeek reasoning_effort: "max", тоді як нижчі рівні, відмінні від off, зіставляються з high.
  • Моделі DeepSeek V4, маршрутизовані через OpenRouter, надають /think xhigh і надсилають підтримувані OpenRouter значення reasoning.effort замість нативного верхньорівневого параметра DeepSeek reasoning_effort. Нижчі рівні, відмінні від off, зіставляються з high, а збережені перевизначення max повертаються до xhigh.
  • Моделі Ollama із підтримкою мислення надають /think low|medium|high|max; max зіставляється з нативним think: "high", оскільки нативний API Ollama приймає рядки зусиль low, medium і high.
  • Моделі OpenAI GPT зіставляють /think через підтримку рівнів зусиль Responses API, специфічну для моделі. /think off надсилає reasoning.effort: "none" лише тоді, коли цільова модель це підтримує; інакше OpenClaw не додає вимкнене корисне навантаження міркування замість надсилання непідтримуваного значення.
  • GPT-5.6 Sol і Terra надають нативну /think ultra через середовище виконання Codex. GPT-5.6 Luna надає рівні до max, оскільки її каталог Codex не оголошує Ultra.
  • Вбудоване середовище виконання OpenClaw надає логічну /think ultra для GPT-5.6 Sol, Terra і Luna. Воно надсилає максимальний рівень зусиль постачальника та додає вказівки щодо проактивної оркестрації підагентів у межах запуску.
  • Власні записи каталогу, сумісні з OpenAI, можуть увімкнути /think xhigh, додавши "xhigh" до models.providers.<provider>.models[].compat.supportedReasoningEfforts. Для цього використовуються ті самі метадані сумісності, що зіставляють вихідні корисні навантаження рівня зусиль міркування OpenAI, тож меню, перевірка сеансу, CLI агента й llm-task узгоджуються з поведінкою транспорту.
  • Застарілі налаштовані посилання OpenRouter Hunter Alpha пропускають додавання міркування проксі-сервером, оскільки цей виведений з експлуатації маршрут міг повертати текст остаточної відповіді в полях міркування.
  • Google Gemini зіставляє /think adaptive з динамічним мисленням Gemini, яким керує постачальник. Запити Gemini 3 не містять фіксованого thinkingLevel, а запити Gemini 2.5 надсилають thinkingBudget: -1; фіксовані рівні й надалі зіставляються з найближчим thinkingLevel або бюджетом Gemini для відповідного сімейства моделей.
  • MiniMax M2.x (minimax/MiniMax-M2*) на потоковому шляху, сумісному з Anthropic, за замовчуванням використовує thinking: { type: "disabled" }, якщо ви явно не задасте мислення в параметрах моделі або запиту. Це запобігає витоку дельт reasoning_content із ненативного формату потоку Anthropic у M2.x. MiniMax-M3 (і M3.x) є винятком: M3 створює коректні блоки мислення Anthropic і повертає порожній вміст, коли мислення вимкнено, тому OpenClaw залишає M3 на шляху пропущеного або адаптивного мислення постачальника.
  • Z.AI (zai/*) використовує двійковий режим (on/off) для більшості моделей GLM. Виняток — GLM-5.2: вона надає /think off|low|high|max, зіставляє low і high із Z.AI reasoning_effort: "high", а max — із reasoning_effort: "max".
  • Moonshot Kimi K2.7 Code (moonshot/kimi-k2.7-code) завжди мислить. Її профіль надає лише on, а OpenClaw не додає вихідне поле thinking, як того вимагає Moonshot. Інші моделі moonshot/* зіставляють /think off із thinking: { type: "disabled" }, а будь-який рівень, відмінний від off, — із thinking: { type: "enabled" }. Коли мислення ввімкнено, Moonshot приймає для tool_choice лише auto|none; OpenClaw нормалізує несумісні значення до auto.

Порядок визначення

1. Вбудована директива в повідомленні (застосовується лише до цього повідомлення).
2. Перевизначення сеансу (задається надсиланням повідомлення, що містить лише директиву).
3. Стандартне значення для агента (agents.list[].thinkingDefault у конфігурації).
4. Глобальне стандартне значення (agents.defaults.thinkingDefault у конфігурації).
5. Резервний варіант: стандартне значення, оголошене постачальником, якщо воно доступне; інакше для моделей із підтримкою міркування визначається medium або найближчий підтримуваний для цієї моделі рівень, відмінний від off, а моделі без підтримки міркування залишаються в режимі off.

Установлення стандартного значення сеансу

• Надішліть повідомлення, яке містить лише директиву (пробіли дозволено), наприклад /think:medium або /t high.
• Це налаштування зберігається для поточного сеансу (за замовчуванням окремо для кожного відправника). Використовуйте /think default, щоб очистити перевизначення сеансу й успадкувати налаштоване або стандартне значення постачальника; псевдоніми: inherit, clear, reset і unpin.
• /think off зберігає явне перевизначення вимкнення. Воно вимикає мислення, доки ви не зміните або не очистите перевизначення сеансу.
• Надсилається відповідь-підтвердження (Рівень мислення встановлено на high. / Мислення вимкнено.). Якщо рівень недійсний (наприклад, /thinking big), команда відхиляється з підказкою, а стан сеансу залишається незмінним.
• Надішліть /think (або /think:) без аргументу, щоб переглянути поточний рівень мислення.

Застосування агентом

• Вбудований OpenClaw: визначений рівень передається внутрішньопроцесному середовищу виконання агента OpenClaw.
• Серверна частина Claude CLI: конкретні рівні, відмінні від off, передаються до Claude Code як --effort під час використання claude-cli; adaptive вилучає налаштовані прапорці рівня зусиль і делегує визначення фактичного рівня зусиль середовищу, налаштуванням і стандартним значенням моделі Claude Code. Див. серверні частини CLI.

Швидкий режим (/fast)

• Рівні: auto|on|off|default.
• Повідомлення, що містить лише директиву, перемикає перевизначення швидкого режиму для сеансу й відповідає Швидкий режим установлено на auto., Швидкий режим увімкнено. або Швидкий режим вимкнено.. Використовуйте /fast default, щоб очистити перевизначення сеансу й успадкувати налаштоване стандартне значення; псевдоніми: inherit, clear, reset і unpin.
• Надішліть /fast (або /fast status) без режиму, щоб переглянути поточний фактичний стан швидкого режиму.
• OpenClaw визначає швидкий режим у такому порядку:
  1. Вбудоване перевизначення або перевизначення повідомленням лише з директивою /fast auto|on|off (/fast default очищає цей рівень)
  2. Перевизначення сеансу
  3. Стандартне значення для агента (agents.list[].fastModeDefault)
  4. Конфігурація для моделі: agents.defaults.models["<provider>/<model>"].params.fastMode
  5. Резервний варіант: off
• auto зберігає режим сеансу або конфігурації як автоматичний, але визначає його окремо для кожного нового виклику моделі. Для викликів, що починаються до автоматичного граничного часу, швидкий режим увімкнено; пізніші повторні, резервні виклики, виклики з результатами інструментів або продовження починаються з вимкненим швидким режимом. За замовчуванням граничний час становить 60 секунд; щоб змінити його, задайте agents.defaults.models["<provider>/<model>"].params.fastAutoOnSeconds для активної моделі.
• Для openai/* швидкий режим зіставляється з пріоритетною обробкою OpenAI шляхом надсилання service_tier=priority у підтримуваних запитах Responses.
• Для моделей openai/* / openai-codex/* на базі Codex швидкий режим надсилає той самий прапорець service_tier=priority у Codex Responses. Нативні ходи сервера застосунку Codex отримують рівень обслуговування лише під час turn/start або запуску чи відновлення потоку, тому auto не може змінити рівень обслуговування вже запущеного ходу сервера застосунку; він застосовується до наступного ходу моделі, який запускає OpenClaw.
• Для прямих загальнодоступних запитів 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.
• /status показує Швидко, коли швидкий режим увімкнено, і Швидко:auto, коли налаштовано автоматичний режим.

Директиви докладності (/verbose або /v)

• Рівні: on (мінімальний) | full | off (за замовчуванням).
• Повідомлення, що містить лише директиву, перемикає докладність сеансу й відповідає Докладне журналювання ввімкнено. / Докладне журналювання вимкнено.; для недійсних рівнів повертається підказка без зміни стану.
• /verbose off зберігає явне перевизначення сеансу; очистьте його в інтерфейсі сеансів, вибравши inherit.
• Авторизовані відправники зовнішніх каналів можуть зберігати перевизначення докладності сеансу. Внутрішнім клієнтам Gateway і вебчату для його збереження потрібен operator.admin.
• Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються стандартні значення сеансу або глобальні стандартні значення.
• Надішліть /verbose (або /verbose:) без аргументу, щоб переглянути поточний рівень докладності.
• Коли докладний режим увімкнено, агенти, які створюють структуровані результати інструментів, надсилають кожен виклик інструмента окремим повідомленням лише з метаданими, за можливості з префіксом <emoji> <назва-інструмента>: <аргумент>. Ці зведення інструментів надсилаються одразу після запуску кожного інструмента (окремими бульбашками), а не як потокові дельти.
• Зведення про помилки інструментів залишаються видимими у звичайному режимі, але суфікси з необробленими подробицями помилок приховано, якщо докладність не має значення full.
• Коли докладність має значення full, результати інструментів також пересилаються після завершення (окремою бульбашкою, скороченою до безпечної довжини). Якщо перемкнути /verbose on|full|off під час виконання, наступні бульбашки інструментів враховуватимуть нове налаштування.
• agents.defaults.toolProgressDetail керує форматом зведень інструментів /verbose і рядків інструментів у чернетках перебігу виконання. Використовуйте "explain" (за замовчуванням) для стислих зрозумілих людині позначок, як-от 🛠️ Виконання: перевірка синтаксису JS; використовуйте "raw", якщо для налагодження також потрібно додавати необроблену команду або подробиці. Значення agents.list[].toolProgressDetail для агента перевизначає стандартне.
  • explain: 🛠️ Виконання: перевірити синтаксис JS для /tmp/app.js
  • raw: 🛠️ Виконання: перевірити синтаксис JS для /tmp/app.js, node --check /tmp/app.js

Директиви трасування Plugin (/trace)

• Рівні: on | off (за замовчуванням).
• Повідомлення, що містить лише директиву, перемикає виведення трасування Plugin для сеансу й відповідає Трасування Plugin увімкнено. / Трасування Plugin вимкнено..
• Вбудована директива впливає лише на це повідомлення; в інших випадках застосовуються стандартні значення сеансу або глобальні стандартні значення.
• Надішліть /trace (або /trace:) без аргументу, щоб переглянути поточний рівень трасування.
• /trace має вужчу дію, ніж /verbose: вона показує лише належні Plugin рядки трасування або налагодження, як-от зведення налагодження Active Memory.
• Рядки трасування можуть з'являтися в /status і як наступне діагностичне повідомлення після звичайної відповіді асистента.

Видимість міркування (/reasoning)

• Рівні: on|off|stream.
• Повідомлення, що містить лише директиву, перемикає відображення блоків міркувань у відповідях.
• Коли ввімкнено, міркування надсилаються як окреме повідомлення з префіксом Thinking.
• stream: транслює міркування під час формування відповіді, якщо активний канал підтримує попередній перегляд міркувань, а потім надсилає остаточну відповідь без міркувань.
• Псевдонім: /reason.
• Надішліть /reasoning (або /reasoning:) без аргументу, щоб переглянути поточний рівень міркувань.
• Порядок визначення: вбудована директива, потім перевизначення сеансу, потім типове значення для агента (agents.list[].reasoningDefault), потім глобальне типове значення (agents.defaults.reasoningDefault), потім резервне значення (off).

Некоректні теги міркувань локальної моделі обробляються консервативно. Закриті блоки <think>...</think> залишаються прихованими у звичайних відповідях, а незакриті міркування після вже видимого тексту також приховуються. Якщо відповідь повністю обгорнута одним незакритим початковим тегом і без спеціальної обробки була б доставлена як порожній текст, OpenClaw видаляє некоректний початковий тег і доставляє решту тексту.

Пов’язане

• Документація режиму підвищених привілеїв міститься в розділі Режим підвищених привілеїв.

Heartbeat

• Тіло перевірки 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 доставляє лише остаточне корисне навантаження. Щоб також надсилати окреме повідомлення Thinking (коли воно доступне), установіть agents.defaults.heartbeat.includeReasoning: true або для окремого агента — agents.list[].heartbeat.includeReasoning: true.

Вебінтерфейс чату

• Під час завантаження сторінки перемикач міркувань у вебчаті відображає збережений рівень сеансу зі сховища вхідних сеансів або конфігурації.
• Вибір іншого рівня негайно записує перевизначення сеансу через sessions.patch; він не очікує наступного надсилання й не є одноразовим перевизначенням thinkingOnce.
• Якщо на момент надсилання ще застосовуються зміни засобів вибору моделі, міркувань або швидкості, система очікує завершення всіх відкладених оновлень цих засобів; якщо зміна завершується помилкою, повідомлення не надсилається й залишається для перевірки.
• Перший варіант завжди призначений для скидання перевизначення. Він показує Inherited: <resolved level>, зокрема Inherited: Off, коли успадковані міркування вимкнено.
• Явно вибрані варіанти використовують безпосередні мітки своїх рівнів, зберігаючи мітки постачальника за їх наявності (наприклад, Maximum для позначеного постачальником варіанта max).
• Засіб вибору використовує thinkingLevels, повернені рядком сеансу або типовими значеннями Gateway, а thinkingOptions зберігається як застарілий список міток. Інтерфейс браузера не зберігає власного списку регулярних виразів постачальників; набори рівнів для конкретних моделей належать плагінам.
• /think:<level> усе ще працює й оновлює той самий збережений рівень сеансу, тому директиви чату та засіб вибору залишаються синхронізованими.

Профілі постачальників

• Плагіни постачальників можуть надавати resolveThinkingProfile(ctx), щоб визначити підтримувані моделлю рівні та типовий рівень.
• Плагіни постачальників, які проксіюють моделі Claude, мають повторно використовувати resolveClaudeThinkingProfile(modelId) з openclaw/plugin-sdk/provider-model-shared, щоб прямі каталоги Anthropic і каталоги проксі залишалися узгодженими.
• Кожен рівень профілю має збережений канонічний id (off, minimal, low, medium, high, xhigh, adaptive, max або ultra) і може містити відображувану мітку label. Двійкові постачальники використовують { id: "low", label: "on" }.
• Хуки профілів отримують об’єднані дані каталогу, коли вони доступні, зокрема reasoning, compat.thinkingFormat і compat.supportedReasoningEfforts. Використовуйте ці дані, щоб надавати двійкові або власні профілі лише тоді, коли налаштований контракт запиту підтримує відповідне корисне навантаження.
• Плагіни інструментів, яким потрібно перевіряти явне перевизначення міркувань, мають використовувати api.runtime.agent.resolveThinkingPolicy({ provider, model, agentRuntime }) разом з api.runtime.agent.normalizeThinkingLevel(...); вони не повинні зберігати власні списки рівнів постачальників або моделей. Передавайте agentRuntime, коли інструмент керує шляхом виконання, наприклад під час завжди вбудованого запуску.
• Плагіни інструментів, які мають доступ до налаштованих метаданих власних моделей, можуть передавати catalog до resolveThinkingPolicy, щоб явні дозволи compat.supportedReasoningEfforts враховувалися під час перевірки на боці плагіна.
• Опубліковані застарілі хуки (supportsXHighThinking, isBinaryThinking і resolveDefaultThinkingLevel) залишаються адаптерами сумісності, але для нових власних наборів рівнів слід використовувати resolveThinkingProfile.
• Рядки й типові значення Gateway надають thinkingLevels, thinkingOptions і thinkingDefault, щоб клієнти ACP та чату відображали ті самі ідентифікатори й мітки профілів, які використовує перевірка під час виконання.