super-memori

🧠 本地混合记忆·降级透明·弱模型安全

OpenClaw代理本地混合记忆系统,支持语义/词汇检索、变更追踪与降级容错,优化弱模型可靠性与隐私优先部署。

收藏
2.5k
安装
1.2k
版本
4.0.23
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Super Memori 是面向 OpenClaw 代理的本地优先混合记忆系统,提供四类记忆检索(情景、语义、程序、学习记忆)。核心能力包括:

  • 混合检索架构:SQLite FTS5 词汇搜索 + sentence-transformers 语义嵌入 + Qdrant 本地向量库,支持 RRF 融合排序与时序关系重排
  • 四级命令接口query-memory.sh(查询)、memorize.sh(持久化学习)、index-memory.sh(索引维护)、health-check.sh(健康诊断)
  • 降级容错设计:自动检测语义依赖缺失,无缝回退至词汇模式,通过结构化 JSON 状态字段明确暴露运行层级

显著优势

  • 弱模型友好:最小化命令选择面,决策矩阵与退出码规范使低能力模型也能安全操作
  • 本地优先隐私:拒绝云同步、远程嵌入端点、托管向量后端,数据不出本地 Ubuntu 主机
  • 诚实状态暴露degradedwarnings[]mode_used 等字段强制声明实际运行路径,禁止推断更强能力
  • 变更可审计:结构化变更记忆记录(applied/failed/reverted/unverified),支持回滚感知与操作溯源

局限与风险

  • 主机依赖性强:语义功能需本地安装 Python 依赖(sentence-transformers、numpy、Qdrant 服务)并构建向量索引,否则永久降级运行
  • 无自动化守护:故意排除后台自动索引与常驻内存服务,需显式执行 index-memory.sh, freshness 需人工维护
  • 维护门槛audit-memory.shrepair-memory.sh 等入口仅限人工/维护场景,弱模型不可直接调用
  • 降级状态权威性受限D-WARN-COMBINED 状态下词汇检索权威性被撤销,不得作为确认记忆真理呈现

适用场景

  • 需长期上下文保持的本地 OpenClaw 代理部署
  • 隐私敏感环境(禁止外部 API 调用)
  • 资源受限或网络隔离的 Ubuntu 主机
  • 需可审计、可回滚的操作历史追踪

常规风险

  • system_hygiene 字段在部分主机呈部分可见/陈旧状态,需以实时命令输出为准
  • 写入/维护操作前必须通过健康检查门控与回滚验证,否则存在数据损坏风险
  • 语义就绪状态与索引新鲜度分离,可能出现语义可用但索引陈旧,或索引新鲜但语义不可用的组合降级

super-memori 内容

hooks文件夹
super-memori-session-start文件夹
references文件夹
scripts文件夹
legacy文件夹
tests文件夹
regression文件夹
手动下载zip · 148.1 kB
handler.jstext/javascript
请选择文件