> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Обрезка сеанса

Обрезка сеанса удаляет **старые результаты инструментов** из контекста перед каждым
вызовом LLM. Она уменьшает разрастание контекста из-за накопленных выводов инструментов
(результатов exec, чтений файлов, результатов поиска), не переписывая обычный текст разговора.

<Info>
  Обрезка выполняется только в памяти -- она не изменяет сохраненную на диске расшифровку сеанса.
  Вся ваша история всегда сохраняется.
</Info>

## Почему это важно

В длинных сеансах накапливается вывод инструментов, который раздувает окно контекста. Это
увеличивает стоимость и может вынудить выполнить [Compaction](/ru/concepts/compaction) раньше,
чем необходимо.

Обрезка особенно полезна для **кэширования промптов Anthropic**. После истечения TTL кэша
следующий запрос заново кэширует весь промпт. Обрезка уменьшает размер записи в кэш,
напрямую снижая стоимость.

## Как это работает

1. Дождаться истечения TTL кэша (по умолчанию 5 минут).
2. Найти старые результаты инструментов для обычной обрезки (текст разговора не трогается).
3. **Мягко обрезать** слишком большие результаты -- оставить начало и конец, вставить `...`.
4. **Жестко очистить** остальное -- заменить заполнителем.
5. Сбросить TTL, чтобы последующие запросы повторно использовали свежий кэш.

## Очистка устаревших изображений

OpenClaw также строит отдельное идемпотентное представление повторного воспроизведения для сеансов,
в истории которых сохраняются необработанные блоки изображений или медиа-маркеры гидратации промпта.

* Оно сохраняет **3 последних завершенных хода** байт-в-байт, чтобы префиксы
  кэша промптов для недавних последующих запросов оставались стабильными.
* В представлении повторного воспроизведения более старые уже обработанные блоки изображений из истории
  `user` или `toolResult` могут быть заменены на
  `[данные изображения удалены - уже обработаны моделью]`.
* Более старые текстовые ссылки на медиа, такие как `[медиа прикреплено: ...]`,
  `[Изображение: источник: ...]` и `media://inbound/...`, могут быть заменены на
  `[ссылка на медиа удалена - уже обработана моделью]`. Маркеры вложений текущего хода
  остаются нетронутыми, чтобы vision-модели по-прежнему могли гидратировать свежие
  изображения.
* Сырая расшифровка сеанса не переписывается, поэтому средства просмотра истории все еще могут
  отображать исходные записи сообщений и их изображения.
* Это отдельно от обычной обрезки по TTL кэша. Она нужна, чтобы повторяющиеся
  полезные нагрузки изображений или устаревшие ссылки на медиа не сбивали кэши промптов на последующих ходах.

## Умные значения по умолчанию

OpenClaw автоматически включает обрезку для профилей Anthropic:

| Тип профиля                                                                       | Обрезка включена | Heartbeat |
| --------------------------------------------------------------------------------- | ---------------- | --------- |
| OAuth/токен-аутентификация Anthropic (включая повторное использование Claude CLI) | Да               | 1 час     |
| API-ключ                                                                          | Да               | 30 мин    |

Если вы задаете явные значения, OpenClaw их не переопределяет.

## Включение или отключение

Для провайдеров не Anthropic обрезка по умолчанию выключена. Чтобы включить:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}
```

Чтобы отключить: задайте `mode: "off"`.

## Обрезка и Compaction

|                  | Обрезка                          | Compaction             |
| ---------------- | -------------------------------- | ---------------------- |
| **Что**          | Обрезает результаты инструментов | Суммаризирует разговор |
| **Сохраняется?** | Нет (для каждого запроса)        | Да (в расшифровке)     |
| **Область**      | Только результаты инструментов   | Весь разговор          |

Они дополняют друг друга -- обрезка сохраняет вывод инструментов компактным между
циклами Compaction.

## Дополнительные материалы

* [Compaction](/ru/concepts/compaction) -- сокращение контекста на основе суммаризации
* [Конфигурация Gateway](/ru/gateway/configuration) -- все параметры конфигурации обрезки
  (`contextPruning.*`)

## Связанные материалы

* [Управление сеансами](/ru/concepts/session)
* [Инструменты сеанса](/ru/concepts/session-tool)
* [Движок контекста](/ru/concepts/context-engine)