Memory Wiki

memory-wiki 是一个内置插件，可将持久知识编译为可导航的 wiki：确定性页面、带证据的结构化声明、来源信息、仪表板以及机器可读的摘要。它不会取代主动记忆插件。召回、提升、索引和 Dreaming 仍由所配置的记忆后端（memory-core、QMD、Honcho 等）负责。memory-wiki 与其并行运行，将知识编译为持续维护的 wiki 层。在使用其 CLI、工具或运行时集成之前，请先启用该插件：

openclaw plugins enable memory-wiki
openclaw gateway restart

层	负责的内容
主动记忆插件	召回、语义搜索、提升、Dreaming、记忆运行时
`memory-wiki`	编译后的 wiki 页面、富含来源信息的综合内容、仪表板、wiki 搜索/获取/应用

实用规则：

使用 memory_search 对已配置的所有语料库执行一次广泛召回
当需要 wiki 专用排序、来源信息或页面级信念结构时，使用 wiki_search / wiki_get
当主动记忆插件支持选择语料库时，使用 memory_search corpus=all 在一次调用中涵盖两个层

一种常见的本地优先设置：使用 QMD 作为负责召回的主动记忆后端，并以 bridge 模式运行 memory-wiki，用于生成持久的综合页面。请参阅配置下的 QMD + 桥接模式示例。如果桥接模式报告导出的工件数量为零，则主动记忆插件当前未公开公共桥接输入。请先运行 openclaw wiki doctor，然后确认主动记忆插件支持公共工件。

仓库模式

isolated（默认）：拥有独立的仓库和来源，不依赖主动记忆插件。适用于自包含的精选知识存储。
bridge：通过公共插件 SDK 接口，从主动记忆插件读取公共记忆工件和事件日志。用于编译记忆插件导出的工件，而无需访问插件的私有内部机制。
unsafe-local：针对本机私有路径的显式逃生通道。此模式有意保持实验性且不可移植；仅在理解信任边界，并且确实需要桥接模式无法提供的本地文件系统访问权限时使用。

仓库模式和仓库作用域是两个独立的选择：

vaultMode 选择 wiki 输入的来源。
vault.scope 选择所有智能体共用一个仓库，还是每个智能体拥有一个子仓库。

vault.scope: "global" 是默认值，并保留现有的单仓库行为。当智能体之间不得共享 wiki 页面、编译摘要、搜索结果或写入内容时，请将 vault.scope: "agent" 与 isolated 或 bridge 模式结合使用。智能体作用域不能与 unsafe-local 模式结合使用，因为这些已配置的私有路径并非由智能体拥有的输入。配置验证会拒绝此组合。根据 bridge.* 配置开关，桥接模式可以索引：

导出的记忆工件（indexMemoryRoot）
每日笔记（indexDailyNotes）
Dreaming 报告（indexDreamReports）
记忆事件日志（followMemoryEvents）

当桥接模式处于活动状态且已启用 bridge.readMemoryArtifacts 时， openclaw wiki status、openclaw wiki doctor 和 openclaw wiki bridge import 会通过正在运行的 Gateway 网关路由，因此它们看到的主动记忆插件上下文与智能体/运行时记忆相同。如果桥接已禁用或工件读取已关闭，这些命令会继续保持本地/离线行为。

仓库布局

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

托管内容保留在生成的块中；人工笔记块在重新生成后仍会保留。

sources/：导入的原始材料，以及由桥接/不安全本地模式支持的页面
entities/：持久存在的事物、人员、系统、项目和对象
concepts/：思想、抽象概念、模式和策略（也是 OKF 导入内容的存放位置）
syntheses/：编译后的摘要和持续维护的汇总
reports/：生成的仪表板

Open Knowledge Format 导入

openclaw wiki okf import ./bundles/ga4

将已解包的 Open Knowledge Format 包导入 wiki 概念页面。当数据目录、文档爬虫或增强智能体已生成 OKF 时，此方式非常合适：将 OKF 保留为可移植的交换工件，并让 memory-wiki 将其转换为 OpenClaw 原生概念页面和编译摘要。

