Auto Memory Keeper

概述

自动提取会话内容，并更新每日记忆文件，以维持长期记忆的连续性。

两种运行模式：

• 被动模式：由 Cron 任务每小时执行一次（自动触发）
• 主动模式：由用户手动触发（例如说出“remember this”、“log today”等指令）

工作原理

触发方式

1. 自动触发：Cron 任务每小时执行一次
2. 手动触发：用户说出“remember this”、“log today”或“update memory”等指令

工作流程

步骤 1：检查环境

DATE=$(date +%Y-%m-%d)
MEMORY_FILE=~/.openclaw/workspace/memory/${DATE}.md

if [ ! -f "$MEMORY_FILE" ]; then
  echo "# ${DATE} Log\n\n## Today's Items\n\n- " > "$MEMORY_FILE"
fi

步骤 2：获取最近的会话

# 使用 sessions_list 获取过去 60 分钟内的活跃会话
# 使用 sessions_history 获取会话详情

步骤 3：噪声过滤

跳过以下类型的消息：

• 简单问候语（如 “hi”、“hello”、“hey”）
• 确认类回复（如 “thanks”、“ok”、“sure”、“yes”）
• 单个单词的响应
• 缺乏上下文的问题
• HEARTBEAT_OK 消息
• 系统消息

步骤 4：提取关键信息

从已过滤的消息中提取以下类型的关键信息：

步骤 5：智能去重

写入前检查是否存在重复条目：

# 读取当前文件内容
# 若存在相似度超过 80% 的已有条目，则跳过
# 否则追加新条目

步骤 6：更新记忆文件

文件格式如下：

## Today's Items

- {time} {item description}
- {time} {item description}
...

示例

输入（用户消息）：

“installed openclaw-tavily-search, score 3.639”

存储结果：

- 21:47 installed openclaw-tavily-search skill (score 3.639)

输入（用户消息）：

“auto-extract session content to memory file every hour”

存储结果：

- 21:50 created auto-memory-keeper skill for hourly auto memory extraction

配置

可通过 config.json 进行配置：

{
  "memory_dir": "~/.openclaw/workspace/memory",
  "interval_hours": 1,
  "active_minutes": 60,
  "categories": ["Decision", "Task", "Progress", "Issue", "Conclusion"],
  "skip_patterns": ["^hi", "^hello", "^thanks", "^ok"],
  "dedup_threshold": 0.8
}

质量规范

1. 简洁性 — 每项仅用一句话描述
2. 时间戳 — 每项必须包含时间信息
3. 去重 — 避免记录重复条目
4. 分类 — 按类型对条目进行归类
5. 过滤噪声 — 不记录无关紧要的琐碎消息

常见问题（FAQ）

Q：如何手动触发？
A：说出 “remember this”、“log today” 或 “update memory” 即可

Q：Cron 任务在哪里配置？
A：使用 cron job add 命令配置，详见 SKILL.md 中的示例

Q：记忆文件存储在何处？
A：~/.openclaw/workspace/memory/YYYY-MM-DD.md

测试

定期审阅记忆文件，并根据实际效果调整 skip_patterns，以提升过滤精度。

相关功能

• 与 session-wrap-up 协同良好（适用于手动 vs 自动触发场景）
• 复杂记忆内容可手动写入 MEMORY.md（用于长期记忆）