Контекст¶

«Контекст» — это всё, что OpenClaw отправляет модели для одного запуска. Он ограничен окном контекста модели (лимитом токенов).

Интуитивная модель для начинающих:

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

Контекст — это не то же самое, что «память»: память может храниться на диске и загружаться позже; контекст — это то, что находится внутри текущего окна модели.

Быстрый старт (просмотр контекста)¶

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

См. также: Slash commands, Token use & costs, Compaction.

Пример вывода¶

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

/context list¶

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,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)

Что учитывается в окне контекста¶

Учитывается всё, что получает модель, включая:

• Системный промпт (все разделы).
• Историю диалога.
• Вызовы инструментов + результаты инструментов.
• Вложения/транскрипты (изображения/аудио/файлы).
• Сводки компакции и артефакты обрезки.
• «Обёртки» провайдера или скрытые заголовки (не видны, но учитываются).

Как OpenClaw формирует системный промпт¶

Системный промпт принадлежит OpenClaw и пересобирается при каждом запуске. Он включает:

• Список инструментов + краткие описания.
• Список Skills (только метаданные; см. ниже).
• Расположение рабочего пространства.
• Время (UTC + преобразованное пользовательское время при настройке).
• Метаданные среды выполнения (хост/ОС/модель/режим рассуждений).
• Внедрённые загрузочные файлы рабочего пространства в разделе Project Context.

Полная разбивка: System Prompt.

Внедрённые файлы рабочего пространства (Project Context)¶

По умолчанию OpenClaw внедряет фиксированный набор файлов рабочего пространства (если они присутствуют):

• AGENTS.md
• SOUL.md
• TOOLS.md
• IDENTITY.md
• USER.md
• HEARTBEAT.md
• BOOTSTRAP.md (только при первом запуске)

Большие файлы обрезаются пофайлово с использованием agents.defaults.bootstrapMaxChars (по умолчанию 20000 символов). /context показывает размеры исходные vs внедрённые и факт обрезки.

Skills: что внедряется, а что загружается по требованию¶

Системный промпт включает компактный список Skills (имя + описание + расположение). Этот список создаёт реальную нагрузку.

Инструкции Skills по умолчанию не включаются. Ожидается, что модель будет read SKILL.md Skills только при необходимости.

Инструменты: есть две статьи затрат¶

Инструменты влияют на контекст двумя способами:

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

/context detail разбивает крупнейшие схемы инструментов, чтобы было видно, что доминирует.

Команды, директивы и «встроенные сокращения»¶

Slash‑команды обрабатываются Gateway (шлюз). Существует несколько вариантов поведения:

• Отдельные команды: сообщение, состоящее только из /..., выполняется как команда.
• Директивы: /think, /verbose, /reasoning, /elevated, /model, /queue удаляются до того, как модель увидит сообщение.
• Сообщения, состоящие только из директив, сохраняют настройки сеанса.
• Встроенные директивы в обычном сообщении действуют как подсказки на сообщение.
• Встроенные сокращения (только для отправителей из списка разрешённых): определённые токены /... внутри обычного сообщения могут выполняться немедленно (пример: «hey /status») и удаляются до того, как модель увидит оставшийся текст.

Подробности: Slash commands.

Сеансы, компакция и обрезка (что сохраняется)¶

То, что сохраняется между сообщениями, зависит от механизма:

• Обычная история сохраняется в транскрипте сеанса до компакции/обрезки по политике.
• Компакция сохраняет сводку в транскрипт и оставляет последние сообщения без изменений.
• Обрезка удаляет старые результаты инструментов из памяти промпта для конкретного запуска, но не переписывает транскрипт.

Документация: Session, Compaction, Session pruning.

Что на самом деле сообщает /context¶

/context предпочитает последний отчёт системного промпта, собранный для запуска, когда он доступен:

• System prompt (run) = захвачен из последнего встроенного (с поддержкой инструментов) запуска и сохранён в хранилище сеансов.
• System prompt (estimate) = вычисляется на лету, когда отчёта о запуске нет (или при работе через CLI‑бэкенд, который не формирует отчёт).

В любом случае он сообщает размеры и основные вкладчики; он не выводит полный системный промпт или схемы инструментов.