--- read_when: - Вы хотите понять, что означает «context» в OpenClaw - Вы отлаживаете, почему модель что-то «знает» (или забыла) - Вы хотите уменьшить накладные расходы контекста (/context, /status, /compact) summary: 'Контекст: что видит модель, как он формируется и как его проверить' title: Контекст x-i18n: generated_at: "2026-06-28T22:49:15Z" 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, размер системного промпта и количество сообщений стенограммы, доступных для Compaction. - `/context map` → изображение древовидной карты в стиле WinDirStat с текущими отслеживаемыми вкладчиками контекста сессии. - `/usage tokens` → добавлять футер использования по токенам к обычным ответам. - `/compact` → суммировать старую историю в компактную запись, чтобы освободить место в окне. См. также: [Слеш-команды](/ru/tools/slash-commands), [Использование токенов и затраты](/ru/reference/token-use), [Compaction](/ru/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-файлы рабочей области в разделе **Контекст проекта**. Полная разбивка: [Системный промпт](/ru/concepts/system-prompt). ## Внедренные файлы рабочей области (Контекст проекта) По умолчанию 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` показывает размеры **исходный против внедренного** и было ли усечение. Когда происходит усечение, среда выполнения может внедрить блок предупреждения прямо в промпт в разделе Контекст проекта. Настройте это через `agents.defaults.bootstrapPromptTruncationWarning` (`off`, `once`, `always`; по умолчанию `always`). ## Skills: внедренные и загружаемые по запросу Системный промпт включает компактный **список Skills** (имя + описание + расположение). У этого списка есть реальная накладная стоимость. Инструкции Skills _не_ включаются по умолчанию. Ожидается, что модель выполнит `read` для `SKILL.md` нужного Skills **только при необходимости**. ## Инструменты: есть две стоимости Инструменты влияют на контекст двумя способами: 1. **Текст списка инструментов** в системном промпте (то, что вы видите как "Инструментарий"). 2. **Схемы инструментов** (JSON). Они отправляются модели, чтобы она могла вызывать инструменты. Они учитываются в контексте, хотя вы не видите их как обычный текст. `/context detail` разбивает самые большие схемы инструментов, чтобы вы могли увидеть, что доминирует. ## Команды, директивы и "встроенные сокращения" Слеш-команды обрабатываются Gateway. Есть несколько разных вариантов поведения: - **Отдельные команды**: сообщение, состоящее только из `/...`, выполняется как команда. - **Директивы**: `/think`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/model`, `/queue` удаляются до того, как модель увидит сообщение. - Сообщения, состоящие только из директив, сохраняют настройки сессии. - Встроенные директивы в обычном сообщении действуют как подсказки для конкретного сообщения. - **Встроенные сокращения** (только для отправителей из allowlist): определенные токены `/...` внутри обычного сообщения могут выполниться сразу (пример: "эй /status") и удаляются до того, как модель увидит оставшийся текст. Подробности: [Слеш-команды](/ru/tools/slash-commands). ## Сессии, Compaction и обрезка (что сохраняется) То, что сохраняется между сообщениями, зависит от механизма: - **Обычная история** сохраняется в стенограмме сессии, пока не будет compacted/обрезана политикой. - **Compaction** сохраняет сводку в стенограмму и оставляет последние сообщения без изменений. - **Обрезка** удаляет старые результаты инструментов из промпта _в памяти_, чтобы освободить место в окне контекста, но не переписывает стенограмму сессии — полная история все еще доступна для просмотра на диске. Документация: [Сессия](/ru/concepts/session), [Compaction](/ru/concepts/compaction), [Обрезка сессии](/ru/concepts/session-pruning). По умолчанию OpenClaw использует встроенный контекстный движок `legacy` для сборки и Compaction. Если вы установите Plugin, который предоставляет `kind: "context-engine"`, и выберете его через `plugins.slots.contextEngine`, OpenClaw делегирует сборку контекста, `/compact` и связанные хуки жизненного цикла контекста subagent этому движку. `ownsCompaction: false` не выполняет автоматический fallback к движку `legacy`; активный движок все равно должен корректно реализовывать `compact()`. См. [Контекстный движок](/ru/concepts/context-engine) для полного подключаемого интерфейса, хуков жизненного цикла и конфигурации. ## Что на самом деле сообщает `/context` `/context` предпочитает последний отчет системного промпта, **собранный при запуске**, когда он доступен: - `System prompt (run)` = захвачен из последнего встроенного запуска (с поддержкой инструментов) и сохранен в хранилище сессии. - `System prompt (estimate)` = вычисляется на лету, когда отчета о запуске нет (или при запуске через CLI-бэкенд, который не генерирует отчет). В любом случае он сообщает размеры и основных вкладчиков; он **не** выводит полный системный промпт или схемы инструментов. В подробном режиме он также сравнивает стенограмму сессии с тем же предикатом сообщений реального разговора, который используется Compaction, поэтому высокое использование промпта/кэша легче отличить от истории разговора, доступной для Compaction. ## Связанные материалы Пользовательское внедрение контекста через plugins. Суммирование длинных разговоров, чтобы удерживать их внутри окна модели. Как строится системный промпт и что он внедряет на каждом ходе. Полный цикл выполнения агента от входящего сообщения до финального ответа.