非保留的 .md 文件是概念文档
每个导入的概念都必须包含非空的 type frontmatter 字段；缺少 type 会产生 missing-type 警告，并跳过该文件
未知的 type 值会作为通用概念接受
index.md 和 log.md 是保留项，绝不会作为概念导入
损坏或外部的 Markdown 链接保持不变

导入的页面会平铺到 concepts/ 下，因此现有的编译、搜索、获取和仪表板流程无需第二棵 wiki 树即可看到它们。每个页面都会保留原始 OKF 概念 ID、源路径、type、resource、tags、时间戳以及完整的生成方 frontmatter。内部 OKF 链接会重写为生成的 wiki 概念页面，并同时发出包含 kind: okf-link 的结构化 relationships 条目。

结构化声明和证据

页面携带结构化的 claims frontmatter，而不只是自由格式文本。每条声明可以包含 id、text、status、confidence、evidence[] 和 updatedAt。每个证据条目可以包含 kind、sourceId、path、 lines、weight、confidence、privacyTier、note 和 updatedAt。这使 wiki 表现为信念层，而不是被动的笔记堆积。声明可以被跟踪、评分、质疑，并追溯到来源进行解决。

面向智能体的实体元数据

实体页面携带通用路由元数据，可用于人员、团队、系统、项目或任何其他实体类型：

entityType：例如 person、team、system、project
canonicalId：跨别名和导入保持稳定的身份键
aliases：解析到同一页面的名称、账号名或标签
privacyTier：自由格式字符串；public 被视为无需审查，任何其他值（例如 local-private、sensitive、confirm-before-use）都会在 reports/privacy-review.md 中标记
bestUsedFor / notEnoughFor：紧凑的路由提示
lastRefreshedAt：来源刷新时间戳，与页面编辑时间分开记录
personCard：可选的人员专用路由卡片（账号名、社交资料、电子邮件、时区、负责领域、适合询问的事项、应避免询问的事项、置信度、隐私层级）
relationships：指向相关页面的类型化边（目标、类型、权重、置信度、证据类型、隐私层级、备注）

对于人员 wiki，请从 reports/person-agent-directory.md 开始，然后在使用联系方式或推断事实之前，通过 wiki_get 打开人员页面。

实体页面示例

pageType: entity
entityType: person
id: entity.example-person
canonicalId: maintainer.example-person
aliases:
  - Alex
  - example-handle
privacyTier: local-private
bestUsedFor:
  - 示例生态系统路由
notEnoughFor:
  - 法律审批
lastRefreshedAt: "2026-04-29T00:00:00.000Z"
personCard:
  handles:
    - "@example-handle"
  socials:
    - "https://x.example/example-handle"
  emails:
    - alex@example.com
  timezone: America/Chicago
  lane: 示例生态系统
  askFor:
    - 示例发布问题
  avoidAskingFor:
    - 不相关的计费决策
  confidence: 0.8
  privacyTier: confirm-before-use
relationships:
  - targetId: entity.other-person
    targetTitle: 其他人员
    kind: collaborates-with
    confidence: 0.7
    evidenceKind: discrawl-stat
claims:
  - id: claim.example.routing
    text: Alex 适合处理示例生态系统路由。
    status: supported
    confidence: 0.9
    evidence:
      - kind: maintainer-whois
        sourceId: source.maintainers
        privacyTier: local-private

编译流水线

编译过程会读取 wiki 页面、规范化摘要，并将面向机器的快照持久化到 OpenClaw 的共享 SQLite 插件状态中。运行时代码使用由生命周期管理的所有者快照，在异步提示词准备期间加载 SQLite；同步提示词组装绝不会抓取 Markdown 或读取缓存文件。编译后的输出还支持搜索/获取的第一阶段 wiki 索引、将声明 ID 查找回其所属页面、紧凑的提示词补充以及报告生成。来源编辑和仓库恢复只有在下次编译后才会对机器可见。重启或刷新插件生命周期时，会将仓库中以因果链连接的编译发布与 SQLite 进行比较，并拒绝来自更新但已回滚状态的快照。在回滚前启动的编译器无法基于恢复后的前序状态发布。提示词准备不会轮询仓库，也不会安装文件监视器。进入回滚隔离状态后，在运行进程中执行编译会立即清除所有者；单独的编译器进程则需要刷新插件生命周期，以便守护进程确认新的持久发布。编译缓存可以重建：发布周期之前的缓存行会被视为未命中，并由下次编译替换；它们不会被迁移。

