Skip to content

OpenClaw新记忆系统完整指南:Active Memory Plugin和Memory-Wiki怎么用

2026年4月22日

OpenClaw新记忆系统完整指南:Active Memory Plugin和Memory-Wiki怎么用

Active Memory Plugin和Memory-Wiki在4.7和4.10版本先后加入,名字容易混淆,实际上做的是两件不同的事。这篇把它们拆清楚,每个功能都给出可以直接用的配置。


前置要求

功能版本要求
Active Memory Plugin4.10+(2026.4.10,4月11日发布)
Memory-Wiki4.7+(2026.4.7,4月8日发布)

注意:两个功能都是可选插件,默认不开启,需要手动配置。


OpenClaw记忆系统原本怎么工作

OpenClaw的记忆不是存在模型里的,而是存在磁盘上的Markdown文件里。Agent只"记得"写到文件里的东西,没写进去的对话内容,下个会话就没有了。

默认的三个记忆文件(4.7之前就有)

文件说明加载时机
MEMORY.md长期记忆:耐久的事实、偏好、决策每次私聊会话开始时自动加载
memory/YYYY-MM-DD.md每日日志:当天和昨天的日志自动加载更早的需主动检索
DREAMS.mdDreaming整理结果启用dreaming后产生

原本的搜索机制问题

memory-core插件提供的memory_search工具是被动的——Agent决定要不要搜、什么时候搜。如果它没想到要查记忆,相关内容就不会出现。

这是Active Memory Plugin要解决的问题。

Memory-Wiki解决的是另一个问题:记忆太碎,没有结构,像一堆散纸,不像知识库。


Active Memory Plugin:让记忆主动浮现

它做的是什么

Active Memory Plugin是一个在主Agent回复之前自动运行的记忆子Agent。工作是:

步骤说明
1你发出消息后,它静默地搜索一遍记忆
2把相关的偏好、历史、上下文注入进来
3主Agent开始回复时已经有了相关记忆

你不需要说"去查一下记忆",它自动做了。

开启/verbose后可以看到:

🧩 Active Memory: status=ok elapsed=842ms queries=3 hits=12

配置方法

~/.claw/settings.json添加:

json
{
  "plugins": {
    "active-memory": {
      "enabled": true,
      "config": {
        "max_queries": 5,
        "memory_types": ["MEMORY.md", "daily_logs", "DREAMS.md"],
        "inject_style": "silent"
      }
    }
  }
}
参数说明
max_queries单次最多执行5条搜索
memory_types搜索哪些类型的记忆文件
inject_stylesilent=静默注入,不显示在对话里

适用场景

场景推荐
长期协作项目开启,Agent自动记住之前的决策
频繁切换会话开启,新会话也能拿到历史上下文
单次任务不需要,增加响应延迟

Memory-Wiki:把碎片记忆结构化成知识库

它做的是什么

Memory-Wiki把分散的记忆文件整理成有结构的Wiki:

特性说明
Wiki链接[[页面名]]建立知识点之间的关联
自动索引新记忆写入时自动更新Wiki结构
三空间架构self/notes/ops三层组织

三空间架构

空间用途说明
self/Agent持久心智偏好、习惯、决策模式
notes/知识图谱概念、实体、关系
ops/运营协调任务记录、流程文档

配置方法

json
{
  "plugins": {
    "memory-wiki": {
      "enabled": true,
      "config": {
        "spaces": ["self", "notes", "ops"],
        "auto_link": true,
        "index_interval": "daily"
      }
    }
  }
}
参数说明
spaces启用哪些空间
auto_link自动检测并创建Wiki链接
index_interval索引更新频率

适用场景

场景推荐
长期知识积累开启,记忆变成可检索的知识库
多项目切换开启,每个项目有自己的Wiki空间
单次任务不需要

两个功能的区别

维度Active Memory PluginMemory-Wiki
解决的问题记忆不主动浮现记忆没结构
核心机制自动搜索注入Wiki链接组织
运行时机每条消息之前写入记忆时
适合谁长期协作、频繁切换会话长期知识积累、多项目

配置建议

你的情况推荐
长期项目协作Active Memory开启 + Memory-Wiki开启
频繁切换会话但不用积累知识只开Active Memory
做知识库但不需要主动注入只开Memory-Wiki
单次任务、临时使用两个都不开

4.14补丁说明

4.14版本修复了Active Memory Plugin的两个问题:

问题修复
搜索延迟过高优化查询策略,延迟从2s降到800ms
注入内容过多增加max_tokens限制,避免上下文爆炸

总结

Active Memory Plugin:让记忆主动浮现——你发消息它自动搜记忆,不用你说"去查一下"。

Memory-Wiki:把碎片记忆结构化——Wiki链接组织,变成可检索的知识库。

选型建议:长期协作开两个,频繁切换会话只开Active Memory,做知识库只开Memory-Wiki,单次任务都不开。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来