Обрізання сесії
Обрізання сесії обрізає старі результати інструментів із контексту перед кожним
викликом LLM. Це зменшує роздування контексту через накопичені виводи інструментів (результати exec, читання файлів, результати пошуку) без переписування звичайного тексту розмови.
Обрізання виконується лише в пам’яті — воно не змінює транскрипт сесії на диску.
Повна історія завжди зберігається.
Чому це важливо
У довгих сесіях накопичується вивід інструментів, який збільшує вікно контексту. Це
підвищує вартість і може змусити compaction відбутися раніше,
ніж потрібно.
Обрізання особливо корисне для Anthropic prompt caching. Після завершення TTL кешу
наступний запит повторно кешує весь prompt. Обрізання зменшує розмір запису в кеш, що безпосередньо знижує вартість.
Як це працює
- Дочекайтеся завершення TTL кешу (типово 5 хвилин).
- Знайдіть старі результати інструментів для звичайного обрізання (текст розмови не змінюється).
- М’яко обріжте надто великі результати — залиште початок і кінець, вставте
....
- Повністю очистьте решту — замініть placeholder.
- Скиньте TTL, щоб подальші запити використовували свіжий кеш повторно.
Очищення застарілих зображень
OpenClaw також виконує окреме ідемпотентне очищення для старіших застарілих сесій, які
зберігали сирі блоки зображень в історії.
- Воно зберігає 3 найновіші завершені ходи байт у байт, щоб префікси prompt
cache для нещодавніх follow-up запитів залишалися стабільними.
- Старіші вже оброблені блоки зображень в історії
user або toolResult можуть
бути замінені на [image data removed - already processed by model].
- Це окремо від звичайного обрізання за TTL кешу. Воно існує, щоб повторні
payload зображень не ламали prompt cache на пізніших ходах.
Розумні типові значення
OpenClaw автоматично вмикає обрізання для профілів Anthropic:
| Тип профілю | Обрізання ввімкнено | Heartbeat |
|---|
| Автентифікація Anthropic OAuth/token (включно з повторним використанням Claude CLI) | Так | 1 година |
| API key | Так | 30 хв |
Увімкнення або вимкнення
Для провайдерів, відмінних від Anthropic, обрізання типово вимкнене. Щоб увімкнути:
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
mode: "off".
Обрізання проти compaction
| Обрізання | Compaction |
|---|
| Що | Обрізає результати інструментів | Узагальнює розмову |
| Зберігається? | Ні (для кожного запиту) | Так (у транскрипті) |
| Область | Лише результати інструментів | Уся розмова |
Додаткові матеріали
