📖 纸质书《OpenClaw超级个体实操手册》已上市！ 清华大学出版社出版，在开源教程基础上全面重写+逐条验证。🛒 京东专属购买链接（¥42，原价¥59.8）

第5章节 知识库与第二大脑（Active Memory / Memory Wiki / 研究归档）

本章目标：用 OpenClaw 当前官方主线，把“知识库”这件事讲清楚：什么交给 Active Memory，什么交给 Memory Wiki，什么只是临时资料，不要再把旧的第三方同步 Skill 当默认方案。

版本基线

先给小白的阅读说明

这一章到底解决什么问题

很多人一提“知识库”，脑子里想到的是：

这些不是没用，但它们已经不是 OpenClaw 当前的主线。现在更推荐你把知识系统拆成 3 层：

  1. Active Memory：回复前先回忆相关上下文
  2. Memory Wiki：把长期知识整理成结构化、可检索的知识层
  3. 临时资料处理：网页抓取、会议纪要、研究摘录，先整理再决定要不要进入长期知识层

如果你只想先跑通，先看这几节

小白最容易犯的 3 个错

本章一句话结论

先让 OpenClaw 能记得住，再让它能查得到，最后才考虑它要不要同步到别的笔记工具。

5.1 2026.4 之后，知识库的正确主线是什么？

旧版教程里，“知识库”主要靠网页归档、Notion 同步、Obsidian 同步来实现。但在当前官方主线里，更重要的是下面这套组合：

层级 负责什么 适合什么场景
Active Memory 回复前先回忆相关偏好、事实、上下文 聊天、长期协作、偏好记忆
Memory Wiki 把长期知识编译成结构化知识层 项目知识、研究资料、长期主题沉淀
openclaw infer web fetch/search 收集外部资料 网页、文档、新闻、调研资料
wiki ingest / compile / search / get 资料入库、整理、检索 第二大脑、团队知识、项目档案

你可以这样理解：

5.2 Active Memory：先让 OpenClaw 记得住你

官方文档对 Active Memory 的定义很明确：它是一个在主回复之前运行的阻塞式记忆子代理。它会在合适的会话里先用 memory_search、memory_get 找相关记忆，再把精简结果交给主回复。

5.2.1 什么时候该开

适合直接开启的情况：

先不要急着开的情况：

5.2.2 官方推荐起步配置

根据官方文档，最安全的起步方式是：启用插件、只绑定一个对话 agent、只先在 direct chat 里使用。

把下面这段写到 openclaw.json：

{
  plugins: {
    entries: {
      "active-memory": {
        enabled: true,
        config: {
          agents: ["main"],
          allowedChatTypes: ["direct"],
          modelFallback: "google/gemini-3-flash",
          queryMode: "recent",
          promptStyle: "balanced",
          timeoutMs: 15000,
          maxSummaryChars: 220,
          persistTranscripts: false,
          logging: true
        }
      }
    }
  }
}

改完以后，重启你当前使用的 Gateway 进程或服务。

5.2.3 看到什么算 Active Memory 已经跑通

你可以先用最简单的方式判断：

5.2.4 小白怎么理解这些配置项

如果你是第一次用，不建议一开始就改得太激进。默认先跑稳，再谈优化。

5.3 Memory Wiki：把长期知识整理成“能查、能证据回溯”的知识层

官方对 memory-wiki 的定位不是普通笔记插件，而是一个把 durable memory 编译成知识 vault 的 bundled plugin。

它和 Active Memory 的关系是：

5.3.1 为什么它比“随手记笔记”更适合长期知识

Memory Wiki 的优势不只是“能存”，而是：

这更像一个“知识层”，而不是一个“笔记堆”。

5.3.2 官方推荐起步配置

官方文档建议把配置放到 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
          }
        }
      }
    }
  }
}

5.3.3 小白先记住 4 个关键开关就够了

5.3.4 什么时候用 bridge 模式

只有在你已经明确知道：

这时再考虑 bridge。如果你现在只是第一次上手，先用 isolated。

5.4 最适合小白先跑通的知识库流程

这一节不讲大而全的系统，只讲最短闭环。

5.4.1 流程 A：把一份本地笔记收进 Wiki

先初始化：

openclaw wiki init
openclaw wiki status

然后准备一份最简单的 Markdown 笔记，例如 ./notes/customer-onboarding.md：

# Customer Onboarding

## 现状
- 新用户第一次接触产品时，最容易卡在权限配置
- 现有帮助文档太散，入口不统一

## 我的判断
- 应该做一份统一 onboarding checklist
- 首屏应该先给 3 个最常见动作

把它导入 Wiki：

openclaw wiki ingest ./notes/customer-onboarding.md
openclaw wiki compile
openclaw wiki lint

搜索并读取：

openclaw wiki search "onboarding"
openclaw wiki get <lookup>

5.4.2 看到什么算 Wiki 已经跑通

至少满足下面 4 条：

5.4.3 流程 B：把网页资料变成长期知识

更推荐的顺序不是“直接同步到第三方笔记工具”，而是：

  1. 先抓网页资料
  2. 让 OpenClaw 摘要成你自己的笔记
  3. 再决定是否进入 Wiki

先抓取网页：

openclaw infer web search --query "OpenClaw Active Memory use cases" --json
openclaw infer web fetch --url https://docs.openclaw.ai/concepts/active-memory --json

然后你可以让 OpenClaw 帮你整理成一份 Markdown 摘要，再保存到 ./notes/，最后继续：

openclaw wiki ingest ./notes/active-memory-summary.md
openclaw wiki compile

5.4.4 流程 C：项目知识沉淀

项目知识最适合进 Wiki 的内容是：

不适合一股脑塞进去的内容是：

最好的习惯是：先整理，再入库。

5.5 如果你已经在用 Obsidian，应该怎么理解它和 Wiki 的关系

这一章不再把 Obsidian 当成默认主线，而把它放回它更适合的位置：展示层 / 编辑层。

更推荐的关系是

如果你已经在用 Obsidian，可以重点关注这些命令：

openclaw wiki obsidian status
openclaw wiki obsidian search "onboarding"
openclaw wiki obsidian open syntheses/alpha-summary.md
openclaw wiki obsidian daily

不再推荐当默认主线的旧写法

下面这些旧路线，现在不再建议当成入门默认方案：

它们不是完全不能做，而是更适合作为你已经有现成工作流时的补充集成，而不是当前官方知识主线。

5.6 本章最容易踩的坑

坑 1：把所有资料都当长期知识

不是所有东西都值得进 Wiki。一个很实用的判断标准是：

坑 2：一上来就开太多模式

新手建议顺序：

  1. 先开 Active Memory
  2. 再初始化 Wiki
  3. 先用 isolated 模式
  4. 跑通后再考虑 bridge

坑 3：把同步当成目标，把知识本身忘了

Notion、Obsidian、备忘录都只是载体。真正该优先解决的，是：

5.7 给小白的最短落地顺序

如果你今天只想花 30 分钟先把“知识库”跑起来，按这个顺序做：

  1. 打开 Active Memory
  2. 初始化 Memory Wiki
  3. 写一份自己的本地 Markdown 笔记
  4. wiki ingest + wiki compile
  5. wiki search 看能不能搜到
  6. 再决定要不要接 Obsidian

5.8 官方参考