智能体记忆库

技能简介

HexMem 是基于 SQLite 的结构化记忆系统，为 AI 智能体提供跨会话的身份认知、知识积累与连续性保障。不同于简单日志，它通过实体-事实-事件三层模型构建自我知识体系。

业务背景

AI智能体在多轮对话中常出现"失忆"问题，导致用户体验断裂。该系统为智能体建立结构化记忆档案，使其能持续认知自身角色、积累领域知识、追踪历史决策，真正实现有"人格连续性"的长期服务陪伴。

落地案例：一个电商导购智能体接入该系统后，首次对话即记录用户偏好"偏好日系简约风格、预算500元内"。两周后用户再次咨询，智能体主动关联历史："您之前关注的极简系列上新了，这几款在您的预算范围内"。同时自动标记该用户的决策犹豫点，后续推荐时优先展示带运费险的商品，转化效率明显提升。

能做什么

• 存储智能体身份属性与领域专长
• 以主谓宾三元组记录实体知识
• 自动管理记忆热度（热/温/冷三级衰减）
• 追踪决策事件与情感标记
• 沉淀经验教训并支持复用提醒
• 管理目标进度与待办任务
• 基于语义的向量检索

使用说明

安装方式一：手动克隆

cd ~/your-workspace
git clone https://github.com/hexdaemon/hexmem.git
cd hexmem
./migrate.sh up

安装方式二：ClawHub 一键安装

clawhub skill install hexmem

初始化配置

export HEXMEM_DB="$HOME/your-workspace/hexmem/hexmem.db"
source ~/your-workspace/hexmem/hexmem.sh

日常使用入口

/home/sat/clawd/hexmem/scripts/hexmem-check.sh  # 快速状态检查
hexmem_pending_tasks      # 查看待办
hexmem_recent_events 5    # 最近事件
hexmem_search "关键词"     # 语义检索

核心写入命令

hexmem_event "decision" "类别" "摘要" "详情"   # 记录决策
hexmem_task "标题" "详情" 优先级 截止日期       # 创建任务
hexmem_lesson "领域" "内容" "来源"              # 沉淀经验

输入与输出

见下方输入与输出表格。

风险提示

• 数据库文件需定期备份，避免单点故障导致记忆丢失
• 敏感信息（密钥、凭证）不应存入事实表
• 语义搜索依赖 Python 环境，需手动执行 embed.py 生成向量
• 高频写入可能触发 SQLite 锁竞争，批量操作建议事务包裹

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/santyr/skill-hexmem/SKILL.md
来源类型：GitHub 仓库