Plugins

Вікі пам’яті

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

Він не замінює Plugin active memory. Plugin active memory і далі відповідає за recall, promotion, indexing і dreaming. memory-wiki працює поруч із ним і компілює довготривалі знання в навіговну вікі з детермінованими сторінками, структурованими твердженнями, provenance, dashboards і machine-readable digests.

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

Що він додає

Окреме вікі-сховище з детермінованим макетом сторінок
Метадані структурованих тверджень і доказів, а не лише прозу
Provenance, confidence, contradictions і open questions на рівні сторінки
Скомпільовані digests для agent/runtime-споживачів
Вікі-нативні інструменти search/get/apply/lint
Необов’язковий bridge mode, який імпортує публічні artifacts з Plugin active memory
Необов’язковий Obsidian-friendly режим рендерингу та інтеграція з CLI

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

Уявляйте цей поділ так:

Шар	Відповідає за
Plugin active memory (`memory-core`, QMD, Honcho тощо)	Recall, semantic search, promotion, dreaming, memory runtime
`memory-wiki`	Скомпільовані вікі-сторінки, provenance-rich syntheses, dashboards, wiki-specific search/get/apply

Якщо Plugin active memory надає спільні recall artifacts, OpenClaw може шукати в обох шарах за один прохід через memory_search corpus=all.

Коли потрібні вікі-специфічне ранжування, provenance або прямий доступ до сторінок, використовуйте натомість вікі-нативні інструменти.

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

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

`isolated`

Власне сховище, власні джерела, без залежності від memory-core.

Використовуйте це, коли хочете, щоб вікі була власним куруваним сховищем знань.

`bridge`

Читає публічні memory artifacts і memory events з Plugin active memory через публічні plugin SDK seams.

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

Bridge mode може індексувати:

експортовані memory artifacts
dream reports
daily notes
memory root files
memory event logs

`unsafe-local`

Явний escape hatch для локальних приватних шляхів на тій самій машині.

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

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

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

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

Керований вміст лишається всередині generated blocks. Human note blocks зберігаються.

Основні групи сторінок:

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

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

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

Кожне твердження може містити:

id
text
status
confidence
evidence[]
updatedAt

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

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

Саме це змушує вікі поводитися радше як belief layer, ніж як пасивний dump нотаток. Claims можна відстежувати, оцінювати, оскаржувати та розв’язувати назад до джерел.

Метадані сутностей для агентів

Сторінки сутностей також можуть містити routing metadata для використання агентами. Це generic frontmatter, тому він працює для людей, команд, систем, проєктів або будь-якого іншого типу сутності.

Поширені поля:

entityType: наприклад person, team, system або project
canonicalId: стабільний identity key, що використовується між aliases та imports
aliases: імена, handles або labels, які мають розв’язуватися в ту саму сторінку
privacyTier: public, local-private, sensitive або confirm-before-use
bestUsedFor / notEnoughFor: стислі routing hints
lastRefreshedAt: timestamp оновлення джерела, окремий від часу редагування сторінки
personCard: необов’язкова routing card для людей із handles, socials, emails, timezone, lane, ask-for, avoid-asking-for, confidence і privacy
relationships: typed edges до пов’язаних сторінок із target, kind, weight, confidence, evidence kind, privacy tier і note

Для people wiki агент зазвичай має починати з reports/person-agent-directory.md, потім відкривати сторінку людини через wiki_get перед використанням контактних даних або виведених фактів.

Приклад:

pageType: entity
entityType: person
id: entity.brad-groux
canonicalId: maintainer.brad-groux
aliases:
  - Brad
  - bgroux
privacyTier: local-private
bestUsedFor:
  - Microsoft Teams and Azure routing
notEnoughFor:
  - legal approval
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@bgroux"
  socials:
    - "https://x.example/bgroux"
  emails:
    - [email protected]
  timezone: America/Chicago
  lane: Microsoft ecosystem
  askFor:
    - Teams rollout questions
  avoidAskingFor:
    - unrelated billing decisions
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.alice
    targetTitle: Alice
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.brad.teams
    text: Brad is useful for Microsoft Teams routing.
    status: supported
    confidence: 0.9
    evidence:
      - kind: maintainer-whois
        sourceId: source.maintainers
        privacyTier: local-private

Compile pipeline

Compile-крок читає вікі-сторінки, нормалізує summaries і створює стабільні machine-facing artifacts у:

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

Ці digests існують, щоб agents і runtime code не мусили scrape Markdown сторінки.

Скомпільований output також живить:

first-pass wiki indexing для search/get flows
claim-id lookup назад до owning pages
compact prompt supplements
генерування reports/dashboards

Dashboards і звіти про стан

Коли render.createDashboards увімкнено, compile підтримує dashboards у reports/.

Вбудовані reports містять:

reports/open-questions.md
reports/contradictions.md
reports/low-confidence.md
reports/claim-health.md
reports/stale-pages.md
reports/person-agent-directory.md
reports/relationship-graph.md
reports/provenance-coverage.md
reports/privacy-review.md

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

