Вернуться ко всем гайдам

Гайд по Dreaming и Memory Wiki в OpenClaw

Как включить Dreaming, понять Memory Wiki и безопасно обновить OpenClaw через coding-агентов.

Поставил себе последнее обновление OpenClaw, полёт нормальный.

У многих возникают с этим проблемы, поэтому хочу дать вайбкодерский совет: используйте кодинг-агентов для установки и обновлений. Codex, Claude Code, Gemini CLI, да хоть плагин Cline для VS Code, их очень много разных.

Команда openclaw update может вызывать проблемы по разным причинам. Может, в релизе что-то изменили, а может, у вас нестандартная установка OpenClaw была.

Просто подключитесь к серверу, пропишите команду:

npm i -g @openai/codex

Потом пропишите codex. Теперь попросите агента изучить ваш сервер, то, как установлен OpenClaw, пришлите ему ссылку на changelog и ссылку на OpenClaw docs. Скажите сделать бэкап и обновиться до последней версии.

Всё, с вероятностью 99% всё будет хорошо, а если нет, он сам поправит или, на крайний случай, откатится через бэкап. Также не забывайте пушить агентов на GitHub.

Теперь про мои впечатления от небольших тестов. Начали появляться verbose-сообщения: OpenClaw Update Plan. То есть агент для больших задач реально составляет план и идёт по нему.

Я включил openclaw dreaming, одной командой в Telegram делается. Если вам всё время токенов не хватает и память не нужна, лучше не включать.

И разобрался с OpenClaw Wiki, достаточно навороченная система. Пока не придумал, какую инфу там хранить для себя. Может, буду запихивать свои тексты, чтобы он запоминал, как я пишу.

Ниже полноценный гайд для тех, кто ещё не до конца разобрался в этих двух новых фичах.

Гайд по Dreaming и Memory Wiki в OpenClaw

1. Как устроена память в OpenClaw

OpenClaw помнит только то, что записано в файлы внутри workspace агента. Скрытой постоянной памяти у него нет. Главные файлы памяти такие:

  • MEMORY.md — долговременная память, то есть факты, решения и важные вещи, которые надо держать долго.

  • memory/YYYY-MM-DD.md — ежедневные заметки. Это текущий рабочий слой памяти.

  • DREAMS.md — файл dreaming, если dreaming включён.

Обычная память остаётся основой всей системы. Dreaming не заменяет память, а помогает ей укрепляться. Wiki тоже не заменяет память, а строит поверх неё более аккуратную базу знаний.

2. Что такое Dreaming

Dreaming — это фоновый механизм укрепления памяти. Он смотрит на недавние записи и сигналы из памяти, пытается понять, что повторяется и что действительно важно, а потом часть такого материала переносит в MEMORY.md.

Если совсем просто, dreaming нужен для того, чтобы память не была просто свалкой заметок. Он помогает со временем оставлять в долговременной памяти только то, что реально стоит запомнить.

Dreaming выключен по умолчанию. После включения он работает по расписанию и сам запускает полный проход.

3. Что пишет Dreaming

Dreaming хранит служебные данные в папке memory/.dreams/. Там лежат краткосрочные сигналы, служебные файлы, точки продолжения и прочее внутреннее состояние.

Понятные человеку записи dreaming пишет в DREAMS.md или dreams.md. Туда попадают заметки о проходах и дневник dreaming. Иногда могут появляться и дополнительные отчёты в memory/dreaming/<phase>/YYYY-MM-DD.md.

В долговременную память, то есть в MEMORY.md, пишет только та часть dreaming, которая отвечает за окончательное продвижение важных записей.

4. Из каких фаз состоит Dreaming

Dreaming по стандарту использует сразу три фазы:

  • Light — подготавливает свежий материал. В MEMORY.md не пишет.

  • REM — ищет темы, повторы и отражения. В MEMORY.md не пишет.

  • Deep — решает, что стоит перенести в долговременную память. Именно эта фаза пишет в MEMORY.md.

Полный проход идёт так: light -> REM -> deep

Важно понимать, что это не пользовательские режимы, которые обычно включают по отдельности. Это внутренняя логика dreaming. Когда ты включаешь dreaming, ты включаешь сразу весь этот цикл.

5. Как Dreaming решает, что важно

Deep-фаза смотрит не на один признак, а сразу на несколько. Документация выделяет шесть основных сигналов:

  • как часто запись всплывала,

  • насколько она была уместна при поиске,

  • в скольких разных запросах и контекстах она появлялась,

  • насколько она свежая,

  • повторялась ли мысль через несколько дней,

  • насколько запись богата по смыслу.

