OpenClaw发布Memory Wiki

memory-wiki 是一个内置打包插件，可将持久记忆转化为一个编译后的知识库。 它不会替代活跃记忆插件。活跃记忆插件仍然负责召回、提升、索引和梦境生成。memory-wiki 与其并行工作，将持久知识编译为一个可导航的 wiki，具备确定性页面、结构化主张、来源追踪、仪表板以及机器可读摘要。 当你希望记忆更像一个被持续维护的知识层，而不只是堆积成山的 Markdown 文件时，就可以使用它。

它新增了什么

• 具有确定性页面布局的专用 wiki 知识库

• 结构化的主张与证据元数据，而不仅仅是散文式文本

• 页面级来源追踪、置信度、矛盾点与开放问题

• 面向代理/运行时消费者的编译摘要

• 原生 wiki 的 search/get/apply/lint 工具

• 可选的桥接模式，可从活跃记忆插件导入公开产物

• 可选的 Obsidian 友好渲染模式与 CLI 集成

它如何与 memory 配合

可以这样理解这两层的分工：

层级	负责内容
活跃记忆插件（ memory-core 、QMD、Honcho 等）	召回、语义搜索、提升、梦境生成、记忆运行时
memory-wiki	编译后的 wiki 页面、富含来源信息的综合内容、仪表板、wiki 专用 search/get/apply

如果活跃记忆插件暴露了共享召回产物，OpenClaw 就可以通过 memory_search corpus=all 一次同时搜索这两层。 当你需要 wiki 专属排序、来源追踪或直接访问页面时，应改用原生 wiki 工具。

知识库模式

memory-wiki 支持三种知识库模式：

isolated

独立知识库、独立数据源，不依赖 memory-core。 当你希望 wiki 成为一个独立策展的知识存储时，使用此模式。

bridge

通过公开插件 SDK 接口，从活跃记忆插件读取公开记忆产物和记忆事件。 当你希望 wiki 编译并组织记忆插件导出的产物，而不触及插件私有内部实现时，使用此模式。 桥接模式可索引：

• 导出的记忆产物

• 梦境报告

• 每日笔记

• 记忆根目录文件

• 记忆事件日志

unsafe-local

用于本机私有路径的显式逃逸口。 该模式刻意设计为实验性且不可移植。仅当你明确理解信任边界，并且确实需要桥接模式无法提供的本地文件系统访问时才应使用。

知识库布局

插件会初始化如下知识库结构：

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

受管理内容会保留在生成块内部。人工笔记块会被保留。 主要页面分组包括：

• sources/：用于导入的原始材料和桥接支持页面

• entities/：用于持久存在的事物、人物、系统、项目和对象

• concepts/：用于思想、抽象、模式和策略

• syntheses/：用于编译后的摘要和维护中的汇总

• reports/：用于生成的仪表板

结构化主张与证据

页面可以携带结构化的 claims frontmatter，而不仅仅是自由文本。 每条主张可包含：

• 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

这些摘要的存在是为了让代理和运行时代码无需抓取 Markdown 页面。 编译输出还支撑以下功能：

• 用于 search/get 流程的首轮 wiki 索引

• 将 claim-id 反查到所属页面

• 紧凑型提示补充内容

• 报告/仪表板生成

仪表板与健康报告

启用 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 会在可能时优先使用编译摘要进行首轮处理

• claim id 可以反解到所属页面

• 有争议/陈旧/新鲜的主张会影响排序

• 来源标签可以保留到结果中

实用规则：

• 使用 memory_search corpus=all 进行一次广覆盖召回

• 当你关心 wiki 专属排序、来源追踪或页面级信念结构时，使用 wiki_search + wiki_get

插件会注册以下工具：

• wiki_status

• wiki_search

• wiki_get

• wiki_apply

• wiki_lint

它们的作用：

• wiki_status：当前知识库模式、健康状态、Obsidian CLI 可用性

• wiki_search：搜索 wiki 页面，并在已配置时搜索共享记忆语料库

• wiki_get：按 id/path 读取 wiki 页面，或回退到共享记忆语料库

• wiki_apply：进行窄范围综合/元数据变更，而非自由式页面修改

• wiki_lint：执行结构检查、来源缺口检查、矛盾检查和开放问题检查

插件还会注册一个非独占的 memory 语料补充，因此当活跃记忆插件支持语料选择时，共享的 memory_search 和 memory_get 也可访问 wiki。

提示与上下文行为

启用 context.includeCompiledDigestPrompt 后，记忆提示区段会附加来自 agent-digest.json 的紧凑编译快照。 该快照刻意保持小而高信号：

• 仅包含顶部页面

• 仅包含顶部主张

• 矛盾计数

• 问题计数

• 置信度/新鲜度限定信息

此功能默认关闭，因为它会改变提示结构，主要适用于明确消费记忆补充内容的上下文引擎或传统提示组装流程。

配置

将配置放在 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：在桥接模式下包含事件日志

• search.backend：shared 或 local

• search.corpus：wiki、memory 或 all

• context.includeCompiledDigestPrompt：向记忆提示区段附加紧凑摘要快照

• 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 时，插件会写出对 Obsidian 友好的 Markdown，并可选择使用官方 obsidian CLI。 支持的工作流包括：

• 状态探测

• 知识库搜索

• 打开页面

• 调用 Obsidian 命令

• 跳转到每日笔记

这是可选功能。即使不使用 Obsidian，wiki 在原生模式下仍然可以正常工作。

• 保留你的活跃记忆插件，用于召回/提升/梦境生成。

• 启用 memory-wiki。

• 除非你明确需要 bridge 模式，否则从 isolated 模式开始。

• 当来源追踪很重要时，使用 wiki_search / wiki_get。

• 对于窄范围综合或元数据更新，使用 wiki_apply。

• 在有意义的变更之后运行 wiki_lint。

• 如果你希望看到陈旧/矛盾可见性，就开启仪表板。

• 记忆概览

• CLI：memory

• CLI：wiki

• 插件 SDK 概览