Appearance
OpenClaw新记忆系统完整指南:Active Memory Plugin和Memory-Wiki怎么用
Active 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的记忆不是存在模型里的,而是存在磁盘上的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:让记忆主动浮现
它做的是什么
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_style | silent=静默注入,不显示在对话里 |
适用场景
| 场景 | 推荐 |
|---|---|
| 长期协作项目 | 开启,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 Plugin | Memory-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,单次任务都不开。
