概述

memory-wiki 是 OpenClaw 内置插件,将持久记忆编译为结构化知识库(wiki vault)。它不替代主动记忆插件,而是作为伴侣插件运行,将记忆编译为具有确定性页面布局、结构化声明(claims)、来源溯源(provenance)、仪表盘和机器可读摘要的可导航知识库。

核心功能

  • 三种 Vault 模式:isolated(独立知识库)、bridge(从主动记忆插件导入公开制品)、unsafe-local(本地文件系统直接访问)
  • 结构化声明:页面可携带 claims frontmatter,每条声明含 id/text/status/confidence/evidence,支持追踪、评分、争议和溯源
  • 实体元数据:支持 entityType、canonicalId、aliases、privacyTier、personCard、relationships 等路由元数据
  • 编译管道:生成 .openclaw-wiki/cache/agent-digest.json 和 claims.jsonl,供 Agent 和运行时代码使用
  • 仪表盘报告:reports/open-questions.md、reports/contradictions.md、reports/low-confidence.md、reports/person-agent-directory.md 等
  • Agent 工具:wiki_status、wiki_search(支持 find-person/route-question/source-evidence/raw-claim 模式)、wiki_get、wiki_apply、wiki_lint
  • Obsidian 支持:vault.renderMode: "obsidian" 生成 Obsidian 友好 Markdown

配置/使用

推荐混合模式(QMD 主动记忆 + memory-wiki bridge):

{
  memory: { backend: "qmd" },
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "bridge",
          bridge: { enabled: true, readMemoryArtifacts: true, indexDreamReports: true },
          search: { backend: "shared", corpus: "all" }
        }
      }
    }
  }
}

搜索策略:

  • memory_search corpus=all:跨记忆和 wiki 的宽泛召回
  • wiki_search + wiki_get:需要来源溯源或页面级信念结构时

CLI:openclaw wiki status/doctor/init/ingest/compile/lint/search/get/apply/bridge

相关页面

  • memory — 记忆系统总览
  • concepts/plugin-memory-lancedb — LanceDB 向量记忆插件
  • memory-qmd — QMD 本地搜索 sidecar