记忆 wiki

memory-wiki 是一个内置插件，会将持久记忆转换为编译后的知识库。它不会取代主动记忆插件。主动记忆插件仍然负责召回、提升、索引和 Dreaming。memory-wiki 与它并列工作，并将持久知识编译成可导航的 wiki，其中包含确定性页面、结构化声明、来源依据、仪表板和机器可读摘要。当你希望记忆更像一个维护良好的知识层，而不是一堆 Markdown 文件时，请使用它。

它添加了什么

一个带有确定性页面布局的专用 wiki 库
结构化声明和证据元数据，而不仅是 prose
页面级来源依据、置信度、矛盾和开放问题
面向智能体/运行时消费者的编译摘要
wiki 原生的 search/get/apply/lint 工具
可选桥接模式，用于从主动记忆插件导入公共产物
可选的 Obsidian 友好渲染模式和 CLI 集成

它如何配合记忆

可以这样理解这种分层：

层	负责
主动记忆插件（`memory-core`、QMD、Honcho 等）	召回、语义搜索、提升、Dreaming、记忆运行时
`memory-wiki`	编译后的 wiki 页面、富含来源依据的综合内容、仪表板、wiki 专用 search/get/apply

如果主动记忆插件暴露共享召回产物，OpenClaw 可以用 memory_search corpus=all 在一次处理中搜索两个层。当你需要 wiki 专用排序、来源依据或直接页面访问时，请改用 wiki 原生工具。

库模式

memory-wiki 支持三种库模式：

`isolated`

拥有自己的库、自己的来源，不依赖 memory-core。当你希望 wiki 成为独立策划的知识存储时使用此模式。

`bridge`

通过公共插件 SDK 接缝，从主动记忆插件读取公共记忆产物和记忆事件。当你希望 wiki 编译和整理记忆插件导出的产物，而不进入私有插件内部机制时使用此模式。桥接模式可以索引：

导出的记忆产物
Dream 报告
每日笔记
记忆根文件
记忆事件日志

`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

证据条目可以包括：

kind
sourceId
path
lines
weight
confidence
privacyTier
note
updatedAt

这使 wiki 更像一个信念层，而不是被动的笔记转储。声明可以被跟踪、评分、争议化，并追溯回来源。

面向智能体的实体元数据

实体页面还可以携带供智能体使用的路由元数据。这是通用 frontmatter，因此适用于人物、团队、系统、项目或任何其他实体类型。常见字段包括：

entityType：例如 person、team、system 或 project
canonicalId：跨别名和导入使用的稳定身份键
aliases：应解析到同一页面的名称、用户名或标签
privacyTier：public、local-private、sensitive 或 confirm-before-use
bestUsedFor / notEnoughFor：紧凑的路由提示
lastRefreshedAt：独立于页面编辑时间的来源刷新时间戳
personCard：可选的人物专用路由卡，包含用户名、社交账号、邮箱、时区、通道、适合询问事项、避免询问事项、置信度和隐私
relationships：指向相关页面的类型化边，包含目标、类型、权重、置信度、证据类型、隐私级别和备注

对于人物 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:
    - brad@example.com
  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

编译流水线

编译步骤会读取 wiki 页面、规范化摘要，并在以下位置输出稳定的机器面向产物：

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

这些摘要的存在，是为了让智能体和运行时代码不必抓取 Markdown 页面。编译输出还支持：

search/get 流程的首轮 wiki 索引
声明 ID 回查到所属页面
紧凑的提示词补充
报告/仪表板生成

仪表板和健康报告

启用 render.createDashboards 后，编译会在 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

这些报告会跟踪如下内容：

矛盾备注簇
竞争声明簇
缺少结构化证据的声明
低置信度页面和声明
过期或未知新鲜度
带有未解决问题的页面
人物/实体路由卡
结构化关系边
证据类别覆盖率
使用前需要审查的非公共隐私级别

搜索和检索

memory-wiki 支持两种搜索后端：

shared：可用时使用共享记忆搜索流程
local：在本地搜索 wiki

它还支持三种语料库：

wiki
memory
all

重要行为：

wiki_search 和 wiki_get 会在可能时使用编译摘要作为第一轮处理
声明 ID 可以解析回所属页面
有争议/过期/新鲜的声明会影响排序
来源依据标签可以保留到结果中
搜索模式可以让排序偏向人物查找、问题路由、来源证据或原始声明

实用规则：

使用 memory_search corpus=all 进行一次广泛召回
当你关心 wiki 专用排序、来源依据或页面级信念结构时，使用 wiki_search + wiki_get

搜索模式：

auto：平衡默认值
find-person：提升类似人物的实体、别名、用户名、社交账号和规范 ID
route-question：提升智能体卡片、适合询问提示、最适合用途提示和关系上下文
source-evidence：提升来源页面和结构化证据元数据
raw-claim：提升匹配的结构化声明，并在结果中返回声明/证据元数据

当结果匹配结构化声明时，wiki_search 可以在其 details payload 中返回 matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds 和 evidenceSourceIds。可用时，文本输出也会包含紧凑的 Claim: 和 Evidence: 行。

智能体工具

该插件注册以下工具：

wiki_status
wiki_search
wiki_get
wiki_apply
wiki_lint

它们的作用：

wiki_status：当前库模式、健康状态、Obsidian CLI 可用性
wiki_search：搜索 wiki 页面，并在配置后搜索共享记忆语料库；接受用于人物查找、问题路由、来源证据或原始声明钻取的 mode
wiki_get：按 ID/路径读取 wiki 页面，或回退到共享记忆语料库
wiki_apply：进行窄范围综合/元数据变更，而不是自由格式页面手术
wiki_lint：结构检查、来源依据缺口、矛盾、开放问题

该插件还会注册一个非独占的记忆语料库补充，因此当主动记忆插件支持语料库选择时，共享的 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：生成仪表盘页面

示例：QMD + 桥接模式

当你想将 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 负责主动记忆回忆
memory-wiki 专注于编译后的页面和仪表盘
提示词形态保持不变，直到你有意启用编译摘要提示词

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。支持的工作流包括：

状态探测
vault 搜索
打开页面
调用 Obsidian 命令
跳转到每日笔记

这是可选的。即使没有 Obsidian，wiki 仍可在原生模式下工作。

它添加了什么

它如何配合记忆

推荐的混合模式

库模式

`isolated`

`bridge`

`unsafe-local`

库布局

结构化声明和证据

面向智能体的实体元数据

编译流水线

仪表板和健康报告

搜索和检索

智能体工具

提示词和上下文行为

配置

示例：QMD + 桥接模式

CLI

Obsidian 支持

推荐工作流

相关文档

Documentation Index

​它添加了什么

​它如何配合记忆

​推荐的混合模式

​库模式

​isolated

​bridge

​unsafe-local

​库布局

​结构化声明和证据

​面向智能体的实体元数据

​编译流水线

​仪表板和健康报告

​搜索和检索

​智能体工具

​提示词和上下文行为

​配置

​示例：QMD + 桥接模式

​CLI

​Obsidian 支持

​推荐工作流

​相关文档

它添加了什么

它如何配合记忆

推荐的混合模式

库模式

`isolated`

`bridge`

`unsafe-local`

库布局

结构化声明和证据

面向智能体的实体元数据

编译流水线

仪表板和健康报告

搜索和检索

智能体工具

提示词和上下文行为

配置

示例：QMD + 桥接模式

CLI

Obsidian 支持

推荐工作流

相关文档