---
read_when:
    - Ви хочете зрозуміти, що означає «контекст» в OpenClaw
    - Ви налагоджуєте, чому модель «знає» щось (або забула це)
    - Ви хочете зменшити накладні витрати контексту (`/context`, `/status`, `/compact`)
summary: 'Контекст: що бачить модель, як її побудовано та як її перевірити'
title: Контекст
x-i18n:
    generated_at: "2026-04-18T03:32:03Z"
    model: gpt-5.4
    provider: openai
    source_hash: 477ccb1d9654968d0e904b6846b32b8c14db6b6c0d3d2ec2b7409639175629f9
    source_path: concepts/context.md
    workflow: 15
---

# Контекст

«Контекст» — це **все, що OpenClaw надсилає моделі для запуску**. Його обмежує **вікно контексту** моделі (ліміт токенів).

Ментальна модель для початківців:

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

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

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

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

Див. також: [Слеш-команди](/uk/tools/slash-commands), [Використання токенів і витрати](/uk/reference/token-use), [Compaction](/uk/concepts/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)
```

## Що враховується у вікні контексту

Усе, що отримує модель, зараховується, зокрема:

- Системний промпт (усі розділи).
- Історія розмови.
- Виклики інструментів + результати інструментів.
- Вкладення/транскрипти (зображення/аудіо/файли).
- Підсумки Compaction і артефакти обрізання.
- «Обгортки» провайдера або приховані заголовки (не видимі, але все одно враховуються).

## Як OpenClaw будує системний промпт

Системний промпт **належить OpenClaw** і перебудовується для кожного запуску. Він включає:

- Список інструментів + короткі описи.
- Список Skills (лише метадані; див. нижче).
- Розташування робочого простору.
- Час (UTC + перетворений час користувача, якщо налаштовано).
- Метадані середовища виконання (хост/ОС/модель/мислення).
- Вбудовані bootstrap-файли робочого простору в розділі **Project Context**.

Повний розбір: [System Prompt](/uk/concepts/system-prompt).

## Вбудовані файли робочого простору (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` потрібного Skill **лише за потреби**.

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

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

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

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

## Команди, директиви та «вбудовані скорочення»

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

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

Докладніше: [Слеш-команди](/uk/tools/slash-commands).

## Сесії, Compaction і pruning (що зберігається)

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

- **Звичайна історія** зберігається в транскрипті сесії, доки не буде стиснена/обрізана політикою.
- **Compaction** зберігає підсумок у транскрипті та залишає недавні повідомлення недоторканими.
- **Pruning** видаляє старі результати інструментів із _контексту в пам’яті_ для запуску, але не переписує транскрипт.

Документація: [Session](/uk/concepts/session), [Compaction](/uk/concepts/compaction), [Session pruning](/uk/concepts/session-pruning).

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

## Що насправді показує `/context`

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

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

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

## Пов’язане

- [Context Engine](/uk/concepts/context-engine) — власне вбудовування контексту через plugins
- [Compaction](/uk/concepts/compaction) — підсумовування довгих розмов
- [System Prompt](/uk/concepts/system-prompt) — як будується системний промпт
- [Agent Loop](/uk/concepts/agent-loop) — повний цикл виконання агента