仪表板和健康报告

启用 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`	使用前需要审查的非公开隐私层级

搜索和检索

两个搜索后端：

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

三个语料库：wiki、memory、all。

wiki_search / wiki_get 会尽可能使用编译摘要作为第一阶段
声明 ID 会解析回其所属页面
有争议/已过期/新鲜的声明会影响排序
来源标签会保留到结果中

搜索模式（--mode / 工具 mode 参数）：

模式	增强
`auto`	均衡的默认模式
`find-person`	类人物实体、别名、账号名、社交账号、规范 ID
`route-question`	智能体卡片、适用问题/最佳用途提示、关系上下文
`source-evidence`	来源页面和结构化证据元数据
`raw-claim`	匹配结构化声明；返回声明/证据元数据

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

智能体工具

工具	用途
`wiki_status`	当前知识库模式和范围、解析后的智能体、健康状态、Obsidian CLI 可用性
`wiki_search`	搜索 wiki 页面，并在配置后搜索共享记忆语料库；接受 `mode`，用于人物查找、问题路由、来源证据或原始声明深入查询
`wiki_get`	按 ID/路径读取 wiki 页面；启用共享搜索且查找未命中时，回退到共享记忆语料库
`wiki_apply`	执行范围明确的综合分析/元数据变更，不进行自由形式的页面修改
`wiki_lint`	结构检查、来源缺口、矛盾、待解决问题

该插件还会注册非独占的记忆语料库补充源，因此当活动记忆插件支持语料库选择时，共享的 memory_search 和 memory_get 可以访问 wiki。

提示词和上下文行为

启用 context.includeCompiledDigestPrompt 后，记忆提示词区段会附加来自插件状态的紧凑编译快照：仅包含排名靠前的页面、排名靠前的声明、矛盾数量、问题数量、置信度/新鲜度限定信息。此功能为可选，因为它会改变提示词结构；它主要适用于明确使用记忆补充内容的上下文引擎或提示词组装流程。

配置

将配置放在 plugins.entries.memory-wiki.config 下：

{
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "isolated",
          vault: {
            scope: "global",
            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,
          },
          unsafeLocal: {
            allowPrivateMemoryCoreAccess: false,
            paths: [],
          },
          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.scope`	`global`（默认）、`agent`	使用一个共享知识库，或每个智能体使用一个子知识库
`vault.path`	全局默认值 `~/.openclaw/wiki/main`	全局范围下为具体知识库；智能体范围下的父目录默认为 `~/.openclaw/wiki`
`vault.renderMode`	`native`（默认）、`obsidian`
`bridge.readMemoryArtifacts`	默认值 `true`	导入活动记忆插件的公共工件
`bridge.followMemoryEvents`	默认值 `true`	在桥接模式中包含事件日志
`unsafeLocal.allowPrivateMemoryCoreAccess`	默认值 `false`	运行 `unsafe-local` 导入时必需
`unsafeLocal.paths`	默认值 `[]`	在 `unsafe-local` 模式中要导入的显式本地路径
`search.backend`	`shared`（默认）、`local`
`search.corpus`	`wiki`（默认）、`memory`、`all`
`context.includeCompiledDigestPrompt`	默认值 `false`	将所选智能体的紧凑摘要快照附加到记忆提示词区段
`render.createBacklinks`	默认值 `true`	生成确定性的相关内容块
`render.createDashboards`	默认值 `true`	生成仪表板页面

每智能体知识库

将 vault.scope 设为 agent，可为每个已配置的智能体提供独立的 wiki。在此范围内，vault.path 是父目录，OpenClaw 会附加规范化后的智能体 ID：

