Контекст

“Контекст” — це все, що OpenClaw надсилає моделі для запуску. Він обмежений контекстним вікном моделі (лімітом токенів). Ментальна модель для початківців:

Системний промпт (створений OpenClaw): правила, інструменти, список Skills, час/середовище виконання та впроваджені файли робочого простору.
Історія розмови: ваші повідомлення + повідомлення асистента для цього сеансу.
Виклики інструментів/результати + вкладення: вивід команд, читання файлів, зображення/аудіо тощо.

Контекст — це не те саме, що “пам’ять”: пам’ять може зберігатися на диску й перезавантажуватися пізніше; контекст — це те, що всередині поточного вікна моделі.

Швидкий старт (перевірка контексту)

/status → швидкий огляд “наскільки заповнене моє вікно?” + налаштування сеансу.
/context list → що впроваджено + приблизні розміри (за файлом + підсумки).
/context detail → глибша розбивка: розміри за файлом, схемами інструментів, записами Skills і системним промптом.
/context map → зображення мапи у стилі WinDirStat для відстежуваних внесків у контекст поточного сеансу.
/usage tokens → додавати футер використання за відповідь до звичайних відповідей.
/compact → підсумувати старішу історію в компактний запис, щоб звільнити простір вікна.

Див. також: Слеш-команди, Використання токенів і витрати, Compaction.

Приклад виводу

Значення залежать від моделі, провайдера, політики інструментів і того, що є у вашому робочому просторі.

`/context list`

🧠 Context breakdown
Workspace: <workspaceDir>
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.

Повна розбивка: Системний промпт.

Впроваджені файли робочого простору (Project Context)

За замовчуванням OpenClaw впроваджує фіксований набір файлів робочого простору (якщо вони наявні):

AGENTS.md
SOUL.md
TOOLS.md
IDENTITY.md
USER.md
HEARTBEAT.md
BOOTSTRAP.md (лише під час першого запуску)

Великі файли обрізаються окремо для кожного файлу за допомогою agents.defaults.bootstrapMaxChars (за замовчуванням 12000 символів). OpenClaw також застосовує загальний ліміт bootstrap-впровадження для всіх файлів через agents.defaults.bootstrapTotalMaxChars (за замовчуванням 60000 символів). /context показує розміри raw vs injected і чи відбулося обрізання. Коли відбувається обрізання, середовище виконання може впровадити блок попередження безпосередньо в промпт у розділі Project Context. Налаштуйте це за допомогою agents.defaults.bootstrapPromptTruncationWarning (off, once, always; за замовчуванням once).

Skills: впроваджуються чи завантажуються на вимогу

Системний промпт містить компактний список Skills (назва + опис + розташування). Цей список має реальні накладні витрати. Інструкції Skills не включаються за замовчуванням. Очікується, що модель виконає read для SKILL.md відповідної Skills лише за потреби.

Інструменти: є дві вартості

Інструменти впливають на контекст двома способами:

Текст списку інструментів у системному промпті (те, що ви бачите як “Tooling”).
Схеми інструментів (JSON). Вони надсилаються моделі, щоб вона могла викликати інструменти. Вони враховуються в контексті, хоча ви не бачите їх як звичайний текст.

/context detail розбиває найбільші схеми інструментів, щоб ви могли побачити, що домінує.

Команди, директиви та “вбудовані скорочення”

Слеш-команди обробляє Gateway. Є кілька різних варіантів поведінки:

Окремі команди: повідомлення, яке містить лише /..., виконується як команда.
Директиви: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue вилучаються до того, як модель побачить повідомлення.
- Повідомлення, що містять лише директиви, зберігають налаштування сеансу.
- Вбудовані директиви у звичайному повідомленні діють як підказки для конкретного повідомлення.
Вбудовані скорочення (лише для дозволених відправників): певні токени /... усередині звичайного повідомлення можуть виконуватися негайно (приклад: “hey /status”) і вилучаються до того, як модель побачить решту тексту.

Докладніше: Слеш-команди.

Сеанси, Compaction і обрізання (що зберігається)

Що зберігається між повідомленнями, залежить від механізму:

Звичайна історія зберігається в транскрипті сеансу, доки її не буде compacted/pruned за політикою.
Compaction зберігає підсумок у транскрипті й залишає останні повідомлення без змін.
Обрізання відкидає старі результати інструментів з підказки в пам’яті, щоб звільнити місце в контекстному вікні, але не переписує транскрипт сеансу - повну історію все ще можна переглянути на диску.

Документація: Сеанс, Compaction, Обрізання сеансу. За замовчуванням OpenClaw використовує вбудований контекстний рушій legacy для складання та Compaction. Якщо ви встановите Plugin, який надає kind: "context-engine", і виберете його через plugins.slots.contextEngine, OpenClaw делегує складання контексту, /compact і пов’язані хуки життєвого циклу контексту субагентів цьому рушію. ownsCompaction: false не виконує автоматичного fallback до рушія legacy; активний рушій усе ще має коректно реалізовувати compact(). Див. Контекстний рушій, щоб переглянути повний підключуваний інтерфейс, хуки життєвого циклу та конфігурацію.

Що насправді повідомляє `/context`

/context надає перевагу останньому побудованому під час запуску звіту системного промпта, коли він доступний:

System prompt (run) = захоплено з останнього вбудованого запуску (з підтримкою інструментів) і збережено в сховищі сеансу.
System prompt (estimate) = обчислюється на льоту, коли звіту запуску немає (або під час роботи через CLI-бекенд, який не генерує звіт).

У будь-якому разі він повідомляє розміри й основних учасників; він не виводить повний системний промпт або схеми інструментів.

Пов’язане