为什么需要记忆
OpenClaw 每次会话都是"睡醒重启"——模型上下文是空的,它不记得你昨天说过什么、做过什么决定。
很多人踩过这个坑:在聊天里说"记住这个偏好",结果下次开聊,AI 又是一张白纸。
答案不是靠模型记忆力,而是靠文件:工作区里的几份 Markdown,就是 AI 的"大脑外挂"。这份机制在 OpenClaw 里是真实存在的,不是比喻。
OpenClaw 的三层记忆结构
| 文件 | 角色 | 写入频率 | 谁来读 |
|---|---|---|---|
MEMORY.md |
长期记忆(精选) | 偶尔,只存沉淀 | 仅主会话(私聊) |
memory/YYYY-MM-DD.md |
每日流水(原始) | 每天,随手记 | 任何会话按需 |
HANDOFF.md |
压缩状态交接 | 长任务/超时前 | 恢复会话时优先读 |
关键点:MEMORY.md 只在主会话加载,群聊/共享上下文不要往里塞私人信息——它会泄漏给陌生人。这是 OpenClaw 设计上的红线。
真实命令:先看清你现在的记忆现状
不需要任何 AI 工具,纯 shell 就能查:
# 列出所有每日日记
ls -la /root/.openclaw/workspace/memory/ 2>/dev/null
# 看长期记忆有没有内容
cat /root/.openclaw/workspace/MEMORY.md 2>/dev/null
# 看交接文件(上下文超时被压成这份)
cat /root/.openclaw/workspace/HANDOFF.md 2>/dev/null
如果 memory/ 目录都不存在,正常——它要你第一次写的时候才建。
实操:写一条记忆的正确姿势
别再只跟 AI 口头说"记一下"。直接落盘文件才作数。两种方式:
方式 A:shell 追加(适合脚本/终端党)
mkdir -p /root/.openclaw/workspace/memory
cat >> /root/.openclaw/workspace/memory/2026-09-08.md <<'EOF'
- 09:30 整理 OpenClaw 记忆系统:三层结构(MEMORY.md / 每日日记 / HANDOFF.md)
- 决策:长期偏好进 MEMORY.md,调试流水进每日日记
EOF
方式 B:让 OpenClaw 自己写(在主会话直接说"把 X 写进今天的日记"),它会调用 write 工具落盘——比口头交代可靠得多。
三个最常见的踩坑
- 只在聊天里说"记住这个"
模型不会自动把对话内容落盘。必须显式写入文件(你写,或让它写)。 - 把临时调试日志堆进 MEMORY.md
MEMORY.md是"精选智慧",不是垃圾桶。流水进memory/日期.md,定期把值得长期保留的提炼进去。 - HANDOFF.md 不维护
当一次会话因为上下文过长而超时中断,OpenClaw 会读HANDOFF.md恢复状态。
你若从不更新它,恢复时就只能从头来。长任务跑一半,先写一句当前进度进去。
最佳实践清单
- 偏好/决定/踩过的坑 →
MEMORY.md(精炼,几条就够) - 当天流水/命令/观察 →
memory/YYYY-MM-DD.md(随意,全记) - 跨会话的大任务 → 维护
HANDOFF.md(当前项目、卡点、关键路径) - 定期(几天一次)读近期日记,把值得留的折叠进
MEMORY.md,过期条目可删 - 群聊里绝不引用
MEMORY.md的私人内容
一个安全的小脚本:定期扫描待归档条目
下面这个脚本只列出、不删除、不改动,帮你决定哪些每日流水值得沉淀到长期记忆:
#!/usr/bin/env bash
# 用法:bash archive-suggest.sh
# 只打印 memory/ 下含"决定/决策/记住/偏好"等关键词的行,供人工挑选
set -euo pipefail
MEM_DIR="/root/.openclaw/workspace/memory"
[ -d "$MEM_DIR" ] || { echo "还没有 memory/ 目录"; exit 0; }
echo "=== 可能值得沉淀到 MEMORY.md 的条目 ==="
grep -rniE "决定|决策|记住|偏好|红线|约定|规范" "$MEM_DIR" \
|| echo "(暂无可归档条目)"
跑出来后,你人工把确认有价值的那几行贴进 MEMORY.md 即可。
小结
OpenClaw 的记忆不是魔法,就是"文件 + 约定":
- 每日日记接住流水,
MEMORY.md沉淀长期,HANDOFF.md负责交接。
养成了"边干边写"的习惯,AI 才会越用越懂你——而不是每次都从零开始热身。
关注我
如果这篇对你有用,欢迎关注我的公众号,第一时间收到 OpenClaw 实操更新:
扫码或微信搜索公众号名称即可。每天一篇 OpenClaw 中文实操手记。