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

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

# Як це працює

Ваш агент має три файли, пов’язані з пам’яттю:

• MEMORY.md — довгострокова пам’ять. Стійкі факти, уподобання та рішення. Завантажується на початку кожного сеансу DM.
• memory/YYYY-MM-DD.md — щоденні нотатки. Поточний контекст і спостереження. Нотатки за сьогодні та вчора завантажуються автоматично.
• DREAMS.md (необов’язково) — щоденник Dream Diary і зведення sweep для dreaming для перегляду людиною, включно з обґрунтованими історичними записами backfill.

Ці файли розташовані в робочій області агента (типово ~/.openclaw/workspace).

# Виведені зобов’язання

Деякі майбутні подальші дії не є стійкими фактами. Якщо ви згадуєте співбесіду завтра, корисною пам’яттю може бути «перевірити після співбесіди», а не «зберігати це назавжди в MEMORY.md».

Зобов’язання — це opt-in, короткотривалі спогади про подальші дії для такого випадку. OpenClaw виводить їх у прихованому фоновому проході, обмежує тим самим агентом і каналом та доставляє належні check-in через Heartbeat. Явні нагадування й надалі використовують заплановані завдання.

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

Агент має два інструменти для роботи з пам’яттю:

• memory_search — знаходить релевантні нотатки за допомогою семантичного пошуку, навіть коли формулювання відрізняється від оригіналу.
• memory_get — читає конкретний файл пам’яті або діапазон рядків.

Обидва інструменти надаються активним Plugin пам’яті (типово: memory-core).

# Супутній Plugin Memory Wiki

Якщо ви хочете, щоб стійка пам’ять працювала радше як підтримувана база знань, а не просто сирі нотатки, використовуйте вбудований Plugin memory-wiki.

memory-wiki компілює стійкі знання у wiki-сховище з:

• детермінованою структурою сторінок
• структурованими твердженнями та доказами
• відстеженням суперечностей і актуальності
• згенерованими панелями
• скомпільованими дайджестами для агентів і споживачів runtime
• wiki-нативними інструментами на кшталт wiki_search, wiki_get, wiki_apply і wiki_lint

Він не замінює активний Plugin пам’яті. Активний Plugin пам’яті й надалі відповідає за recall, promotion і dreaming. memory-wiki додає поруч із ним шар знань із багатою провенансною інформацією.

Див. Memory Wiki.

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

Коли налаштовано постачальника embeddings, memory_search використовує гібридний пошук — поєднання векторної схожості (семантичного значення) з пошуком за ключовими словами (точні терміни, як-от ідентифікатори та символи коду). Це працює одразу, щойно у вас є API-ключ для будь-якого підтримуваного постачальника.

Докладніше про те, як працює пошук, параметри налаштування та налаштування постачальників див. у Пошуку в пам’яті.

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

# Шар wiki знань

# Автоматичний flush пам’яті

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

Щоб залишити цей службовий хід на локальній моделі, задайте точне перевизначення моделі memory-flush:

{
  "agents": {
    "defaults": {
      "compaction": {
        "memoryFlush": {
          "model": "ollama/qwen3:8b"
        }
      }
    }
  }
}

Перевизначення застосовується лише до ходу memory-flush і не успадковує fallback-ланцюжок активного сеансу.

# Dreaming

Dreaming — це необов’язковий фоновий прохід консолідації для пам’яті. Він збирає короткострокові сигнали, оцінює кандидатів і просуває в довгострокову пам’ять (MEMORY.md) лише ті елементи, що відповідають вимогам.

Він призначений для підтримання високої цінності довгострокової пам’яті:

• Opt-in: типово вимкнено.
• Заплановано: коли ввімкнено, memory-core автоматично керує одним повторюваним завданням cron для повного sweep dreaming.
• Порогово обмежено: promotion мають пройти пороги оцінки, частоти recall і різноманітності запитів.
• Доступно для перегляду: підсумки фаз і записи щоденника записуються в DREAMS.md для перегляду людиною.

Про поведінку фаз, сигнали оцінювання та деталі Dream Diary див. Dreaming.

# Обґрунтований backfill і live promotion

Система dreaming тепер має дві тісно пов’язані лінії перегляду:

• Live dreaming працює з короткострокового сховища dreaming у memory/.dreams/ і саме його використовує звичайна глибока фаза, коли вирішує, що може перейти в MEMORY.md.
• Обґрунтований backfill читає історичні нотатки memory/YYYY-MM-DD.md як окремі файли днів і записує структурований результат перегляду в DREAMS.md.

Обґрунтований backfill корисний, коли ви хочете відтворити старіші нотатки й перевірити, що система вважає стійким, без ручного редагування MEMORY.md.

Коли ви використовуєте:

openclaw memory rem-backfill --path ./memory --stage-short-term

обґрунтовані стійкі кандидати не просуваються напряму. Вони поміщаються в те саме короткострокове сховище dreaming, яке вже використовує звичайна глибока фаза. Це означає:

• DREAMS.md залишається поверхнею перегляду для людини.
• короткострокове сховище залишається машинною поверхнею ранжування.
• MEMORY.md і надалі записується лише через deep promotion.

Якщо ви вирішите, що replay не був корисним, ви можете видалити staged artifacts, не торкаючись звичайних записів щоденника або звичайного стану recall:

openclaw memory rem-backfill --rollback
openclaw memory rem-backfill --rollback-short-term

# CLI

openclaw memory status          # Check index status and provider
openclaw memory search "query"  # Search from the command line
openclaw memory index --force   # Rebuild the index

# Додаткове читання

• Вбудований рушій пам’яті: типовий бекенд SQLite.
• Рушій пам’яті QMD: розширений локальний sidecar.
• Пам’ять Honcho: AI-native пам’ять між сеансами.
• Memory LanceDB: Plugin на базі LanceDB з OpenAI-сумісними embeddings.
• Memory Wiki: скомпільоване сховище знань і wiki-нативні інструменти.
• Пошук у пам’яті: конвеєр пошуку, постачальники та налаштування.
• Dreaming: фонове promotion від короткострокового recall до довгострокової пам’яті.
• Довідник конфігурації пам’яті: усі перемикачі конфігурації.
• Compaction: як Compaction взаємодіє з пам’яттю.

# Пов’язане

• Active Memory
• Пошук у пам’яті
• Вбудований рушій пам’яті
• Пам’ять Honcho
• Memory LanceDB
• Зобов’язання