{
  agents: {
    list: [{ id: "support" }, { id: "marketing" }],
  },
  plugins: {
    entries: {
      "memory-wiki": {
        enabled: true,
        config: {
          vaultMode: "bridge",
          vault: {
            scope: "agent",
            path: "~/.openclaw/wiki",
          },
          bridge: {
            enabled: true,
            readMemoryArtifacts: true,
          },
        },
      },
    },
  },
}

这会解析为 ~/.openclaw/wiki/support 和 ~/.openclaw/wiki/marketing。如果在智能体范围内省略 vault.path，父目录默认为 ~/.openclaw/wiki。因此，默认的 main 智能体会继续使用现有的 ~/.openclaw/wiki/main 路径。智能体工具、编译后的提示词摘要，以及通过 memory_search / memory_get 公开的 wiki 补充内容，都会根据活动智能体上下文解析知识库。在配置了多个智能体的环境中进行 CLI 和 Gateway 网关调用时，请通过 openclaw wiki --agent <agentId> ... 或 Gateway 网关请求的 agentId 明确指定智能体。仅配置一个智能体时，如果未提供 ID，该智能体仍为默认值。在桥接模式下，仅当公共记忆工件的 agentIds 包含所选智能体时，智能体范围的导入才会接受该工件。属于其他智能体、没有所有权元数据或所有者未知的工件都会被跳过。全局范围继续沿用现有的共享工件行为。

更改 vault.scope 不会复制或拆分现有知识库。在智能体范围内，显式配置的 vault.path 会成为父目录，因此在切换生产环境中的智能体之前，请有计划地移动或导入现有页面。请先备份知识库。每智能体知识库是同一进程内的知识边界，而不是操作系统级安全边界。具备主机文件系统访问权限的插件和非沙箱隔离工具仍可读取其他智能体的目录。当智能体之间互不信任时，请使用沙箱隔离或独立的 Gateway 配置文件。

示例：QMD + 桥接模式

如果希望使用 QMD 进行回忆，并使用 memory-wiki 维护知识层，请采用此配置。每一层各司其职：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

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，其中包括 wiki okf import、wiki apply metadata、wiki unsafe-local import、 wiki chatgpt import / wiki chatgpt rollback，以及完整的 wiki obsidian 子命令集。

Obsidian 支持

当 vault.renderMode 为 obsidian 时，插件会写入适合 Obsidian 的 Markdown，并可选择使用官方 obsidian CLI 执行状态探测、知识库搜索、打开页面、调用命令以及跳转到每日笔记。此功能为可选；没有 Obsidian 时，wiki 仍可在原生模式下运行。智能体范围的知识库仍可使用适合 Obsidian 的 Markdown，但配置验证会拒绝 obsidian.useOfficialCli: true 与 vault.scope: "agent" 的组合。当前的 obsidian.vaultName 设置是全局性的，无法为每个智能体选择不同的 Obsidian 知识库。请改用 wiki 工具和 CLI 操作，或将由 Obsidian 操作的 wiki 保持在全局范围内。

概览

Plugins

扩展

Building plugins

技能

自动化与任务

内置工具

代理协作

仓库模式

仓库布局

Open Knowledge Format 导入

结构化声明和证据

面向智能体的实体元数据

编译流水线

仪表板和健康报告

搜索和检索

智能体工具

提示词和上下文行为

配置

每智能体知识库

示例：QMD + 桥接模式

CLI

Obsidian 支持

推荐工作流

相关文档

​仓库模式

​仓库布局

​Open Knowledge Format 导入

​结构化声明和证据

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

​编译流水线

​仪表板和健康报告

​搜索和检索

​智能体工具

​提示词和上下文行为

​配置

​每智能体知识库

​示例：QMD + 桥接模式

​CLI

​Obsidian 支持

​推荐工作流

​相关文档

仓库模式

仓库布局

Open Knowledge Format 导入

结构化声明和证据

面向智能体的实体元数据

编译流水线

仪表板和健康报告

搜索和检索

智能体工具

提示词和上下文行为

配置

每智能体知识库

示例：QMD + 桥接模式

CLI

Obsidian 支持

推荐工作流

相关文档