ESP-Claw如何记住你结构化记忆系统与隐私保护机制深度解析【免费下载链接】esp-clawESP-Claw, a Chat Coding AI agent framework for IoT devices项目地址: https://gitcode.com/gh_mirrors/es/esp-claw你是否想过一台插在家庭电路里的物联网IoT设备为什么能像老朋友一样记住你的习惯ESP-Claw 是一个面向 IoT 设备的对话式编程Chat CodingAI Agent 框架它的结构化记忆系统与全端侧隐私保护机制正是让这颗边缘大脑真正懂你的关键。为什么 AI 设备需要记忆大语言模型LLM本身是无状态的——每一次请求对它来说都从零开始。如果没有记忆模块你的语音助手每天醒来都会失忆不知道你爱吃什么、不记得昨晚说好的关灯时间也无法延续上一次聊天的上下文。ESP-Claw 通过claw_memory模块解决这两个不同时间尺度的问题记忆类型解决的问题时间尺度会话历史让单次对话前后连贯一场对话之内长期记忆跨对话持久保存偏好与事实跨 Session 共享画像文件稳定的人格与用户设定长期不变 想动手体验的话可以直接运行git clone https://gitcode.com/gh_mirrors/es/esp-clawESP-Claw 记忆架构三层结构如何工作会话历史同一话题聊到底ESP-Claw 以Session ID会话 ID为边界管理历史。同一个 Session 下的轮次串联成一条对话线切换 Session 即切换到另一条独立对话历史互不可见。这让设备可以并行接待来自不同 IM 渠道、不同用户的对话彼此严格隔离。同时会话历史有容量上限超出后自动截断最旧轮次——这是刻意设计防止 token 消耗失控并倒逼系统把真正重要的信息提炼进长期记忆。相关实现见 claw_memory_session.c。结构化长期记忆不用向量数据库的巧思这是 ESP-Claw 记忆系统最精彩的部分。每条长期记忆是一个结构化条目而非大段流水账字段用途示例content归一化后的记忆正文用户偏好中文回复tags生成摘要标签目录1–3 个日常习惯, 饮食偏好keywords关键词索引辅助检索早餐, 牛奶source来源标记manual/auto_llm检索时不依赖笨重的向量数据库而是采用轻量的摘要标签机制每次请求前系统只把一份标签目录如daily_routine、dietary_preferences注入给 LLM当需要详情时LLM 再按标签调用memory_recall精准召回正文。这种先查目录、再取详情的两级设计非常适合存储和算力有限的嵌入式设备。核心数据结构定义在 claw_memory.h。可编辑画像文件user.md、soul.md 与 identity.md除了可检索的事实记忆ESP-Claw 还会维护三份人类可直接编辑的画像文件每次请求前作为系统上下文注入文件作用建议内容user.md当前用户画像称呼、偏好语言、长期约定soul.mdAgent 的灵魂核心风格、做事原则identity.mdAgent 身份卡名称、角色、能力边界它们属于稳定行为设定与结构化事实记忆互补实现见 claw_memory_profile.c。自动抽取零操作也能越用越懂你 ESP-Claw 的完整模式下每条用户消息都会触发一个异步自动抽取任务后台任务调用 LLM 判断消息中是否有可长期保留的事实如我每天早上 7 点起床并归一化后写入结构化记忆。整个过程有几个贴心设计不阻塞对话抽取在独立任务里异步执行不影响回复速度见 claw_memory_session.c智能去重写入前会按内容指纹与语义匹配检查同一事实不会重复积累冲突替换当新信息修正旧说法如搬家后换了城市旧记忆会被自动替换克制原则闲聊、提问、临时任务一律不入库只保留持久性事实完整的抽取规则定义在 claw_memory_extract.cAgent 使用记忆工具的行为规范则写在 memory_ops/SKILL.md。隐私保护你的记忆只存在你的设备里对隐私敏感的用户ESP-Claw 的设计给出了一个优雅的答案——全端侧存储✅数据不出设备记忆文件memory_records.jsonl、memory_index.json、MEMORY.md全部存放在设备本地文件系统任何记忆内容都不会上传到厂商服务器✅透明可审计所有记忆都是人类可读的纯文本/JSON 文件你可以随时查看设备记住了什么✅真正的遗忘权通过memory_forget操作指定记忆会被标记删除并同步清理索引与 Markdown 导出实现见 claw_memory.c✅会话级隔离不同渠道、不同用户的对话历史严格分离互不可见✅关键词有据可查自动抽取的关键词必须落地于记忆正文杜绝凭空捏造的敏感词索引简言之记忆主权完全交给用户设备是记在本子上而不是寄存在云端。两种记忆模式如何选择合适的配置ESP-Claw 提供两种记忆运行模式可在 menuconfig 的App Claw Config→App Claw memory management mode中切换模式行为适用场景结构化记忆管理默认结构化记录 摘要标签目录支持自动抽取持续使用、希望设备越用越懂你轻量记忆仅保留 profile 与会话历史长期记忆以MEMORY.md文本注入资源受限或追求简化链路 选型建议日常陪伴型设备如智能音箱、机器人选完整模式只做简单任务提示的轻量设备选轻量模式即可。下一步亲手验证你的设备如何记住你在完整模式下试试对设备说记住我每天早上 7 点起床过几天再问你还记得我的作息吗——它会先查摘要标签目录再召回记忆正文作答。如果你想深入源码推荐从这两篇官方文档入手记忆系统总览memory.mdxclaw_memory API 参考claw-memory.mdx记忆模块源码目录claw_memory/从无状态的一次性问答到有记忆的边缘智能体ESP-Claw 证明了一件事再小的设备也能拥有既懂你、又尊重你隐私的 AI 大脑。【免费下载链接】esp-clawESP-Claw, a Chat Coding AI agent framework for IoT devices项目地址: https://gitcode.com/gh_mirrors/es/esp-claw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考