Кроме этого, Light и REM тоже добавляют усиление сигналов. Поэтому в MEMORY.md должно попадать не всё подряд, а только то, что действительно набрало достаточно оснований.

Значения по умолчанию в документации такие:

  • minScore = 0.8 — минимальная общая оценка кандидата.

  • minRecallCount = 3 — запись должна всплыть хотя бы несколько раз.

  • minUniqueQueries = 3 — запись должна появиться не в одном и том же запросе, а в нескольких разных.

  • recencyHalfLifeDays = 14 — свежие записи ценятся выше, а их вес со временем падает.

  • maxAgeDays = 30 — слишком старый материал не продвигается бесконечно.

Они важны для понимания поведения, но обычно вручную это не трогают.

6. Что можно настроить в Dreaming

Основные пользовательские настройки лежат здесь:

  • plugins.entries.memory-core.config.dreaming

По сути, главных настроек две:

  • enabled — включает или выключает dreaming целиком.

  • frequency — задаёт расписание полного прохода.

Значение по умолчанию для расписания:

  • 0 3 * * *

Это значит: один полный проход каждый день в 03:00.

Пример конфига из документации:

{
  "plugins": {
    "entries": {
      "memory-core": {
        "config": {
          "dreaming": {
            "enabled": true,
            "frequency": "0 3 * * *"
          }
        }
      }
    }
  }
}

7. Команды для Dreaming

Самая частая настройка через CLI выглядит так:

openclaw config set plugins.entries.memory-core.config.dreaming.enabled true
openclaw config set plugins.entries.memory-core.config.dreaming.frequency "0 3 * * *"
openclaw gateway restart

Что делает каждая команда:

  • openclaw config set ...enabled true — включает dreaming в конфиге.

  • openclaw config set ...frequency "0 3 * * *" — ставит ежедневный запуск в 03:00.

  • openclaw gateway restart — перезапускает gateway, чтобы новая настройка точно подхватилась.

Проверить, что dreaming реально включился, можно так:

openclaw memory status --deep

Здесь:

  • memory status показывает состояние памяти.

  • --deep просит не краткий ответ, а более полную диагностику, включая dreaming, индекс, векторы и пути файлов.

Если хочется посмотреть кандидатов на продвижение вручную, пригодятся такие команды:

openclaw memory promote
openclaw memory promote --apply

Что они делают:

  • openclaw memory promote — показывает, что dreaming считает хорошими кандидатами, но ничего не записывает.

  • openclaw memory promote --apply — реально записывает подходящие кандидаты в MEMORY.md.

Если нужно понять, работает ли dreaming после включения, стоит проверить:

  • есть ли DREAMS.md,

  • появилась ли папка memory/.dreams/,

  • появляются ли со временем новые записи в MEMORY.md.

8. Что такое Memory Wiki

Memory Wiki — это дополнительный слой поверх обычной памяти. Она нужна, когда хочется превратить память не просто в набор markdown-файлов, а в более понятную и структурированную базу знаний.

Wiki не отвечает за сам поиск по памяти, не отвечает за dreaming и не заменяет memory-core. Она стоит рядом с обычной памятью и собирает из неё более аккуратную картину: страницы, сводки, источники, противоречия, вопросы и отчёты.

Если объяснить очень просто, то обычная память отвечает за запоминание, а wiki — за наведение порядка в знаниях.

9. Что даёт Wiki

Wiki добавляет отдельное хранилище страниц, предсказуемую структуру, сводки, утверждения с доказательствами, отметки уверенности, противоречия, открытые вопросы и готовые отчёты.

Она также даёт собственные инструменты:

  • wiki_status — посмотреть состояние wiki.

  • wiki_search — искать по wiki.

  • wiki_get — читать конкретную страницу.

  • wiki_apply — вносить узкие и безопасные правки.

  • wiki_lint — проверять качество, противоречия и проблемы.

То есть смысл wiki в том, чтобы память была не просто сохранена, а ещё и аккуратно организована.

10. Как wiki связана с обычной памятью

В OpenClaw роли разделены. Обычная память через memory-core, QMD или другой активный плагин отвечает за:

  • поиск,

  • индексирование,

  • продвижение записей,

  • dreaming.

memory-wiki отвечает за:

  • страницы wiki,

  • сводки,

  • доказательства,

  • отчёты,

  • отдельный поиск и чтение именно по wiki.

То есть wiki не подменяет память, а добавляет поверх неё более аккуратный слой знаний.

11. Режимы работы Wiki

У wiki есть три режима.

isolated

