(请关注公众号,你的关注我将会继续努力为大家提供更好的有关 ai 智能体的文章)
引言
你有没有想过,当你和 openclaw 聊天时,她是怎么记住你说的话的?
今天,让我揭秘 OpenClaw 的三大记忆系统——Active Memory、Memory Core和Memory Wiki。这可是连很多 AI 开发者都不太清楚的硬核知识!

一句话解释三个系统
系统 | 一句话解释 | 比喻 |
|---|---|---|
Memory Core | 你的"工作记忆" | 电脑的 RAM |
Active Memory | 随时检索的"记忆搜索引擎" | 手机的搜索功能 |
Memory Wiki | 整理归档的"知识百科" | 图书馆的卡片目录 |
1. Memory Core:AI 的"工作内存"
原理
Memory Core 是 OpenClaw 的内置核心记忆系统,负责存储和管理所有的对话记录。
工作方式
你发送消息 → Memory Core 记录 → 存入当天文件(如 2026-04-17.md)
存储位置
~/.openclaw/memory/
├── 2026-04-17.md # 今天的记忆
├── 2026-04-16.md # 昨天的
├── MEMORY.md # 长期重要记忆
└── scene_blocks/ # 场景记忆
特点
- ✅本地存储:文件就在你电脑上,不上传云端
- ✅每日分割:每天的对话单独一个文件
- ✅可选 dreaming:每晚自动整理(需要定时任务)
2. Active Memory:你的"记忆搜索引擎"
原理
Active Memory 是一个运行时检索系统。当小丽需要回忆时,它能在 280-3000 毫秒内从大量记忆中找到相关内容。

工作流程
小丽收到问题 → Active Memory 搜索 → 找到相关记忆 → 提供答案
核心功能
功能 | 说明 |
|---|---|
Recall(召回) | 快速找到相关记忆 |
Promote(晋升) | 把重要记忆升级到长期记忆 |
Index(索引) | 建立记忆索引,加速搜索 |
Dreaming(梦境) | 自动整理和反思(可选) |
检索速度
- 普通搜索:280ms - 3秒
- 向量语义搜索:支持自然语言查询
- 多维度排序:按相关性、时间、频率排序
3. Memory Wiki:AI 的"第二大脑"
原理
Memory Wiki 是编译后的知识库,会把混乱的记忆整理成结构化的知识页面。
两种模式
模式 | 需要额外软件? | 说明 |
|---|---|---|
native | ❌ 不需要 | 生成纯 Markdown 文件 |
obsidian | ✅ 需要 | 支持 Obsidian 双向同步 |
Bridge 模式(推荐)
Memory Core → 自动同步 → Memory Wiki
目录结构
~/.openclaw/wiki/main/
├── index.md # 首页(总览)
├── entities/ # 实体(人物/项目/系统)
├── concepts/ # 概念(想法/模式/政策)
├── syntheses/ # 总结(整理后的知识)
├── sources/ # 源材料
└── reports/ # 自动生成的报告
├── contradictions.md # 矛盾检测
├── low-confidence.md # 低置信度内容
└── open-questions.md # 待解决问题
独特功能
- 结构化 Claims:每条知识可以带"置信度"和"来源证据"
- 矛盾检测:自动发现记忆中的矛盾点
- 知识溯源:每条知识都能追溯到原始对话
三个系统如何配合?
┌─────────────────────────────────────────────────────────┐
│ 你的对话 │
└──────────────────────┬──────────────────────────────────┘
▼
┌─────────────────────────────────────────────────────────┐
│ Memory Core │
│ 记录到 memory/YYYY-MM-DD.md │
└──────────────────────┬──────────────────────────────────┘
│ (Dreaming: 每晚3点)
▼
┌─────────────────────────────────────────────────────────┐
│ Active Memory 检索 │
│ 运行时快速搜索、召回 │
└──────────────────────┬──────────────────────────────────┘
│ (Bridge 模式)
▼
┌─────────────────────────────────────────────────────────┐
│ Memory Wiki 整理 │
│ 编译成结构化知识库 + 自动报告 │
└─────────────────────────────────────────────────────────┘
为什么需要三个系统?
需求 | 对应系统 |
|---|---|
记住今天的对话 | Memory Core |
快速找到之前的某个话题 | Active Memory |
整理成可查阅的知识 | Memory Wiki |
了解哪些记忆有矛盾 | Memory Wiki 报告 |
如何配置?
1. Memory Core(内置默认开启)
{
"plugins": {
"entries": {
"memory-core": {
"enabled": true,
"config": {
"dreaming": { "enabled": true }
}
}
}
}
}
2. Active Memory(内置默认开启)
{
"plugins": {
"entries": {
"active-memory": {
"enabled": true,
"config": {
"queryMode": "recent",
"timeoutMs": 15000
}
}
}
}
}
3. Memory Wiki(需手动启用)
{
"plugins": {
"entries": {
"memory-wiki": {
"enabled": true,
"config": {
"vaultMode": "bridge",
"bridge": { "enabled": true },
"render": { "createDashboards": true }
}
}
}
}
}
常见问题
Q1: 数据安全吗?
答:所有数据都在本地(~/.openclaw/),不上传到云端。除非你手动开启腾讯云数据库插件。
Q2: 需要每天手动运行吗?
答:不需要。配置好后:
- Memory Core 自动记录
- Active Memory 自动检索
- Memory Wiki 需要手动
openclaw wiki compile(或等 Gateway 重启后定时自动跑)
Q3: 存储空间会无限增长吗?
答:不会。可以通过配置:
- 限制记忆保留天数
- 设置晋升阈值
- 定期清理旧文件
总结
系统 | 角色 | 比喻 |
|---|---|---|
Memory Core | 记录员 | 记笔记 |
Active Memory | 搜索引擎 | 查资料 |
Memory Wiki | 图书管理员 | 整理书架 |
三个系统各司其职,共同构成了 openclaw 的"记忆体系"。有了它们,小丽才能记住你说过的话,并在需要时快速想起来!
本文基于 OpenClaw 官方文档编写,适用于 2026 年 4 月版本
夜雨聆风