简要总结
Workspace Memory Research
这页纸在讲一个“记忆小仓库”该怎么建。就像你有一个小本子,每天写一篇日记,但时间长了,想找以前写过的关于“小猫”或者“生日派对”的事情,就要翻很久。这个设计就是帮你快速找到这些记忆的。它会把日记本里的重要事情,整理到一个“魔法索引”里,这样你问问题,它就能很快告诉你答案。它主要讲给想搭建或改进这个记忆仓库的大人看。
五岁小孩版解释
我们想给一个叫 Clawd 的智能小伙伴建一个“记忆小仓库”。这个仓库就在你的电脑里一个叫 ~/.openclaw/workspace 的文件夹里。现在,它的记忆就像一本日记,每天一页(比如 memory/2025-11-27.md)。这样写日记很方便,但想找东西时就不太方便了。
所以,我们想了一个新办法。这个办法有两个最重要的目标:第一,它必须能在没有网络的时候工作(这叫“离线”)。第二,它必须能解释清楚答案是从哪里来的(比如,告诉你“这句话是从2025年11月27日的日记第12行找到的”)。
新的记忆仓库会分成两个部分。第一部分是“真正的仓库”,还是用你熟悉的日记本(Markdown文件)来存东西。我们建议把仓库整理得更整齐一点:
memory.md文件:放最重要、最不会变的事情,比如“我最喜欢蓝色”。memory/文件夹:还是放每天的日记。bank/文件夹:这里放整理好的“专题”记忆,比如“世界知识”、“我的经历”、“我的看法”,还有专门记录“彼得”或“城堡”的页面。
第二部分是“魔法索引”(~/.openclaw/workspace/.memory/index.sqlite)。它就像一个超级快的目录,能帮我们从一大堆日记里快速找到需要的东西。这个索引是从上面的日记本自动生成的,如果丢了,还可以重新做出来。
那么,记忆是怎么工作的呢?就像三个小步骤:记住、回想和思考。
第一步:记住 每天写完日记后,在日记的最后加一个“## 记住”的小标题,下面用几个小圆点写下今天最重要的事情。每条事情要写成一个完整的小故事,并且打上标签。
- 比如:
- W @Peter: 目前在马拉喀什(2025年11月27日至12月1日)参加安迪的生日。 - 这里的
W代表“世界事实”,@Peter是说这件事和“彼得”有关。还有B(经历)、O(看法)等标签。
第二步:回想 当 Clawd 需要回忆时,就可以去问“魔法索引”。可以问:“关于彼得的所有事”(按人找),或者“上周发生了什么”(按时间找)。索引会找到相关的事实,并且告诉你每条事实是从哪篇日记的哪一行来的,这样你就知道它没有瞎编。
第三步:思考
这是一个定期自动运行的小任务。它会看看最近新记住的事情,然后去更新 bank/ 文件夹里的“专题”页面。比如,它发现关于“彼得”的新事情多了,就会更新“彼得.md”这个文件,做一个总结。对于“看法”,它还会像做数学题一样,根据新证据调高或调低“信心值”。
关于一个叫 SuCo(子空间碰撞) 的高级搜索技术,你可以把它想成一个更厉害、更快的找东西魔法。但文档里说,我们一开始完全不需要用它。就像你只有几本书时,用手翻翻就能找到;等你有了一整个图书馆的书,才需要这种高级魔法。我们一开始用 SQLite 自带的搜索(FTS5)就够快了。
最后,这个记忆功能会做成 OpenClaw 工具的一部分,这样 Clawd 自己就能用命令来调用,比如 openclaw memory recall "彼得" 来查找关于彼得的事情。但它的核心部分也会单独做成一个小工具库,方便在其他地方测试和使用。