Это полностью отдельная wiki со своими источниками. Она не зависит от memory-core. Такой режим хорош, если ты хочешь отдельную базу знаний, которую ведёшь как самостоятельную систему.

bridge

Это самый интересный режим, если wiki должна опираться на обычную память. В этом режиме wiki читает публичные артефакты памяти и может подтягивать ежедневные заметки, dream-отчёты, корневые файлы памяти и журналы событий.

unsafe-local

Это экспериментальный режим прямого доступа к локальным путям. Он нужен редко и использовать его без явной причины не стоит.

12. Как устроена папка Wiki

После openclaw wiki init создаётся структура примерно такого вида:

<vault>/
  AGENTS.md
  WIKI.md
  index.md
  inbox.md
  entities/
  concepts/
  syntheses/
  sources/
  reports/
  _attachments/
  _views/
  .openclaw-wiki/

Главный смысл папок такой:

  • sources/ — сырые материалы и то, что пришло из bridge.

  • entities/ — люди, проекты, системы и объекты.

  • concepts/ — идеи, правила и понятия.

  • syntheses/ — сводки и обзорные страницы.

  • reports/ — автоматические отчёты.

  • .openclaw-wiki/ — служебные файлы и кэш wiki.

13. Что хранит Wiki кроме обычного текста

Wiki может хранить не только обычные страницы, но и структурированные утверждения с доказательствами.

У утверждений могут быть такие поля:

  • id — уникальный идентификатор утверждения.

  • text — сам текст утверждения.

  • status — текущее состояние, например требует проверки или считается подтверждённым.

  • confidence — уровень уверенности.

  • evidence[] — список доказательств.

  • updatedAt — когда это обновлялось.

У доказательств могут быть такие поля:

  • sourceId — идентификатор источника.

  • path — путь к файлу или странице-источнику.

  • lines — какие строки служат опорой.

  • weight — насколько сильное это доказательство.

  • note — пояснение.

  • updatedAt — время обновления.

Это полезно, когда важно не просто записать мысль, а понимать, откуда она взялась, насколько она надёжна и нет ли рядом противоречий.

14. Что делает сборка Wiki

Команда openclaw wiki compile читает страницы wiki, собирает сводки, строит индекс и обновляет машинные файлы.

Главные служебные файлы такие:

  • .openclaw-wiki/cache/agent-digest.json — компактная сводка wiki для системы.

  • .openclaw-wiki/cache/claims.jsonl — список утверждений в машинном виде.

Они нужны для того, чтобы системе не приходилось каждый раз вручную разбирать markdown. Благодаря этому поиск, чтение и отчёты работают стабильнее.

Если включены дашборды, сборка также обновляет отчёты в папке reports/.

15. Какие отчёты умеет Wiki

Когда включён render.createDashboards, wiki создаёт отчёты в папке reports/. Удобнее воспринимать их сразу вместе с назначением:

  • reports/open-questions.md — список открытых вопросов, которые ещё не закрыты.

  • reports/contradictions.md — места, где знания спорят друг с другом.

  • reports/low-confidence.md — страницы и утверждения с низкой уверенностью.

  • reports/claim-health.md — общее состояние утверждений и доказательств.

  • reports/stale-pages.md — страницы, которые выглядят устаревшими.

То есть эти отчёты нужны не просто для красоты, а чтобы быстро понять, где в wiki беспорядок, слабые места или пробелы.

16. Поиск и чтение в Wiki

Wiki умеет работать с двумя вариантами поиска:

  • shared — через общий механизм памяти, если он доступен.

  • local — локально по самой wiki.

Также доступны три корпуса:

  • wiki — искать только по wiki.

  • memory — искать по обычной памяти.

  • all — искать сразу по обоим слоям.

Практически это значит следующее. Если нужен один широкий поиск по всему, удобно использовать memory_search corpus=all. Если важны именно структура wiki, происхождение знаний и страница как объект, лучше использовать wiki_search и wiki_get.

17. Что можно настроить в Wiki

Все настройки лежат здесь:

  • plugins.entries.memory-wiki.config

Ниже самые важные параметры.

  • vaultMode — режим работы wiki. Может быть isolated, bridge или unsafe-local.

  • vault.path — путь к папке, где физически лежит wiki.

  • vault.renderMode — формат записи. native означает обычный режим OpenClaw, obsidian удобен для работы через Obsidian.

  • search.backend — как именно искать: через общий механизм (shared) или локально (local).

  • search.corpus — по какому корпусу искать: wiki, memory или all.

  • context.includeCompiledDigestPrompt — добавлять ли компактную сводку wiki прямо в контекст агента.

  • render.createBacklinks — автоматически создавать обратные ссылки между страницами.

  • render.createDashboards — автоматически строить отчёты.

  • render.preserveHumanBlocks — стараться сохранять человеческие ручные блоки при обновлениях.

