---
read_when:
    - Вы хотите уменьшить рост контекста из-за выводов инструментов
    - Вы хотите понять оптимизацию кэша промптов Anthropic
summary: Удаление старых результатов инструментов для сохранения компактного контекста и эффективного кэширования
title: Обрезка сеанса
x-i18n:
    generated_at: "2026-06-28T22:52:49Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 3ea07f0ae23076906e2ff0246ac75813572f98cffa50afddb6a6b0af8964c4a9
    source_path: concepts/session-pruning.md
    workflow: 16
---

Обрезка сеанса удаляет **старые результаты инструментов** из контекста перед каждым
вызовом 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
{
  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)