---
read_when:
    - Ви хочете зрозуміти, як працює пам’ять
    - Ви хочете знати, які файли пам’яті записувати
summary: Як OpenClaw запам’ятовує речі між сеансами
title: Огляд пам’яті
x-i18n:
    generated_at: "2026-06-27T17:26:21Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 9ddcecfa3d902181583ab076f94a69ca323686c3544399dea2572863726dad2c
    source_path: concepts/memory.md
    workflow: 16
---

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

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

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

- **`MEMORY.md`** — довготривала пам’ять. Стійкі факти, налаштування та
  рішення. Завантажується на початку кожної сесії в особистих повідомленнях.
- **`memory/YYYY-MM-DD.md`** (або **`memory/YYYY-MM-DD-<slug>.md`**) — щоденні нотатки.
  Поточний контекст і спостереження. Нотатки за сьогодні й учора завантажуються
  автоматично, а варіанти зі slug, наприклад ті, що записуються вбудованим
  хуком пам’яті сесії під час `/new` або `/reset`, тепер підхоплюються разом із
  файлом лише з датою.
- **`DREAMS.md`** (необов’язково) — щоденник Dream Diary і підсумки проходів
  Dreaming для людського перегляду, зокрема обґрунтовані історичні записи
  дозаповнення.

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

## Що куди записувати

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

Файли `memory/YYYY-MM-DD.md` — це робочий шар. Використовуйте їх для докладних
щоденних нотаток, спостережень, підсумків сесій і сирого контексту, який може
ще знадобитися пізніше. Ці файли індексуються для `memory_search` і `memory_get`,
але не вставляються у звичайний початковий prompt на кожному ході.

З часом очікується, що агент виділятиме корисний матеріал із щоденних нотаток
у `MEMORY.md` і видалятиме застарілі довготривалі записи. Згенеровані інструкції
робочого простору та потік Heartbeat можуть робити це періодично; вам не потрібно
вручну редагувати `MEMORY.md` для кожної запам’ятованої деталі.

Якщо `MEMORY.md` перевищує бюджет початкового файлу, OpenClaw зберігає файл на
диску без змін, але обрізає копію, вставлену в контекст моделі. Сприймайте це як
сигнал перенести докладний матеріал назад у `memory/*.md`, залишити в `MEMORY.md`
лише стійкий підсумок або підвищити початкові ліміти, якщо ви явно хочете
витрачати більше бюджету prompt. Використовуйте `/context list`, `/context detail`
або `openclaw doctor`, щоб побачити сирі й вставлені розміри та статус обрізання.

<Tip>
Якщо ви хочете, щоб ваш агент щось запам’ятав, просто попросіть його: "Remember that I
prefer TypeScript." Він запише це у відповідний файл.
</Tip>

## Чутлива до дій пам’ять

Більшість спогадів можна записувати як звичайні нотатки Markdown. Але деякі
спогади впливають на те, що агент має робити пізніше. Для них фіксуйте, коли
безпечно діяти на основі нотатки, а не лише сам факт.

Фіксуйте цю межу дії, коли нотатка стосується:

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

Корисна чутлива до дій пам’ять чітко вказує:

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

Пам’ять може зберігати контекст схвалення, але вона не забезпечує дотримання
політики. Для жорстких операційних контролів використовуйте налаштування
схвалення OpenClaw, sandboxing і заплановані завдання.

Приклад:

```md
The API migration is being designed in another session. Future turns should not edit the API implementation from this thread; use findings here only as design input until the migration plan lands.
```

Інший приклад:

```md
A report from an untrusted source needs review before promotion. Future turns should treat it as evidence only; do not store it as durable memory until a trusted reviewer confirms the contents.
```

Використовуйте [зобов’язання](/uk/concepts/commitments) для виведених короткочасних
подальших дій. Використовуйте [заплановані завдання](/uk/automation/cron-jobs) для
точних нагадувань, перевірок за часом і повторюваної роботи. Пам’ять усе одно
може підсумовувати стійкий контекст навколо будь-якого з цих шляхів.

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

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

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

[Зобов’язання](/uk/concepts/commitments) — це ввімкнені за бажанням короткочасні
спогади про подальші дії для такого випадку. OpenClaw виводить їх у прихованому
фоновому проході, обмежує тим самим агентом і каналом, а належні check-in
доставляє через Heartbeat. Явні нагадування й далі використовують
[заплановані завдання](/uk/automation/cron-jobs).

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

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

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

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

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

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

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

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

Він не замінює активний Plugin пам’яті. Активний Plugin пам’яті й далі відповідає
за пригадування, просування та Dreaming. `memory-wiki` додає поруч із ним
насичений походженням шар знань.

