Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.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 → “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.<provider>.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-бекенди.

​
Швидкий режим (/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["<provider>/<model>"].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-агенти), надсилають кожен виклик інструмента назад як власне повідомлення лише з метаданими, з префіксом <emoji> <tool-name>: <arg>, коли доступно. Ці підсумки інструментів надсилаються одразу після запуску кожного інструмента (окремими бульбашками), а не як 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 локальної моделі обробляються консервативно. Закриті блоки <think>...</think> залишаються прихованими у звичайних відповідях, і незакритий reasoning після вже видимого тексту також приховується. Якщо відповідь повністю обгорнута в один незакритий відкривальний тег і інакше була б доставлена як порожній текст, OpenClaw видаляє неправильний відкривальний тег і доставляє решту тексту.

​
Пов’язане

  • Документація elevated mode міститься в Elevated mode.

​
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: <resolved level>, коли сеанс успадковує ненульове ефективне значення за замовчуванням, або Off, коли успадковане мислення вимкнено.
  • Явні варіанти селектора позначаються як перевизначення, зберігаючи мітки провайдера, якщо вони наявні (наприклад, Override: maximum для варіанта max, позначеного провайдером).
  • Селектор використовує thinkingLevels, повернені рядком/значеннями за замовчуванням сеансу Gateway, а thinkingOptions зберігається як застарілий список міток. Інтерфейс браузера не зберігає власний список regex провайдерів; плагіни володіють наборами рівнів, специфічними для моделей.
  • /think:<level> і далі працює та оновлює той самий збережений рівень сеансу, тож директиви чату й селектор залишаються синхронізованими.

​
Профілі провайдерів

  • Плагіни провайдерів можуть відкривати 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/чату відображали ті самі ідентифікатори й мітки профілю, які використовує валідація під час виконання.