如何让你的AI真正记住你:PalmClaw长期记忆与SOUL模板机制深度剖析
如何让你的AI真正记住你:PalmClaw长期记忆与SOUL模板机制深度剖析
想让 AI 真正记住你,关键在长期记忆机制。PalmClaw 是一款运行在 Android 手机上的端侧 Agent 框架(EMNLP 2026 Demo),它用「两层记忆文件 + 自动记忆整理 + SOUL 模板」的组合,让 AI 助手跨会话记住你的偏好、项目背景与身份,而不是每次聊完就「失忆」。
一、为什么大多数 AI 记不住你 🤔
普通大模型的「记忆」只存在于当前对话上下文里:窗口一满,旧消息被截断;换个会话,一切归零。你告诉过它的「我不吃辣」「我在做 Android 项目」,下一次就要重新说一遍。
要解决这件事,需要把重要信息从上下文里"搬"到持久存储。PalmClaw 的思路非常朴素但有效:用两个 Markdown 文件充当长期记忆,让 AI 自己负责写入和检索。
二、两层长期记忆架构:MEMORY.md + HISTORY.md
PalmClaw 的记忆分两层,全部是纯文本 Markdown 文件,存放在应用私有目录 palmclaw/storage/memory/ 下(见 AppStoragePaths.kt):
| 层级 | 文件 | 作用 |
|---|---|---|
| 共享长期记忆 | MEMORY.md |
跨会话的长期事实:用户偏好、项目背景、关键关系,全局可见 |
| 会话历史 | HISTORY.md |
只追加的事件日志,按会话隔离,支持关键词/正则检索 |
这种「事实层 + 流水账层」的分工在内置 memory 技能 SKILL.md 中定义:MEMORY.md 存放长期事实,HISTORY.md 是 append-only 日志,需要回忆旧事时按关键词搜索即可。
官方给出的使用原则是:
如果某条信息只和一个会话相关,就留在该会话历史里;只有需要跨会话共享时,才写入共享记忆。
相关文件:MemoryStore.kt
三、自动记忆整理:重要信息如何被"沉淀" 🧠
PalmClaw 并不只是被动存文件,它有一个后台的记忆整理器(Memory Consolidator),机制如下:
- 触发阈值:当某会话的消息数超过「记忆整理窗口」(默认 50 条,可在设置页调整,范围 10–100),就启动整理。
- 交给 AI 提炼:把已整理的旧对话和当前
MEMORY.md一起交给 LLM,要求它调用save_memory工具,输出两个字段:history_entry:2–5 句的会话摘要,追加进HISTORY.md;memory_update:更新后的完整长期记忆,写回MEMORY.md。
- 进度记账:记录每个会话已整理到的消息下标(
last_consolidated),下次只处理增量,不会重复劳动。
整个流程在 MemoryConsolidator.kt 中实现,由 AgentLoop.kt 按会话加锁调度,避免并发写入。
这意味着:你和它聊得越多,它对你的记忆越完整,而且完全发生在手机本地。
四、四个内置记忆工具:AI 的"读心术"
除了自动整理,PalmClaw 还给 Agent 注册了四个主动记忆工具(MemoryTools.kt):
| 工具 | 能力 | 典型场景 |
|---|---|---|
memory_get |
读取全局长期记忆 | 回答"你还记得我的偏好吗" |
memory_set |
写入长期记忆(replace / append) | "记住我下个月要搬家" |
memory_history |
读取最近会话历史 | 回顾上一次聊到哪 |
memory_search |
关键词/正则搜索历史 | "上次那个报错是什么" |
所以你可以直接用自然语言指挥它:「记住:我对花生过敏」「查一下上次我们讨论的方案」。AI 会自己选择合适的工具执行。
五、SOUL.md 模板机制:给 AI 注入"灵魂" 🎭
记忆解决"记得你",而 SOUL 模板解决"它是谁"。PalmClaw 在首次启动时,会把一组模板文件同步到用户模板目录(TemplateStore.kt):
- SOUL.md — AI 的人格设定:性格、价值观、沟通风格(模板原文)
- USER.md — 用户档案:姓名、时区、语言、偏好清单(模板原文)
- AGENT.md — 行为准则:简洁回复、工具使用策略、定时任务规范
- TOOLS.md — 工具说明
每次对话时,ContextBuilder.kt 会把「系统策略模板 + 运行时上下文 + 长期记忆 + 技能摘要」拼装成 System Prompt。也就是说:SOUL 决定它怎么说话,MEMORY 决定它知道什么,两者共同构成了一个"既像你认识的它、又懂你"的助手。
由于模板同步到本地文件后用户可自由编辑,你完全可以把 SOUL.md 改成"毒舌但靠谱的工程师助手",或在 USER.md 里勾上"简洁回复 + 专业风格",AI 的行为会随之改变。
六、实操指南:三步让 AI 记住你 ✅
- 直接下指令:告诉 AI「记住我喜欢简短回答」,它会自动调用
memory_set写入MEMORY.md。 - 利用自动整理:在设置页把「记忆整理窗口」调小(如 20),可以让重要信息更快沉淀;调大则更省 token。相关文案见 SettingsContent.kt。
- 手动定制人格:编辑
USER.md和SOUL.md,补充你的称呼、时区、兴趣与沟通偏好;首次引导时设置的"用户称呼/助手称呼"也会自动同步进长期记忆(OnboardingCoordinator.kt)。
七、总结
PalmClaw 的长期记忆方案没有用复杂向量库,而是靠三件简单的事做到了端侧可用的"记得你":
- 文件即记忆:
MEMORY.md+HISTORY.md两层结构,可读可改可检索; - AI 自己整理:超过窗口阈值自动提炼会话,增量沉淀不重复;
- 模板即人格:SOUL/USER 模板 + 本地记忆共同构建个性化上下文。
所有记忆都保存在手机本地,跨会话、跨重启持续生效——这就是让 AI 从"聊一次忘一次"变成"越用越懂你"的完整机制。更多工程细节可查阅 docs/engineering/architecture.md。