Если используется bridge, особенно важны такие параметры:

  • bridge.enabled — вообще включён ли режим bridge.

  • bridge.readMemoryArtifacts — читать ли публичные артефакты основной памяти.

  • bridge.indexDreamReports — подтягивать ли dream-отчёты.

  • bridge.indexDailyNotes — подтягивать ли ежедневные заметки.

  • bridge.indexMemoryRoot — подтягивать ли корневые файлы памяти, например MEMORY.md.

  • bridge.followMemoryEvents — учитывать ли события памяти.

Полный пример конфига из документации:

{
  "plugins": {
    "entries": {
      "memory-wiki": {
        "enabled": true,
        "config": {
          "vaultMode": "isolated",
          "vault": {
            "path": "~/.openclaw/wiki/main",
            "renderMode": "obsidian"
          },
          "obsidian": {
            "enabled": true,
            "useOfficialCli": true,
            "vaultName": "OpenClaw Wiki",
            "openAfterWrites": false
          },
          "bridge": {
            "enabled": false,
            "readMemoryArtifacts": true,
            "indexDreamReports": true,
            "indexDailyNotes": true,
            "indexMemoryRoot": true,
            "followMemoryEvents": true
          },
          "ingest": {
            "autoCompile": true,
            "maxConcurrentJobs": 1,
            "allowUrlIngest": true
          },
          "search": {
            "backend": "shared",
            "corpus": "wiki"
          },
          "context": {
            "includeCompiledDigestPrompt": false
          },
          "render": {
            "preserveHumanBlocks": true,
            "createBacklinks": true,
            "createDashboards": true
          }
        }
      }
    }
  }
}

18. Команды для Wiki

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki bridge import

Для аккуратных правок без ручного редактирования страниц используется wiki apply, например:

openclaw wiki apply synthesis "Alpha Summary" --body "Short synthesis body" --source-id source.alpha

Разбор параметров:

  • apply synthesis — значит, что команда создаёт или обновляет страницу-сводку.

  • "Alpha Summary" — заголовок этой сводки.

  • --body — основной текст сводки.

  • --source-id — источник, на который эта сводка опирается.

То есть wiki apply нужен, когда ты хочешь менять wiki аккуратно и предсказуемо, не ковыряя руками управляемые блоки.

19. Obsidian и Wiki

Если включить режим obsidian, wiki будет писать markdown в удобном для Obsidian виде. При желании можно использовать официальный Obsidian CLI.

Это нужно только тем, кто реально ведёт знания через Obsidian. Если ты не пользуешься Obsidian, эта часть тебе не обязательна.

20. Dreaming и Wiki при нескольких агентах

Если у тебя несколько агентов с разными workspace, dreaming работает для каждого агента отдельно. У каждого будут свои MEMORY.md, memory/*.md, DREAMS.md и memory/.dreams/. Память между агентами сама по себе не смешивается.

С wiki возможны два подхода. Можно сделать отдельную wiki на каждого агента. А можно сделать одну общую wiki и дать нескольким агентам один и тот же путь vault.path. Но в реальной работе обычно лучше, чтобы одну общую wiki в основном обслуживал один агент, а остальные больше читали и ссылались на неё.

21. Когда это вообще нужно

Dreaming полезен, если у агента есть живая память, повторяющиеся темы и смысл вести MEMORY.md как качественную долговременную память. Если агент очень узкий, почти ничего не запоминает и не живёт долго, польза будет меньше.

Wiki полезна, если хочется не просто хранить записи, а иметь нормальную базу знаний: со страницами, сводками, доказательствами, вопросами, противоречиями и отчётами. Если памяти мало и хватает обычных markdown-файлов, без wiki можно спокойно жить.

22. Короткая шпаргалка

Включить Dreaming

openclaw config set plugins.entries.memory-core.config.dreaming.enabled true
openclaw config set plugins.entries.memory-core.config.dreaming.frequency "0 3 * * *"
openclaw gateway restart

Проверить Dreaming

openclaw memory status --deep

Базовый старт Wiki

openclaw wiki status
openclaw wiki init
openclaw wiki doctor
openclaw wiki compile
openclaw wiki lint

23. Самое важное в двух фразах

Dreaming — это фоновое укрепление памяти: он помогает переносить действительно важное из свежих записей в MEMORY.md.

Memory Wiki — это структурированный слой знаний поверх памяти: страницы, сводки, доказательства, вопросы, противоречия и отчёты.