什么是Smart Memory
Smart Memory v2 是一个专为智能代理设计的持久化认知记忆运行时系统，旨在为 OpenClaw 等 AI 框架提供结构化的长期记忆能力。与传统的向量记忆 CLI 工具不同，它采用模块化架构，通过 Node.js 适配器与 FastAPI 后端协同工作，构建了一个完整的本地认知记忆引擎。该系统包含三个核心组件：Node 适配器（smart-memory/index.js）、本地 API 服务（server.py）和认知记忆协调器（cognitive_memory_system.py），共同实现高效、可靠的记忆管理功能。 该系统的核心优势在于其支持多种类型的结构化记忆存储，包括事件记忆（episodic）、语义记忆（semantic）、信念记忆（belief）和目标记忆（goal），并具备实体感知的检索与重排序能力。同时，系统还集成了热工作记忆机制和后台认知处理流程，能够自动进行反思、整合、衰减和冲突解决等高级认知操作。为了确保大语言模型提示词的质量，系统严格限制提示词的 token 数量，并通过标准化的上下文注入机制，将当前活跃项目、待解决问题和潜在洞察无缝融入对话生成过程。
核心功能特点
- 支持事件、语义、信念和目标四类结构化长期记忆存储
- 具备实体感知的记忆检索与智能重排序功能
- 集成热工作记忆与后台认知处理（反思、整合、衰减）
- 严格限定提示词 token 数量以保证生成效率
- 提供标准化的主动上下文注入机制
- 内置健康检查与自动重试队列保障可靠性
适用场景
Smart Memory v2 特别适用于需要持续学习、个性化演进和复杂决策支持的智能代理应用场景。例如，在虚拟助手或客服机器人中，系统可以长期记录用户的偏好、历史交互和关键决策，使每次对话都能基于过往经验做出更精准回应。对于研究型 AI 代理，它能追踪实验过程、保存研究发现并识别知识盲点，显著提升科研效率。在自动化运维或监控系统中，该工具可记录异常事件、故障处理方案和系统状态变化，形成可回溯的知识库。 由于其完全本地化部署的特性，Smart Memory v2 也非常适合对数据隐私要求严格的场景，如企业内部知识管理系统、医疗诊断辅助工具或金融合规审查平台。系统通过心跳机制和自动重试队列确保即使网络短暂中断也不会丢失重要信息，而每20轮对话自动生成的会话弧线摘要功能，则能有效捕捉长时间交互中的关键进展和遗留问题。结合 OpenClaw 原生技能包后，开发者可以轻松将其集成到现有智能代理架构中，无需修改底层逻辑即可获得强大的记忆增强能力。