--- read_when: - Ви хочете зрозуміти, що означає «контекст» в OpenClaw - Ви з’ясовуєте, чому модель щось «знає» (або забула це) - Ви хочете зменшити накладні витрати контексту (/context, /status, /compact) summary: 'Контекст: що бачить модель, як він формується та як його перевірити' title: Контекст x-i18n: generated_at: "2026-06-27T17:25:22Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 900b4a72acf43405a6b7718b93c3b5c8543eb2cc90766298889052c7468e39fb source_path: concepts/context.md workflow: 16 --- "Контекст" - це **все, що OpenClaw надсилає моделі для запуску**. Він обмежений **контекстним вікном** моделі (лімітом токенів). Ментальна модель для початківців: - **Системний промпт** (створений OpenClaw): правила, інструменти, список Skills, час/середовище виконання та додані файли робочого простору. - **Історія розмови**: ваші повідомлення + повідомлення асистента для цього сеансу. - **Виклики/результати інструментів + вкладення**: вивід команд, читання файлів, зображення/аудіо тощо. Контекст - це _не те саме_, що "пам'ять": пам'ять може зберігатися на диску й завантажуватися пізніше; контекст - це те, що міститься в поточному вікні моделі. ## Швидкий старт (перевірка контексту) - `/status` → швидкий перегляд "наскільки заповнене моє вікно?" + налаштування сеансу. - `/context list` → що додано + приблизні розміри (за файлами + підсумки). - `/context detail` → глибший розбір: розміри за файлами, схемами інструментів, записами Skills, розмір системного промпта та кількість повідомлень стенограми, які можна стиснути. - `/context map` → зображення деревоподібної карти в стилі WinDirStat для відстежуваних складників контексту поточного сеансу. - `/usage tokens` → додавати до звичайних відповідей футер із використанням токенів для кожної відповіді. - `/compact` → підсумувати старішу історію в компактний запис, щоб звільнити місце у вікні. Див. також: [Команди зі скісною рискою](/uk/tools/slash-commands), [Використання токенів і витрати](/uk/reference/token-use), [Compaction](/uk/concepts/compaction). ## Приклад виводу Значення залежать від моделі, провайдера, політики інструментів і вмісту вашого робочого простору. ### `/context list` ``` 🧠 Context breakdown Workspace: Bootstrap max/file: 12,000 chars Sandbox: mode=non-main sandboxed=false System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok)) Injected workspace files: - AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok) - SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok) - TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok) - IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok) - USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok) - HEARTBEAT.md: MISSING | raw 0 | injected 0 - BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok) Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills) Tools: read, edit, write, exec, process, browser, message, sessions_send, … Tool list (system prompt text): 1,032 chars (~258 tok) Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text) Tools: (same as above) Session tokens (cached): 14,250 total / ctx=32,000 ``` ### `/context detail` ``` 🧠 Context breakdown (detailed) … Top skills (prompt entry size): - frontend-design: 412 chars (~103 tok) - oracle: 401 chars (~101 tok) … (+10 more skills) Top tools (schema size): - browser: 9,812 chars (~2,453 tok) - exec: 6,240 chars (~1,560 tok) … (+N more tools) ``` ### `/context map` Надсилає зображення, згенероване з останнього кешованого звіту запуску. Перш ніж звичайне повідомлення створить звіт запуску в сеансі, `/context map` повертає повідомлення про недоступність замість рендерингу оцінки. Площа прямокутника пропорційна відстежуваним символам промпта: - додані файли робочого простору - базовий текст системного промпта - записи промптів Skills - JSON-схеми інструментів `/context list`, `/context detail` і `/context json` усе ще можуть перевіряти оцінку на вимогу, коли звіт запуску не кешовано. ## Що враховується в контекстному вікні Враховується все, що отримує модель, зокрема: - Системний промпт (усі розділи). - Історія розмови. - Виклики інструментів + результати інструментів. - Вкладення/стенограми (зображення/аудіо/файли). - Підсумки Compaction та артефакти обрізання. - "Обгортки" провайдера або приховані заголовки (не видимі, але все одно враховуються). ## Як OpenClaw будує системний промпт Системний промпт **належить OpenClaw** і перебудовується під час кожного запуску. Він містить: - Список інструментів + короткі описи. - Список Skills (лише метадані; див. нижче). - Розташування робочого простору. - Час (UTC + перетворений час користувача, якщо налаштовано). - Метадані середовища виконання (хост/ОС/модель/мислення). - Додані bootstrap-файли робочого простору в **Project Context**. Повний розбір: [Системний промпт](/uk/concepts/system-prompt). ## Додані файли робочого простору (Project Context) За замовчуванням OpenClaw додає фіксований набір файлів робочого простору (якщо вони наявні): - `AGENTS.md` - `SOUL.md` - `TOOLS.md` - `IDENTITY.md` - `USER.md` - `HEARTBEAT.md` - `BOOTSTRAP.md` (лише під час першого запуску) Великі файли обрізаються пофайлово за допомогою `agents.defaults.bootstrapMaxChars` (за замовчуванням `20000` символів). OpenClaw також застосовує загальний ліміт bootstrap-додавання для всіх файлів через `agents.defaults.bootstrapTotalMaxChars` (за замовчуванням `60000` символів). `/context` показує розміри **raw vs injected** і чи відбулося обрізання. Коли відбувається обрізання, середовище виконання може додати блок попередження в промпт під Project Context. Налаштуйте це через `agents.defaults.bootstrapPromptTruncationWarning` (`off`, `once`, `always`; за замовчуванням `always`). ## Skills: додані чи завантажені на вимогу Системний промпт містить компактний **список Skills** (назва + опис + розташування). Цей список має реальне накладне навантаження. Інструкції Skill _не_ включаються за замовчуванням. Очікується, що модель `read` `SKILL.md` Skill **лише за потреби**. ## Інструменти: є дві вартості Інструменти впливають на контекст двома способами: 1. **Текст списку інструментів** у системному промпті (те, що ви бачите як "Tooling"). 2. **Схеми інструментів** (JSON). Вони надсилаються моделі, щоб вона могла викликати інструменти. Вони враховуються в контексті, хоча ви не бачите їх як звичайний текст. `/context detail` розбиває найбільші схеми інструментів, щоб ви бачили, що домінує. ## Команди, директиви та "вбудовані скорочення" Команди зі скісною рискою обробляє Gateway. Є кілька різних типів поведінки: - **Окремі команди**: повідомлення, яке містить лише `/...`, виконується як команда. - **Директиви**: `/think`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/model`, `/queue` видаляються до того, як модель побачить повідомлення. - Повідомлення, що містять лише директиви, зберігають налаштування сеансу. - Вбудовані директиви у звичайному повідомленні діють як підказки для окремого повідомлення. - **Вбудовані скорочення** (лише дозволені відправники): певні токени `/...` всередині звичайного повідомлення можуть виконуватися негайно (приклад: "hey /status") і видаляються до того, як модель побачить решту тексту. Докладніше: [Команди зі скісною рискою](/uk/tools/slash-commands). ## Сеанси, Compaction і обрізання (що зберігається) Те, що зберігається між повідомленнями, залежить від механізму: - **Звичайна історія** зберігається в стенограмі сеансу, доки її не буде стиснуто/обрізано політикою. - **Compaction** зберігає підсумок у стенограмі та залишає останні повідомлення без змін. - **Обрізання** видаляє старі результати інструментів із _внутрішньопам'ятного_ промпта, щоб звільнити місце в контекстному вікні, але не переписує стенограму сеансу - повну історію все ще можна переглянути на диску. Документація: [Сеанс](/uk/concepts/session), [Compaction](/uk/concepts/compaction), [Обрізання сеансу](/uk/concepts/session-pruning). За замовчуванням OpenClaw використовує вбудований контекстний рушій `legacy` для складання та Compaction. Якщо ви встановите Plugin, що надає `kind: "context-engine"`, і виберете його через `plugins.slots.contextEngine`, OpenClaw делегує складання контексту, `/compact` і пов'язані хуки життєвого циклу контексту під-агентів цьому рушію. `ownsCompaction: false` не виконує автоматичний fallback до рушія `legacy`; активний рушій усе одно має коректно реалізовувати `compact()`. Див. [Контекстний рушій](/uk/concepts/context-engine), щоб отримати повний підключуваний інтерфейс, хуки життєвого циклу та конфігурацію. ## Що насправді повідомляє `/context` `/context` надає перевагу останньому звіту системного промпта, **побудованому під час запуску**, коли він доступний: - `System prompt (run)` = отримано з останнього вбудованого (з підтримкою інструментів) запуску та збережено в сховищі сеансу. - `System prompt (estimate)` = обчислено на льоту, коли звіту запуску немає (або під час запуску через CLI-бекенд, який не генерує звіт). У будь-якому разі він повідомляє розміри й головних учасників; він **не** виводить повний системний промпт або схеми інструментів. У детальному режимі він також порівнює стенограму сеансу з тим самим предикатом повідомлень реальної розмови, який використовує Compaction, тож високе використання промпта/кешу легше відрізнити від історії розмови, яку можна стиснути. ## Пов'язане Користувацьке додавання контексту через plugins. Підсумовування довгих розмов, щоб утримувати їх у вікні моделі. Як будується системний промпт і що він додає на кожному ході. Повний цикл виконання агента від вхідного повідомлення до фінальної відповіді.