> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Уровни мышления

## Что делает

* Встроенная директива в любом входящем теле: `/t <level>`, `/think:<level>` или `/thinking <level>`.
* Уровни (псевдонимы): `off | minimal | low | medium | high | xhigh | adaptive | max`
  * minimal → "думай"
  * low → "думай глубоко"
  * medium → "думай глубже"
  * high → "ultrathink" (максимальный бюджет)
  * xhigh → "ultrathink+" (модели 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`)
  * `x-high`, `x_high`, `extra-high`, `extra high` и `extra_high` сопоставляются с `xhigh`.
  * `highest` сопоставляется с `high`.
* Примечания по поставщикам:
  * Меню и селекторы мышления управляются профилем поставщика. Plugin поставщика объявляют точный набор уровней для выбранной модели, включая метки вроде бинарного `on`.
  * `adaptive`, `xhigh` и `max` показываются только для профилей поставщика/модели, которые их поддерживают. Типизированные директивы для неподдерживаемых уровней отклоняются с допустимыми параметрами этой модели.
  * Сохраненные неподдерживаемые уровни переназначаются по рангу профиля поставщика. `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`; она сопоставляется с тем же путем максимального усилия под управлением поставщика.
  * Прямые модели DeepSeek V4 предоставляют `/think xhigh|max`; оба значения сопоставляются с DeepSeek `reasoning_effort: "max"`, а более низкие уровни не `off` сопоставляются с `high`.
  * Модели DeepSeek V4, маршрутизируемые через OpenRouter, предоставляют `/think xhigh` и отправляют поддерживаемые OpenRouter значения `reasoning_effort`. Сохраненные переопределения `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 опускает отключенную полезную нагрузку рассуждения вместо отправки неподдерживаемого значения.
  * Пользовательские записи каталога, совместимые с OpenAI, могут включить `/think xhigh`, задав `models.providers.<provider>.models[].compat.supportedReasoningEfforts` так, чтобы он включал `"xhigh"`. Для этого используются те же метаданные совместимости, которые сопоставляют исходящие полезные нагрузки усилия рассуждения OpenAI, поэтому меню, проверка сессии, CLI агента и `llm-task` согласованы с поведением транспорта.
  * Устаревшие настроенные ссылки OpenRouter Hunter Alpha пропускают инъекцию прокси-рассуждения, потому что этот выведенный из эксплуатации маршрут мог возвращать текст финального ответа через поля рассуждения.
  * Google Gemini сопоставляет `/think adaptive` с динамическим мышлением Gemini под управлением поставщика. Запросы Gemini 3 опускают фиксированный `thinkingLevel`, а запросы Gemini 2.5 отправляют `thinkingBudget: -1`; фиксированные уровни по-прежнему сопоставляются с ближайшим Gemini `thinkingLevel` или бюджетом для этого семейства моделей.
  * 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` сохраняет явное переопределение выключения. Оно отключает мышление, пока вы не измените или не очистите переопределение сессии.
* Отправляется подтверждающий ответ (`Thinking level set to high.` / `Thinking disabled.`). Если уровень недопустим (например, `/thinking big`), команда отклоняется с подсказкой, а состояние сессии остается без изменений.
* Отправьте `/think` (или `/think:`) без аргумента, чтобы увидеть текущий уровень мышления.

## Применение агентом

* **Встроенный OpenClaw**: разрешенный уровень передается во внутрипроцессную среду выполнения агента OpenClaw.
* **Бэкенд Claude CLI**: уровни не `off` передаются в Claude Code как `--effort` при использовании `claude-cli`; см. [бэкенды CLI](/ru/gateway/cli-backends).

## Быстрый режим (/fast)

* Уровни: `auto|on|off|default`.
* Сообщение только с директивой переключает сессионное переопределение быстрого режима и отвечает `Fast mode set to auto.`, `Fast mode enabled.` или `Fast mode disabled.`. Используйте `/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` сохраняет режим сессии/конфигурации как 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` показывает `Fast`, когда быстрый режим включен, и `Fast:auto`, когда настроенный режим равен auto.

## Директивы подробности (/verbose или /v)

* Уровни: `on` (минимальный) | `full` | `off` (по умолчанию).
* Сообщение только с директивой переключает подробность сессии и отвечает `Verbose logging enabled.` / `Verbose logging disabled.`; недопустимые уровни возвращают подсказку без изменения состояния.
* `/verbose off` сохраняет явное переопределение сессии; очистите его через UI сессий, выбрав `inherit`.
* Авторизованные отправители внешних каналов могут сохранять сессионное переопределение подробности. Внутренним клиентам Gateway/webchat требуется `operator.admin`, чтобы сохранить его.
* Встроенная директива влияет только на это сообщение; иначе применяются значения сессии/глобальные значения по умолчанию.
* Отправьте `/verbose` (или `/verbose:`) без аргумента, чтобы увидеть текущий уровень подробности.
* Когда подробность включена, агенты, которые испускают структурированные результаты инструментов, отправляют каждый вызов инструмента обратно как отдельное сообщение только с метаданными, с префиксом `<emoji> <tool-name>: <arg>`, когда доступно. Эти сводки инструментов отправляются сразу при запуске каждого инструмента (отдельными пузырями), а не как потоковые дельты.
* Сводки сбоев инструментов остаются видимыми в обычном режиме, но суффиксы с сырыми деталями ошибок скрыты, если подробность не `full`.
* Когда подробность равна `full`, выводы инструментов также пересылаются после завершения (отдельным пузырем, усеченные до безопасной длины). Если вы переключаете `/verbose on|full|off` во время выполняющегося запуска, последующие пузыри инструментов учитывают новую настройку.
* `agents.defaults.toolProgressDetail` управляет формой сводок инструментов `/verbose` и строк инструментов в черновиках прогресса. Используйте `"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)

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

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

## Связанные материалы

* Документация по привилегированному режиму находится в [Привилегированном режиме](/ru/tools/elevated).

## 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` сохраняется как устаревший список меток. Браузерный интерфейс не хранит собственный список регулярных выражений провайдеров; plugins владеют наборами уровней для конкретных моделей.
* `/think:<level>` по-прежнему работает и обновляет тот же сохраненный уровень сеанса, поэтому директивы чата и селектор остаются синхронизированными.

## Профили провайдеров

* Plugins провайдеров могут предоставлять `resolveThinkingProfile(ctx)`, чтобы определить поддерживаемые моделью уровни и значение по умолчанию.
* Plugins провайдеров, которые проксируют модели Claude, должны повторно использовать `resolveClaudeThinkingProfile(modelId)` из `openclaw/plugin-sdk/provider-model-shared`, чтобы прямые каталоги Anthropic и прокси-каталоги оставались согласованными.
* Каждый уровень профиля имеет сохраненный канонический `id` (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` или `max`) и может включать отображаемую `label`. Бинарные провайдеры используют `{ id: "low", label: "on" }`.
* Хуки профиля получают объединенные факты каталога, когда они доступны, включая `reasoning`, `compat.thinkingFormat` и `compat.supportedReasoningEfforts`. Используйте эти факты, чтобы предоставлять бинарные или пользовательские профили только тогда, когда настроенный контракт запроса поддерживает соответствующую полезную нагрузку.
* Tool plugins, которым нужно проверять явное переопределение рассуждений, должны использовать `api.runtime.agent.resolveThinkingPolicy({ provider, model })` вместе с `api.runtime.agent.normalizeThinkingLevel(...)`; им не следует хранить собственные списки уровней провайдера/модели.
* Tool plugins с доступом к настроенным метаданным пользовательской модели могут передавать `catalog` в `resolveThinkingPolicy`, чтобы согласия `compat.supportedReasoningEfforts` отражались при проверке на стороне plugin.
* Опубликованные устаревшие хуки (`supportsXHighThinking`, `isBinaryThinking` и `resolveDefaultThinkingLevel`) остаются адаптерами совместимости, но новые пользовательские наборы уровней должны использовать `resolveThinkingProfile`.
* Строки/настройки по умолчанию Gateway предоставляют `thinkingLevels`, `thinkingOptions` и `thinkingDefault`, чтобы клиенты ACP/чата отображали те же идентификаторы и метки профилей, которые использует проверка во время выполнения.