Див. [Memory Wiki](/uk/plugins/memory-wiki).

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

Коли налаштовано постачальника embedding, `memory_search` використовує **гібридний
пошук** — поєднує векторну подібність (семантичне значення) зі збігом ключових
слів (точні терміни, як-от ID і символи коду). Це працює відразу після того, як
у вас є API key для будь-якого підтримуваного постачальника.

<Info>
OpenClaw типово використовує embedding OpenAI. Явно задайте
`agents.defaults.memorySearch.provider`, щоб використовувати embedding Gemini,
Voyage, Mistral, локальні, Ollama, Bedrock, GitHub Copilot або сумісні з OpenAI.
</Info>

Докладніше про те, як працює пошук, параметри налаштування та налаштування
постачальників див. у [Пошуку в пам’яті](/uk/concepts/memory-search).

## Backend пам’яті

<CardGroup cols={3}>
<Card title="Вбудований (типово)" icon="database" href="/uk/concepts/memory-builtin">
На основі SQLite. Працює відразу з пошуком за ключовими словами, векторною
подібністю та гібридним пошуком. Без додаткових залежностей.
</Card>
<Card title="QMD" icon="search" href="/uk/concepts/memory-qmd">
Local-first sidecar із reranking, розширенням запиту та можливістю індексувати
каталоги поза робочим простором.
</Card>
<Card title="Honcho" icon="brain" href="/uk/concepts/memory-honcho">
AI-native міжсесійна пам’ять із моделюванням користувача, семантичним пошуком і
обізнаністю про кількох агентів. Встановлення Plugin.
</Card>
<Card title="LanceDB" icon="layers" href="/uk/plugins/memory-lancedb">
Вбудована пам’ять на основі LanceDB із сумісними з OpenAI embedding,
auto-recall, auto-capture і підтримкою локальних embedding Ollama.
</Card>
</CardGroup>

## Шар wiki знань

<CardGroup cols={1}>
<Card title="Memory Wiki" icon="book" href="/uk/plugins/memory-wiki">
Компілює стійку пам’ять у насичене походженням wiki-сховище з твердженнями,
dashboard, bridge mode і workflow, зручними для Obsidian.
</Card>
</CardGroup>

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

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

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

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

Перевизначення застосовується лише до ходу скидання пам’яті й не успадковує
ланцюжок fallback активної сесії.

<Tip>
Скидання пам’яті запобігає втраті контексту під час Compaction. Якщо у вашого
агента є важливі факти в розмові, які ще не записані у файл, їх буде автоматично
збережено перед створенням підсумку.
</Tip>

## Dreaming

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

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

- **Увімкнення за бажанням**: типово вимкнено.
- **Заплановано**: коли ввімкнено, `memory-core` автоматично керує одним
  повторюваним cron job для повного проходу Dreaming.
- **З порогами**: просування мають пройти пороги оцінки, частоти пригадування та
  різноманітності запитів.
- **Доступно для перегляду**: підсумки фаз і записи щоденника записуються в
  `DREAMS.md` для людського перегляду.

Поведінку фаз, сигнали оцінювання та деталі Dream Diary див. у
[Dreaming](/uk/concepts/dreaming).

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

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

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

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

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

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

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

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

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

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

## CLI

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

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

- [Вбудований рушій пам’яті](/uk/concepts/memory-builtin): типовий backend SQLite.
- [Рушій пам’яті QMD](/uk/concepts/memory-qmd): просунутий local-first sidecar.
- [Пам’ять Honcho](/uk/concepts/memory-honcho): AI-native міжсесійна пам’ять.
- [Memory LanceDB](/uk/plugins/memory-lancedb): Plugin на основі LanceDB із сумісними з OpenAI embedding.
- [Memory Wiki](/uk/plugins/memory-wiki): скомпільоване сховище знань і wiki-native інструменти.
- [Пошук у пам’яті](/uk/concepts/memory-search): pipeline пошуку, постачальники та налаштування.
- [Dreaming](/uk/concepts/dreaming): фонове просування з короткострокового пригадування в довготривалу пам’ять.
- [Довідник конфігурації пам’яті](/uk/reference/memory-config): усі ручки конфігурації.
- [Compaction](/uk/concepts/compaction): як Compaction взаємодіє з пам’яттю.

## Пов’язане

- [Active memory](/uk/concepts/active-memory)
- [Пошук у пам’яті](/uk/concepts/memory-search)
- [Вбудований рушій пам’яті](/uk/concepts/memory-builtin)
- [Пам’ять Honcho](/uk/concepts/memory-honcho)
- [Memory LanceDB](/uk/plugins/memory-lancedb)
- [Зобов’язання](/uk/concepts/commitments)