Memory Wiki

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

Що він додає

Окреме сховище wiki з детермінованим макетом сторінок
Структуровані метадані тверджень і доказів, а не лише звичайний текст
Походження на рівні сторінки, впевненість, суперечності та відкриті питання
Скомпільовані дайджести для споживачів agent/runtime
Власні для wiki інструменти search/get/apply/lint
Необов’язковий режим bridge, який імпортує публічні артефакти з активного плагіна пам’яті
Необов’язковий режим рендерингу, дружній до Obsidian, та інтеграція з CLI

Як це поєднується з пам’яттю

Думайте про цей поділ так:

Шар	Відповідає за
Активний плагін пам’яті (`memory-core`, QMD, Honcho тощо)	Пригадування, семантичний пошук, просування, dreaming, runtime пам’яті
`memory-wiki`	Скомпільовані wiki-сторінки, синтези з багатим походженням, панелі, wiki-специфічний search/get/apply

Якщо активний плагін пам’яті надає спільні артефакти пригадування, OpenClaw може шукати в обох шарах за один прохід через memory_search corpus=all. Коли вам потрібні wiki-специфічне ранжування, походження або прямий доступ до сторінки, використовуйте натомість wiki-native інструменти.

Режими сховища

memory-wiki підтримує три режими сховища:

`isolated`

Власне сховище, власні джерела, без залежності від memory-core. Використовуйте це, якщо хочете, щоб wiki була власним куруваним сховищем знань.

`bridge`

Зчитує публічні артефакти пам’яті та події пам’яті з активного плагіна пам’яті через публічні шви plugin SDK. Використовуйте це, якщо хочете, щоб wiki компілювала й упорядковувала експортовані артефакти плагіна пам’яті без звернення до приватних внутрішніх компонентів плагіна. Режим bridge може індексувати:

експортовані артефакти пам’яті
звіти dreaming
щоденні нотатки
кореневі файли пам’яті
журнали подій пам’яті

`unsafe-local`

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

Макет сховища

Плагін ініціалізує сховище так:

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

Керований вміст залишається всередині згенерованих блоків. Блоки нотаток, створені людиною, зберігаються. Основні групи сторінок:

sources/ для імпортованого сирого матеріалу та сторінок, підкріплених bridge
entities/ для довготривалих сутностей, людей, систем, проєктів і об’єктів
concepts/ для ідей, абстракцій, шаблонів і політик
syntheses/ для скомпільованих підсумків і підтримуваних зведень
reports/ для згенерованих панелей

Структуровані твердження та докази

Сторінки можуть містити структурований frontmatter claims, а не лише довільний текст. Кожне твердження може містити:

id
text
status
confidence
evidence[]
updatedAt

Записи доказів можуть містити:

sourceId
path
lines
weight
note
updatedAt

Саме це робить wiki більше схожою на шар переконань, ніж на пасивне сховище нотаток. Твердження можна відстежувати, оцінювати, оскаржувати й пов’язувати назад із джерелами.

Конвеєр компіляції

Крок компіляції читає wiki-сторінки, нормалізує підсумки та створює стабільні артефакти для машин під:

.openclaw-wiki/cache/agent-digest.json
.openclaw-wiki/cache/claims.jsonl

Ці дайджести існують для того, щоб агентам і коду runtime не доводилося парсити сторінки Markdown. Скомпільований вивід також забезпечує:

первинну індексацію wiki для потоків search/get
пошук за id тверджень із поверненням до сторінок-власників
компактні доповнення до prompt
генерацію звітів/панелей

Панелі та звіти про стан

Коли ввімкнено render.createDashboards, компіляція підтримує панелі в reports/. Вбудовані звіти включають:

reports/open-questions.md
reports/contradictions.md
reports/low-confidence.md
reports/claim-health.md
reports/stale-pages.md

Ці звіти відстежують такі речі, як:

кластери нотаток із суперечностями
кластери конкуруючих тверджень
твердження без структурованих доказів
сторінки й твердження з низькою впевненістю
застарілі або з невідомою свіжістю
сторінки з невирішеними питаннями

Пошук і отримання

memory-wiki підтримує два бекенди пошуку:

shared: використовувати спільний потік пошуку в пам’яті, якщо він доступний
local: шукати локально в wiki

Він також підтримує три корпуси:

wiki
memory
all

Важлива поведінка:

wiki_search і wiki_get використовують скомпільовані дайджести як перший прохід, коли це можливо
id тверджень можуть повертати до сторінки-власника
оспорювані/застарілі/свіжі твердження впливають на ранжування
мітки походження можуть зберігатися в результатах

