夜雨聆风小龙虾🦞OpenClaw 个人实践 · B-14
机制解析 · 配置实战 · 4.7 + 4.14 新功能补丁
OpenClaw 新记忆系统完整指南Active Memory Plugin 和 Memory-Wiki 怎么用
信息截至 2026 年 4 月 15 日 · 基于官方文档 + 社区实战反馈 · 适用 4.10 - 4.14
有读者在上一篇文章底下问：使用Activity Memory Plugin和Memory-Wiki相关的一些问题，这篇文章就来给大家讲讲，这两个功能到底是什么，有什么区别，怎么开，什么情况下需要。
这两个功能在 4.7 和 4.10 版本先后加入，名字容易混淆，实际上做的是两件不同的事。这篇把它们拆清楚，每个功能都给出可以直接用的配置。
前置要求
• Active Memory Plugin：需要 4.10+（2026.4.10，4 月 11 日发布）
• Memory-Wiki：需要 4.7+（2026.4.7，4 月 8 日发布）
• 两个功能都是可选插件，默认不开启，需要手动配置
一、先说清楚 OpenClaw 的记忆是怎么工作的
理解这两个新功能之前，需要先知道 OpenClaw 的记忆系统原本是怎么工作的。
OpenClaw 的记忆不是存在模型里的，而是存在磁盘上的 Markdown 文件里。Agent 只"记得"写到文件里的东西，没写进去的对话内容，下个会话就没有了。
默认的三个记忆文件（4.7 之前就有）
MEMORY.md——长期记忆。耐久的事实、偏好、决策。每次私信会话开始时自动加载。
memory/YYYY-MM-DD.md——每日日志。当天和昨天的日志会自动加载，更早的需要主动检索。
DREAMS.md——Dreaming 整理结果（启用 dreaming 后产生）。
原本的搜索机制（memory-core 插件提供的 memory_search 工具）是被动的——Agent 决定要不要搜、什么时候搜。如果它没想到要查记忆，相关内容就不会出现。
这是 Active Memory Plugin 要解决的问题。Memory-Wiki 解决的是另一个问题：记忆太碎，没有结构，像一堆散纸，不像知识库。
二、Active Memory Plugin：让记忆主动浮现
首次引入：2026.4.10（4 月 11 日）· 来源：docs.openclaw.ai/concepts/active-memory
它做的是什么
Active Memory Plugin 是一个在主 Agent 回复之前自动运行的记忆子 Agent。它的工作是：在你发出消息之后、主 Agent 开始回复之前，静默地搜索一遍记忆，把相关的偏好、历史、上下文注入进来。
你不需要说"去查一下记忆"，它自动做了。
正常回复里你看不到这个过程，但开启 /verbose 后可以看到类似这样的输出：
🧩 Active Memory: status=ok elapsed=842ms query=recent summary=34 chars 🔎 Active Memory Debug: 用户偏好简洁回复，禁止主动推荐工具
按官方文档说明，这个注入是"untrusted context"——内容被注入前会打上标签 <active_memory_plugin>...</active_memory_plugin>，模型不能把里面的内容当成用户指令执行。这是安全设计，防止记忆文件被注入恶意内容。
怎么开启
在 openclaw.json 里加入以下配置：
{ "plugins": { "entries": { "active-memory": { "enabled": true, "config": { "agents": ["main"], "queryMode": "recent", "logging": false } } } } }
⚠️ 最容易踩的坑：必须把你的 Agent ID 写进 "agents" 数组里，否则插件加载了但完全不触发，没有任何报错提示。默认 Agent 的 ID 是 "main"，如果你改过名字，填你实际的 Agent ID。
queryMode 三个选项说明
"message"：只针对当前这条消息搜索，最快，token 消耗最少
"recent"：搜索最近几轮对话的相关记忆，推荐默认，兼顾效果和成本
"full"：全量搜索历史，最完整但 token 消耗最高，适合有大量长期记忆的场景
验证是否生效
# 查看插件状态 openclaw plugins info active-memory# 在对话里开启调试可见性 /active-memory status /verbose# 确认记忆搜索本身是否正常 openclaw memory status --deep
如果 openclaw plugins info active-memory 显示 hookCount: 1 但对话里看不到记忆注入，最常见的原因有两个：一是 agents 数组里没有写 Agent ID；二是你在用一个非主流模型（不是 Claude / GPT / Gemini 这类），子 Agent 可能无法按预期格式返回结果，导致静默失败。
⚠️ 成本提醒
Active Memory Plugin 在每次主 Agent 回复前额外运行一次子 Agent，每次对话都会多消耗 token。如果你在意 API 账单，先用 message 模式，或者只给高频使用的 Agent 开启，不要全局默认开。
什么情况下需要开
✅ 适合开启：你对同一个 Agent 的使用是长期、高频、有积累的——你在 MEMORY.md 里存了不少关于你的偏好和习惯，希望 Agent 每次都能自然地考虑进去，而不需要你主动提醒。
✅ 适合开启：Agent 经常在不同任务之间切换，你需要它记住上周某个项目的背景，而不是每次都重新交代。
❌ 不需要开启：你只是偶尔用 OpenClaw 做一次性任务，没有跨会话的积累，或者你在意 API 成本，记忆体量不大，自己在需要时说"查一下记忆"就够了。
❌ 不需要开启：你只是拿 OpenClaw 接了个渠道，主要用来执行指令，记忆不是核心需求。
4.12 - 4.14 核心修复与升级
如果你在 4.10 刚发布时觉得召回有点“飘”，建议立刻升级到 4.14，官方合并了几个非常关键的修复（来自工程视角的解读）：
• 召回精准度大幅提升（#65049）：核心架构优化。重构了词法回退排序（lexical fallback ranking），并将单纯的词法提升移出混合搜索。直白地说，引擎找历史记忆时更稳了，极大减少了“强行联想”带来的上下文噪音。
• 阻断 Dreaming“记忆套娃”（#64682）：之前系统可能会把 Dreaming 自动生成的梦境梳理报告当成新记忆再次摄入，造成提取死循环。新版底层严格排除了 memory/dreaming/** 目录的自产出内容，同时放开了正常嵌套 Daily Notes 的短期召回。
三、Memory-Wiki：给记忆加上结构
首次引入：2026.4.7（4 月 8 日）· 来源：docs.openclaw.ai/plugins/memory-wiki
它解决什么问题
OpenClaw 默认的记忆是一堆 Markdown 文件——每天的日志、MEMORY.md、Dreaming 产生的内容。用久了之后，这些文件越来越多，内容越来越散，同样的事情可能在不同文件里重复出现，而且找起来全靠语义搜索，没有结构，没有溯源。
Memory-Wiki 做的是：把这些散的记忆编译成一个结构化的知识库，有确定的页面布局、来源追溯、置信度标记、内部链接，像一个 Agent 维护的 Wiki，而不是散纸。
官方文档对两者的定位说得很清楚：
"memory-wiki 不替代 active memory plugin。active memory plugin 负责召回、升级和 dreaming。memory-wiki 在它旁边运行，把耐久知识编译成有溯源的知识库层。"
——官方文档 memory-wiki
两种工作模式
Isolated 模式（推荐入门使用）：Wiki 完全独立，有自己的内容来源，不依赖其他记忆插件。你手动向里面写入内容，Agent 从里面检索。适合你想要一个干净的、手工维护的知识库。
Bridge 模式（高级）：Wiki 读取 active memory plugin 导出的公共记忆文件，把它们编译进来。两层结合，搜索可以跨越两个系统。适合已经有大量记忆积累、想给记忆加上结构层的用户。
基础开启方式（Isolated 模式）
{ "plugins": { "entries": { "memory-wiki": { "enabled": true, "config": { "vaultMode": "isolated", "vault": { "path": "~/.openclaw/wiki/main" } } } } } }
高阶开启方式（Bridge 模式）
如果你已经有深度的记忆积累，想让 Wiki 自动抓取底层的核心记忆文件进行编译，可以使用 Bridge 模式：
{ "plugins": { "entries": { "memory-wiki": { "enabled": true, "config": { "vaultMode": "bridge",
"enabled": true,
⚠️ 避坑提示：使用 Bridge 模式时，建议开启 "autoCompile": true，这样底层文件更新后，Wiki 会在后台自动重新生成词条。如果你遇到了词条更新不及时的问题，记得跑一下 openclaw wiki doctor。
常用 CLI 命令
openclaw wiki status # 查看当前 wiki 状态 openclaw wiki doctor # 诊断配置问题 openclaw wiki init # 初始化 wiki vault openclaw wiki ingest ./notes/alpha.md # 导入一个文件 openclaw wiki compile # 编译 wiki 页面 openclaw wiki search "客户偏好" # 搜索 wiki 内容 openclaw wiki lint # 检查 wiki 内容质量
放什么进 Wiki
Wiki 适合存放需要长期稳定、有结构的内容，而不是流水账式的对话记录。
适合放进 Wiki 的内容（来自官方推荐）
• 客户背景和沟通风格偏好
• 项目术语表和缩写定义
• 重复任务的标准流程清单
• 重要决策的记录和原因
不适合放进 Wiki 的：流水日志、临时笔记、单次使用的指令——这些放在 daily notes 或直接在 MEMORY.md 里就够了。
Wiki 越精简越好用，放太多噪声会让检索质量下降。
什么情况下需要开
✅ 适合开启：你有长期项目或固定客户，积累了大量需要被 Agent 持续参考的背景知识，希望这些知识有结构、有溯源，而不是散落在各个日志文件里。
✅ 适合开启：你想把一些稳定的业务流程、术语、规则整理成 Agent 可以检索的知识库，希望每次都能找到准确的、有来源的答案。
❌ 不需要开启：你刚开始用 OpenClaw，记忆还没有积累，或者你的使用场景不需要结构化知识。先把默认的 MEMORY.md 用好，等内容多了再考虑 Wiki。
❌ 不需要开启：你不想额外维护一个知识库，喜欢随手记随手找。
4.12 - 4.14 核心修复与升级
对于国内开发者，4.12 的补丁解决了一个极度影响体验的痛点：
• 完美支持中文词条（#64742）：之前在 Wiki 词条中使用中文或非 ASCII 字符时，经常导致 slug 字段折叠或触发文件路径超长报错。新版安全保留了 Unicode 字符并加入了安全的字节截断机制，中文 Wiki 和矛盾聚类（contradiction clustering）终于达到生产可用状态。
• Bridge 模式排错闭环（#63165）：针对高级用户使用 Bridge 模式时经常卡在“零导出（zero-artifact）”的问题，官方正式补充了 openclaw wiki doctor 的诊断流程和排错文档，现在找配置 bug 轻松多了。
四、两者的关系，一张图看清楚
OpenClaw 记忆系统层次
─────────────────────────────
Active Memory Plugin（4.10+）
↑ 每次回复前自动召回相关记忆注入上下文
─────────────────────────────
Memory-Wiki（4.7+）
↑ 把散的记忆编译成结构化知识库
─────────────────────────────
memory-core（默认基础层）
↑ MEMORY.md + daily notes + dreaming + memory_search 工具
─────────────────────────────
三层是叠加关系，不是替代关系。memory-core 是基础，一直都有；Memory-Wiki 在旁边加一个结构化层；Active Memory Plugin 在最上面加一个自动召回层。可以只开其中一个，也可以三个一起用。
五、刚开始用，建议这个顺序
第一步：先把 MEMORY.md 写好。这是所有记忆功能的基础。把你的偏好、常用规则、项目背景写进去，保持在 2000 字以内，每次开新会话都会自动加载。
第二步：用了一两个月、觉得记忆找不准的时候，开启 Active Memory Plugin。用 recent 模式，跑几天，用 /verbose 看看它召回的是不是有用的内容。
第三步：等有了比较稳定的、需要长期参考的知识积累再考虑 Memory-Wiki。先从 isolated 模式开始，手动维护几个核心页面（客户背景、项目术语、决策记录），确认 Agent 能有效检索到之后再扩展。
敲黑白❗️❗️❗️
升级到4.14版本，开启bridge模式在作者机器上出现了问题：
Bridge: enabled (0 exported artifacts)
查了Github上也有人报一样的问题，让虾崽子🦐自己去解决这个问题，时不时给它提供点信息，虾崽子🦐自己打了个补丁解决了。
如果你也需要，可关注、私信。
不建议一次性把三个都开。每增加一层都会增加配置复杂度和 token 消耗，先把用到的那层用好，再往上叠。
💬 Active Memory 开起来之后，你觉得召回准不准？有没有遇到配置了但不触发的问题？评论区说说。
夜猫子弦月 | 白天写代码，晚上写文章，偶尔弹古琴 信息来源：docs.openclaw.ai · GitHub openclaw/openclaw · OpenClaw Playbook Blog
#OpenClaw #ActiveMemory #MemoryWiki #AI工具 #虾崽子
