---
read_when:
    - Ви хочете зменшити зростання контексту через вивід інструментів
    - Ви хочете зрозуміти оптимізацію кешу підказок Anthropic
summary: Обрізання старих результатів інструментів, щоб зберігати контекст компактним, а кешування — ефективним
title: Очищення сесії
x-i18n:
    generated_at: "2026-04-26T02:23:04Z"
    model: gpt-5.4
    provider: openai
    source_hash: 3ea07f0ae23076906e2ff0246ac75813572f98cffa50afddb6a6b0af8964c4a9
    source_path: concepts/session-pruning.md
    workflow: 15
---

Очищення сесії обрізає **старі результати інструментів** із контексту перед кожним викликом LLM. Це зменшує роздування контексту через накопичені виводи інструментів (результати виконання, читання файлів, результати пошуку), не переписуючи звичайний текст розмови.

<Info>
Очищення виконується лише в пам’яті — воно не змінює транскрипт сесії на диску.
Уся ваша історія завжди зберігається.
</Info>

## Чому це важливо

У довгих сесіях накопичується вивід інструментів, який роздуває вікно контексту. Це
збільшує вартість і може змусити виконати [Compaction](/uk/concepts/compaction) раніше,
ніж потрібно.

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

## Як це працює

1. Дочекайтеся завершення TTL кешу (типово 5 хвилин).
2. Знайдіть старі результати інструментів для звичайного очищення (текст розмови залишається без змін).
3. **М’яко обріжте** надто великі результати — збережіть початок і кінець, вставте `...`.
4. **Повністю очистьте** решту — замініть її заповнювачем.
5. Скиньте TTL, щоб наступні запити повторно використовували свіжий кеш.

## Очищення застарілих зображень

OpenClaw також будує окреме ідемпотентне представлення повторного відтворення для сесій,
які зберігають у сирій історії блоки зображень або маркери медіа гідратації промпту.

- Воно зберігає **3 найновіші завершені ходи** побайтно без змін, щоб префікси кешу
  промптів для нещодавніх наступних запитів залишалися стабільними.
- У представленні повторного відтворення старіші вже оброблені блоки зображень з історії `user` або
  `toolResult` можуть бути замінені на
  `[image data removed - already processed by model]`.
- Старіші текстові посилання на медіа, такі як `[media attached: ...]`,
  `[Image: source: ...]` і `media://inbound/...`, можуть бути замінені на
  `[media reference removed - already processed by model]`. Маркери вкладень
  поточного ходу залишаються недоторканими, щоб моделі зору все ще могли
  гідратувати нові зображення.
- Сирий транскрипт сесії не переписується, тому переглядачі історії все ще можуть
  відображати оригінальні записи повідомлень та їхні зображення.
- Це окремо від звичайного очищення за 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](/uk/concepts/compaction) — зменшення контексту на основі підсумовування
- [Конфігурація Gateway](/uk/gateway/configuration) — усі параметри конфігурації очищення
  (`contextPruning.*`)

## Пов’язане

- [Керування сесіями](/uk/concepts/session)
- [Інструменти сесії](/uk/concepts/session-tool)
- [Рушій контексту](/uk/concepts/context-engine)