Практичне правило:

використовуйте memory_search corpus=all для одного широкого проходу пригадування
використовуйте wiki_search + wiki_get, коли вам важливі wiki-специфічне ранжування, походження або структура переконань на рівні сторінки

Інструменти агента

Плагін реєструє такі інструменти:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

Що вони роблять:

wiki_status: поточний режим сховища, стан, доступність Obsidian CLI
wiki_search: пошук по wiki-сторінках і, коли налаштовано, по спільних корпусах пам’яті
wiki_get: читання wiki-сторінки за id/шляхом або повернення до спільного корпусу пам’яті
wiki_apply: вузькі мутації синтезу/метаданих без довільного редагування сторінки
wiki_lint: структурні перевірки, прогалини в походженні, суперечності, відкриті питання

Плагін також реєструє невиключне доповнення до корпусу пам’яті, тож спільні memory_search і memory_get можуть звертатися до wiki, коли активний плагін пам’яті підтримує вибір корпусу.

Поведінка prompt і контексту

Коли ввімкнено context.includeCompiledDigestPrompt, розділи prompt пам’яті додають компактний скомпільований знімок із agent-digest.json. Цей знімок навмисно є малим і високосигнальним:

лише верхні сторінки
лише верхні твердження
кількість суперечностей
кількість питань
кваліфікатори впевненості/свіжості

Це опціонально, бо змінює форму prompt і здебільшого корисне для рушіїв контексту або застарілих механізмів складання prompt, які явно споживають доповнення пам’яті.

Конфігурація

Розміщуйте конфігурацію в plugins.entries.memory-wiki.config:

{
  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,
          },
        },
      },
    },
  },
}

Ключові перемикачі:

vaultMode: isolated, bridge, unsafe-local
vault.renderMode: native або obsidian
bridge.readMemoryArtifacts: імпортувати публічні артефакти активного плагіна пам’яті
bridge.followMemoryEvents: включати журнали подій у режимі bridge
search.backend: shared або local
search.corpus: wiki, memory або all
context.includeCompiledDigestPrompt: додавати компактний знімок дайджесту до розділів prompt пам’яті
render.createBacklinks: генерувати детерміновані пов’язані блоки
render.createDashboards: генерувати сторінки панелей

CLI

memory-wiki також надає поверхню CLI верхнього рівня:

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki get entity.alpha
openclaw wiki apply synthesis "Alpha Summary" --body "..." --source-id source.alpha
openclaw wiki bridge import
openclaw wiki obsidian status

Див. CLI: wiki, щоб переглянути повний довідник команд.

Підтримка Obsidian

Коли vault.renderMode має значення obsidian, плагін записує Markdown, дружній до Obsidian, і за бажанням може використовувати офіційний obsidian CLI. Підтримувані робочі процеси включають:

перевірку стану
пошук по сховищу
відкриття сторінки
виклик команди Obsidian
перехід до щоденної нотатки

Це необов’язково. Wiki і надалі працює в режимі native без Obsidian.

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

Memory Wiki

Memory Wiki

Що він додає

Як це поєднується з пам’яттю

Режими сховища

`isolated`

`bridge`

`unsafe-local`

Макет сховища

Структуровані твердження та докази

Конвеєр компіляції

Панелі та звіти про стан

Пошук і отримання

Інструменти агента

Поведінка prompt і контексту

Конфігурація

CLI

Підтримка Obsidian

Рекомендований робочий процес

Пов’язані документи

Overview

Plugins

Skills

Automation & Tasks

Tools

Agent coordination

​Memory Wiki

​Що він додає

​Як це поєднується з пам’яттю

​Режими сховища

​isolated

​bridge

​unsafe-local

​Макет сховища

​Структуровані твердження та докази

​Конвеєр компіляції

​Панелі та звіти про стан

​Пошук і отримання

​Інструменти агента

​Поведінка prompt і контексту

​Конфігурація

​CLI

​Підтримка Obsidian

​Рекомендований робочий процес

​Пов’язані документи

Memory Wiki

Що він додає

Як це поєднується з пам’яттю

Режими сховища

`isolated`

`bridge`

`unsafe-local`

Макет сховища

Структуровані твердження та докази

Конвеєр компіляції

Панелі та звіти про стан

Пошук і отримання

Інструменти агента

Поведінка prompt і контексту

Конфігурація

CLI

Підтримка Obsidian

Рекомендований робочий процес

Пов’язані документи