memory-system

OpenClaw 长期记忆管理系统。提供结构化记忆、向量记忆、语义搜索功能。Use when: 用户需要 AI 记住长期上下文、偏好、决策,或需要从记忆中进行语义搜索。

安装

概览

什么是memory-system

OpenClaw 长期记忆管理系统是一款专为 AI 助手设计的智能记忆增强工具,旨在解决大语言模型在对话过程中难以持续追踪用户长期偏好、决策逻辑和上下文关联的核心痛点。该系统通过整合结构化数据库与向量嵌入技术,实现了对复杂信息的持久化存储与高效检索。其底层架构采用 PostgreSQL 作为结构化记忆载体,支持目标、决策、状态、偏好等关键信息的分类管理;同时借助 pgvector 扩展实现语义向量存储,利用中文专用模型 bge-large-zh 生成高维嵌入,使系统能够理解并匹配自然语言中的深层含义。这种双重机制不仅保证了事实性数据的精确记录,也赋予系统超越关键词匹配的语义理解能力。此外,系统内置自动归档功能,可将本地临时文件在保留7天后无缝迁移至数据库,形成完整的记忆生命周期管理。整个体系设计兼顾灵活性与可扩展性,既可通过命令行直接操作数据库,也提供 Python 脚本接口供开发者深度集成。

核心功能特点

  1. 支持目标、决策、状态、偏好等多维度结构化记忆存储
  2. 基于 bge-large-zh 模型的中文语义向量搜索能力
  3. 自动归档机制实现本地文件到数据库的周期性迁移
  4. 双数据库架构分离结构化数据与向量索引
  5. 提供命令行工具与 Python 脚本双重交互方式
  6. 内置 HNSW 索引加速大规模向量相似度计算

适用场景

该系统的核心价值在于处理需要跨会话保持认知连续性的复杂交互场景。当用户需要AI助手长期记住个人工作习惯(如偏好的编程语言、开发框架选择)、项目阶段性成果或失败经验时,传统对话窗口的有限上下文已无法满足需求。此时,OpenClaw 可将这些关键信息存入结构化记忆区,并在后续对话中自动调用相关决策记录辅助推理。对于知识密集型任务,例如科研工作者希望AI能追溯过往文献阅读笔记或实验结论,系统通过向量记忆模块可实现‘我说过我喜欢什么’这类模糊查询的自然语言检索。特别适用于需要AI扮演长期顾问角色的应用场景,如个人效率教练、智能投资助手或医疗健康管家,其中用户的长期偏好演变轨迹和重大决策历史构成了智能服务的核心知识库。企业部署场景中,也可用于构建客户画像记忆系统,让客服机器人持续学习特定客户的沟通风格和服务历史。