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

Огляд пам’яті

OpenClaw запам’ятовує речі, записуючи звичайні файли Markdown у робочому просторі вашого агента. Модель “пам’ятає” лише те, що зберігається на диску — жодного прихованого стану немає.

Як це працює

Ваш агент має три файли, пов’язані з пам’яттю:
  • MEMORY.md — довготривала пам’ять. Стійкі факти, уподобання та рішення. Завантажується на початку кожної сесії DM.
  • memory/YYYY-MM-DD.md — щоденні нотатки. Поточний контекст і спостереження. Нотатки за сьогодні й учора завантажуються автоматично.
  • DREAMS.md (експериментально, необов’язково) — щоденник снів і зведення циклів сновидіння для перегляду людиною, включно з обґрунтованими записами історичного дозаповнення.
Ці файли знаходяться в робочому просторі агента (типово ~/.openclaw/workspace).
Якщо ви хочете, щоб ваш агент щось запам’ятав, просто попросіть його: “Запам’ятай, що я віддаю перевагу TypeScript.” Він запише це у відповідний файл.

Інструменти пам’яті

Агент має два інструменти для роботи з пам’яттю:
  • memory_search — знаходить релевантні нотатки за допомогою семантичного пошуку, навіть якщо формулювання відрізняється від оригінального.
  • memory_get — читає конкретний файл пам’яті або діапазон рядків.
Обидва інструменти надаються активним плагіном пам’яті (типово: memory-core).

Супутній плагін Memory Wiki

Якщо ви хочете, щоб довготривала пам’ять більше нагадувала підтримувану базу знань, а не просто сирі нотатки, використовуйте вбудований плагін memory-wiki. memory-wiki компілює довготривалі знання у wiki vault із:
  • детермінованою структурою сторінок
  • структурованими твердженнями та доказами
  • відстеженням суперечностей і свіжості
  • згенерованими панелями моніторингу
  • скомпільованими дайджестами для споживачів агента/середовища виконання
  • wiki-native інструментами, такими як wiki_search, wiki_get, wiki_apply і wiki_lint
Він не замінює активний плагін пам’яті. Активний плагін пам’яті, як і раніше, відповідає за пригадування, просування та сновидіння. memory-wiki додає поруч із ним багатий на provenance шар знань. Див. Memory Wiki.

Пошук у пам’яті

Коли налаштовано постачальника embedding, memory_search використовує гібридний пошук — поєднання векторної подібності (семантичне значення) з пошуком за ключовими словами (точні терміни, як-от ID і символи коду). Це працює одразу після додавання API-ключа для будь-якого підтримуваного постачальника.
OpenClaw автоматично визначає вашого постачальника embedding за доступними API-ключами. Якщо у вас налаштовано ключ OpenAI, Gemini, Voyage або Mistral, пошук у пам’яті вмикається автоматично.
Докладніше про те, як працює пошук, параметри налаштування та налаштування постачальників, див. Пошук у пам’яті.

Бекенди пам’яті

Вбудований (типово)

На основі SQLite. Працює одразу з пошуком за ключовими словами, векторною подібністю та гібридним пошуком. Без додаткових залежностей.

QMD

Локальний sidecar із пріоритетом локальності, з reranking, розширенням запитів і можливістю індексувати каталоги поза робочим простором.

Honcho

AI-native пам’ять між сесіями з моделюванням користувача, семантичним пошуком і обізнаністю про кількох агентів. Встановлення через плагін.

Шар wiki знань

Memory Wiki

Компілює довготривалу пам’ять у wiki vault, багатий на provenance, із твердженнями, панелями моніторингу, bridge mode і дружніми до Obsidian робочими процесами.

Автоматичне скидання пам’яті

Перед тим як compaction узагальнить вашу розмову, OpenClaw виконує тихий хід, який нагадує агенту зберегти важливий контекст у файли пам’яті. Це ввімкнено типово — вам не потрібно нічого налаштовувати.
Скидання пам’яті запобігає втраті контексту під час compaction. Якщо у розмові агента є важливі факти, які ще не записано у файл, вони будуть автоматично збережені до того, як відбудеться зведення.

Сновидіння (експериментально)

Сновидіння — це необов’язковий фоновий етап консолідації пам’яті. Він збирає короткострокові сигнали, оцінює кандидатів і просуває до довготривалої пам’яті (MEMORY.md) лише відповідні елементи. Його розроблено так, щоб підтримувати високу інформативність довготривалої пам’яті:
  • За згодою: типово вимкнено.
  • За розкладом: коли ввімкнено, memory-core автоматично керує одним повторюваним cron-завданням для повного циклу сновидіння.
  • З порогами: просування має пройти пороги оцінки, частоти пригадування та різноманітності запитів.
  • Доступно для перегляду: підсумки фаз і записи щоденника записуються в DREAMS.md для перегляду людиною.
Про поведінку фаз, сигнали оцінювання та подробиці Щоденника снів див. Сновидіння (експериментально).

Обґрунтоване дозаповнення та живе просування

Система сновидіння тепер має дві тісно пов’язані лінії перегляду:
  • Живе сновидіння працює зі сховищем короткострокових сновидінь у memory/.dreams/ і саме його використовує звичайна глибока фаза, коли вирішує, що може перейти до MEMORY.md.
  • Обґрунтоване дозаповнення читає історичні нотатки memory/YYYY-MM-DD.md як окремі денні файли й записує структурований результат перегляду в DREAMS.md.
Обґрунтоване дозаповнення корисне, коли ви хочете відтворити старі нотатки й перевірити, що система вважає довготривалим, не редагуючи MEMORY.md вручну. Коли ви використовуєте:
openclaw memory rem-backfill --path ./memory --stage-short-term
обґрунтовані довготривалі кандидати не просуваються напряму. Вони розміщуються в тому самому сховищі короткострокових сновидінь, яке вже використовує звичайна глибока фаза. Це означає:
  • DREAMS.md залишається поверхнею для перегляду людиною.
  • короткострокове сховище залишається поверхнею ранжування для машини.
  • MEMORY.md як і раніше записується лише глибоким просуванням.
Якщо ви вирішите, що відтворення було некорисним, ви можете видалити підготовлені артефакти, не зачіпаючи звичайні записи щоденника чи нормальний стан пригадування:
openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

CLI

openclaw memory status          # Перевірити стан індексу та постачальника
openclaw memory search "query"  # Пошук з командного рядка
openclaw memory index --force   # Перебудувати індекс

Подальше читання