核心功能
Super Memori 是面向 OpenClaw 代理的本地优先混合记忆系统,提供四类记忆检索(情景、语义、程序、学习记忆)。核心能力包括:
- 混合检索架构:SQLite FTS5 词汇搜索 + sentence-transformers 语义嵌入 + Qdrant 本地向量库,支持 RRF 融合排序与时序关系重排
- 四级命令接口:
query-memory.sh(查询)、memorize.sh(持久化学习)、index-memory.sh(索引维护)、health-check.sh(健康诊断) - 降级容错设计:自动检测语义依赖缺失,无缝回退至词汇模式,通过结构化 JSON 状态字段明确暴露运行层级
显著优势
- 弱模型友好:最小化命令选择面,决策矩阵与退出码规范使低能力模型也能安全操作
- 本地优先隐私:拒绝云同步、远程嵌入端点、托管向量后端,数据不出本地 Ubuntu 主机
- 诚实状态暴露:
degraded、warnings[]、mode_used等字段强制声明实际运行路径,禁止推断更强能力 - 变更可审计:结构化变更记忆记录(
applied/failed/reverted/unverified),支持回滚感知与操作溯源
局限与风险
- 主机依赖性强:语义功能需本地安装 Python 依赖(sentence-transformers、numpy、Qdrant 服务)并构建向量索引,否则永久降级运行
- 无自动化守护:故意排除后台自动索引与常驻内存服务,需显式执行
index-memory.sh, freshness 需人工维护 - 维护门槛:
audit-memory.sh、repair-memory.sh等入口仅限人工/维护场景,弱模型不可直接调用 - 降级状态权威性受限:
D-WARN-COMBINED状态下词汇检索权威性被撤销,不得作为确认记忆真理呈现
适用场景
- 需长期上下文保持的本地 OpenClaw 代理部署
- 隐私敏感环境(禁止外部 API 调用)
- 资源受限或网络隔离的 Ubuntu 主机
- 需可审计、可回滚的操作历史追踪
常规风险
system_hygiene字段在部分主机呈部分可见/陈旧状态,需以实时命令输出为准- 写入/维护操作前必须通过健康检查门控与回滚验证,否则存在数据损坏风险
- 语义就绪状态与索引新鲜度分离,可能出现语义可用但索引陈旧,或索引新鲜但语义不可用的组合降级