如何让你的AI真正记住你:PalmClaw长期记忆与SOUL模板机制深度剖析

原创2026-10-13 20:21:141,664 阅读

如何让你的AI真正记住你:PalmClaw长期记忆与SOUL模板机制深度剖析

想让 AI 真正记住你,关键在长期记忆机制。PalmClaw 是一款运行在 Android 手机上的端侧 Agent 框架(EMNLP 2026 Demo),它用「两层记忆文件 + 自动记忆整理 + SOUL 模板」的组合,让 AI 助手跨会话记住你的偏好、项目背景与身份,而不是每次聊完就「失忆」。

PalmClaw 端侧智能体架构与长期记忆机制示意图

一、为什么大多数 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),机制如下:

  1. 触发阈值:当某会话的消息数超过「记忆整理窗口」(默认 50 条,可在设置页调整,范围 10–100),就启动整理。
  2. 交给 AI 提炼:把已整理的旧对话和当前 MEMORY.md 一起交给 LLM,要求它调用 save_memory 工具,输出两个字段:
    • history_entry:2–5 句的会话摘要,追加进 HISTORY.md;
    • memory_update:更新后的完整长期记忆,写回 MEMORY.md。
  3. 进度记账:记录每个会话已整理到的消息下标(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 — 工具说明

PalmClaw 中文界面:AI 助手按 SOUL 模板以个性化风格与你对话

每次对话时,ContextBuilder.kt 会把「系统策略模板 + 运行时上下文 + 长期记忆 + 技能摘要」拼装成 System Prompt。也就是说:SOUL 决定它怎么说话,MEMORY 决定它知道什么,两者共同构成了一个"既像你认识的它、又懂你"的助手。

由于模板同步到本地文件后用户可自由编辑,你完全可以把 SOUL.md 改成"毒舌但靠谱的工程师助手",或在 USER.md 里勾上"简洁回复 + 专业风格",AI 的行为会随之改变。

六、实操指南:三步让 AI 记住你 ✅

  1. 直接下指令:告诉 AI「记住我喜欢简短回答」,它会自动调用 memory_set 写入 MEMORY.md。
  2. 利用自动整理:在设置页把「记忆整理窗口」调小(如 20),可以让重要信息更快沉淀;调大则更省 token。相关文案见 SettingsContent.kt。
  3. 手动定制人格:编辑 USER.md 和 SOUL.md,补充你的称呼、时区、兴趣与沟通偏好;首次引导时设置的"用户称呼/助手称呼"也会自动同步进长期记忆(OnboardingCoordinator.kt)。

七、总结

PalmClaw 的长期记忆方案没有用复杂向量库,而是靠三件简单的事做到了端侧可用的"记得你":

  • 文件即记忆:MEMORY.md + HISTORY.md 两层结构,可读可改可检索;
  • AI 自己整理:超过窗口阈值自动提炼会话,增量沉淀不重复;
  • 模板即人格:SOUL/USER 模板 + 本地记忆共同构建个性化上下文。

所有记忆都保存在手机本地,跨会话、跨重启持续生效——这就是让 AI 从"聊一次忘一次"变成"越用越懂你"的完整机制。更多工程细节可查阅 docs/engineering/architecture.md。

登录后查看全文
PalmClaw