介绍
# OpenClaw Memory Curator
OpenClaw 的一个**基于会话优先的内存系统**。
它存在的理由只有一个： **重要的知识必须在会话压缩时得以保留，而不会导致上下文窗口膨胀。**
---
## TL;DR (给人类看)
- 会话内存 = 临时的 (RAM) - 磁盘 = 真相来源 - **决策与偏好 → `MEMORY.md`** - **日常工作 → `memory/YYYY-MM-DD.md`** - 此技能会在**压缩前**保存持久化知识 - 检索总是通过 `memory_search` → `memory_get` 进行
如果某事以后很重要，**将其写入磁盘**。
---
> ⚠️ **关键要求** > > 必须启用会话内存索引。
## 启用会话内存
**CLI** ```bash clawdbot config set agents.defaults.memorySearch.experimental.sessionMemory true ```
**JSON** ```json { "agents": { "defaults": { "memorySearch": { "experimental": { "sessionMemory": true }, "sources": ["memory", "sessions"] } } } } ```
---
## 思维模型 (请读一遍)
OpenClaw 内存有**三层**。混淆通常源于将它们混为一谈。
### 1. 会话内存 (RAM) - 存在于当前对话中 - 自动压缩 - 建立了索引以便检索 - **长期不可靠**
👉 将其视为短期思考空间。
---
### 2. 每日日志 (`memory/YYYY-MM-DD.md`) - 仅追加 - 今天发生了什么 - 命令、编辑、短期问题
👉 将其视为工作日志，而不是知识库。
---
### 3. 长期内存 (`MEMORY.md`) - 策展过的 - 小巧 - 仅高价值信息 - 已建立索引且可检索
👉 将其视为代理绝不能忘记的事实。
---
## 何时写入内存 (简单规则)
### 如果下周它仍然为真，则写入 `MEMORY.md`。 示例： - 决策 - 偏好 - 不变量 - 策略
### 如果它有助于理解今天，则写入每日日志。 示例： - 重构 - 实验 - 临时阻碍
如果不确定：**先写入每日日志**，稍后提升。
---
## 压缩前刷新 (为何存在)
在 OpenClaw 压缩会话之前，它会触发一个**静默提醒**。
此技能利用这一刻作为**存档检查点**。
### 会发生什么： 1. 提取持久化知识 2. 将每日笔记写入今天的日志 3. 将持久化项目提升到 `MEMORY.md` 4. 代理回复 `NO_REPLY` (用户永远看不到这一点)
这可以在不打扰您的情况下防止知识丢失。
---
## 持久化内存格式 (`MEMORY.md`)
使用 ID 和标签，以便搜索可靠地工作。
```markdown ## DEC-2026-02-04-01 type: decision area: memory
Decision: Session memory is retrieval-only. Disk is the source of truth.
Reason: Session compaction is lossy. Disk memory is stable. ```
### ID 前缀 - `DEC` – 决策 - `PREF` – 偏好 - `FACT` – 持久化事实 - `POLICY` – 规则 / 不变量
---
## 检索策略 (代理应如何回忆)
1. 使用 `memory_search` (最多约 6 个结果) 2. 选择最好的 1–2 个命中 3. 使用带有行范围的 `memory_get` 4. 注入所需的最少文本
这能保持上下文小巧且精确。
---
## 代理行动手册 (代理规则)
- 相对于 RAM，优先使用磁盘 - 对于事实，相对于每日日志，优先使用 `MEMORY.md` - 再次询问用户之前先使用搜索 - 切勿将原始聊天记录复制到内存中 - 显式写入内存，不要假设它能保留
---
## 反面模式 (不要做这些)
- ❌ 将聊天记录复制到内存中 - ❌ 存储机密或凭据 - ❌ 将每日日志视为长期内存 - ❌ 覆盖内存文件而不是追加 - ❌ 将推测存储为事实
---
## 隐私规则
- 切勿存储机密 (API 密钥、令牌、密码) - 忽略 `<private>...</private>` 内的任何内容 - 如果存在敏感信息：仅存储**其存在性**，而不存储值
---
## 保留与清理
默认值：**不删除**
- 磁盘很便宜 - 检索质量很昂贵
可选： - 将旧的每日日志移动到 `memory/archive/YYYY-MM/` - 仅在持久化知识得到验证后才进行修剪
---
## 用法 (对人类友好)
效果很好的示例： - “将其存储为持久化决策。” - “这是一个偏好，记住它。” - “将其写入今天的日志。”
---
## 设计理念
- 磁盘即真相 - RAM 即便利 - 检索优于保留 - 更少的 Token > 更多的 Token - 内存应争得一席之地