contradiction note clusters
competing claim clusters
claims без структурованих доказів
сторінки й claims із низькою confidence
stale або unknown freshness
сторінки з unresolved questions
person/entity routing cards
structured relationship edges
evidence class coverage
non-public privacy tiers, які потребують review перед використанням

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

memory-wiki підтримує два search backends:

shared: використовувати shared memory search flow, коли доступно
local: шукати вікі локально

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

wiki
memory
all

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

wiki_search і wiki_get використовують compiled digests як перший прохід, коли можливо
claim ids можуть розв’язуватися назад до owning page
contested/stale/fresh claims впливають на ranking
provenance labels можуть зберігатися в results
search mode може зміщувати ranking для person lookup, question routing, source evidence або raw claims

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

використовуйте memory_search corpus=all для одного широкого recall-проходу
використовуйте wiki_search + wiki_get, коли важливі wiki-specific ranking, provenance або page-level belief structure

Search modes:

auto: збалансований типовий режим
find-person: підсилює person-like entities, aliases, handles, socials і canonical IDs
route-question: підсилює agent cards, ask-for hints, best-used-for hints і relationship context
source-evidence: підсилює source pages і structured evidence metadata
raw-claim: підсилює matching structured claims і повертає claim/evidence metadata в results

Коли result відповідає structured claim, wiki_search може повернути matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds і evidenceSourceIds у своєму details payload. Text output також містить компактні рядки Claim: і Evidence:, коли вони доступні.

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

Plugin реєструє ці інструменти:

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

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

wiki_status: поточний vault mode, health, доступність Obsidian CLI
wiki_search: шукає wiki pages і, коли налаштовано, shared memory corpora; приймає mode для person lookup, question routing, source evidence або raw claim drilldown
wiki_get: читає wiki page за id/path або fallback до shared memory corpus
wiki_apply: вузькі synthesis/metadata mutations без freeform page surgery
wiki_lint: structural checks, provenance gaps, contradictions, open questions

Plugin також реєструє non-exclusive memory corpus supplement, тому shared memory_search і memory_get можуть діставатися до вікі, коли Plugin active memory підтримує corpus selection.

Поведінка prompt і context

Коли context.includeCompiledDigestPrompt увімкнено, memory prompt sections додають compact compiled snapshot з agent-digest.json.

Цей snapshot навмисно малий і high-signal:

лише top pages
лише top claims
contradiction count
question count
confidence/freshness qualifiers

Це opt-in, бо змінює prompt shape і переважно корисне для context engines або legacy prompt assembly, які явно споживають memory supplements.

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

Розмістіть config у 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: імпортувати публічні артефакти plugin Active Memory
bridge.followMemoryEvents: включати журнали подій у режимі bridge
search.backend: shared або local
search.corpus: wiki, memory або all
context.includeCompiledDigestPrompt: додавати компактний знімок дайджесту до розділів memory prompt
render.createBacklinks: генерувати детерміновані пов’язані блоки
render.createDashboards: генерувати сторінки панелей керування

Приклад: QMD + режим bridge

Використовуйте це, коли вам потрібен QMD для пригадування і memory-wiki для підтримуваного шару знань:

{
  memory: {
    backend: "qmd",
  },
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "bridge",
          bridge: {
            enabled: true,
            readMemoryArtifacts: true,
            indexDreamReports: true,
            indexDailyNotes: true,
            indexMemoryRoot: true,
            followMemoryEvents: true,
          },
          search: {
            backend: "shared",
            corpus: "all",
          },
          context: {
            includeCompiledDigestPrompt: false,
          },
        },
      },
    },
  },
}

Це зберігає:

QMD керує пригадуванням Active Memory
memory-wiki зосереджений на скомпільованих сторінках і панелях керування
форма prompt лишається незмінною, доки ви навмисно не ввімкнете prompt скомпільованого дайджесту

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, plugin записує зручний для Obsidian Markdown і може додатково використовувати офіційний CLI obsidian.

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

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

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

Вікі пам’яті

Що він додає

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

Рекомендований гібридний шаблон

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

`isolated`

`bridge`

`unsafe-local`

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

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

Метадані сутностей для агентів

Compile pipeline

Dashboards і звіти про стан

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

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

Поведінка prompt і context

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

Приклад: QMD + режим bridge

CLI

Підтримка Obsidian

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

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

Ask OpenClaw

# Що він додає

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

# Рекомендований гібридний шаблон

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

# isolated

# bridge

# unsafe-local

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

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

# Метадані сутностей для агентів

# Compile pipeline

# Dashboards і звіти про стан

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

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

# Поведінка prompt і context

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

# Приклад: QMD + режим bridge

# CLI

# Підтримка Obsidian

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

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

Що він додає

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

Рекомендований гібридний шаблон

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

`isolated`

`bridge`

`unsafe-local`

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

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

Метадані сутностей для агентів

Compile pipeline

Dashboards і звіти про стан

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

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

Поведінка prompt і context

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

Приклад: QMD + режим bridge

CLI

Підтримка Obsidian

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

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