Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

У довгих сесіях накопичується вивід інструментів, який роздуває вікно контексту. Це збільшує вартість і може змусити виконати 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, очищення типово вимкнене. Щоб увімкнути: 
{
  agents: {
    defaults: {
      contextPruning: { mode: "cache-ttl", ttl: "5m" },
    },
  },
}
Щоб вимкнути: задайте mode: "off".

​
Очищення проти Compaction

ОчищенняCompaction
ЩоОбрізає результати інструментівПідсумовує розмову
Збережено?Ні (для кожного запиту)Так (у транскрипті)
ОбсягЛише результати інструментівУся розмова
Вони доповнюють одне одного — очищення підтримує компактність виводу інструментів між циклами Compaction.

​
Додаткові матеріали

  • Compaction — зменшення контексту на основі підсумовування
  • Конфігурація Gateway — усі параметри конфігурації очищення (contextPruning.*)

​
Пов’язане