核心用法
Super Memori 是面向 OpenClaw 代理的本地优先混合记忆技能，提供四大公共命令：./query-memory.sh（智能检索）、./memorize.sh（持久化学习）、./index-memory.sh（索引维护）、./health-check.sh（健康检测）。系统支持词汇检索、语义嵌入、混合融合（RRF）、时序关系重排四种检索模式，并能根据主机状态自动降级。
关键操作流程：先执行健康检查 → 再查询（默认 --mode auto） → 最后决定写入。系统要求信任脚本返回的 mode_used、degraded、warnings[] 等字段，禁止推断超出 payload 声明的能力。
显著优点
- 降级透明性：语义依赖缺失时自动回退到词汇检索，并通过结构化 JSON 明确报告降级状态
- 弱模型友好：四命令极简接口、显式退出码表、决策矩阵，降低认知负担
- 本地优先：无云端依赖，保护隐私，支持离线运行
- 变更记忆追踪：记录
applied/failed/reverted/unverified四种操作状态，支持审计与回滚 - 多模态检索：词汇精确匹配 + 语义意义匹配 + 混合融合，适应不同查询场景
潜在缺点与局限
- 主机依赖性强：语义功能需本地安装
sentence-transformers、numpy、Qdrant 服务及向量构建，任一缺失即降级 - 无自动后台维护：拒绝常驻守护进程设计，需显式调用
index-memory.sh维护新鲜度 - 写入门槛高：
memorize.sh仅用于可复用决策规则，禁止记录单次噪音；变更前需通过预动作门检查健康与回滚路径 - 部分主机已知缺陷：
system_hygiene在某些主机上可能显示陈旧或部分可见，需视为降级信号
适合人群
- 运行 OpenClaw 代理的本地 Ubuntu 主机管理员
- 需要可审计、可回滚长期记忆的技术用户
- 在弱模型/受限环境下仍需可靠记忆功能的场景
- 重视数据本地驻留、拒绝云同步的隐私敏感用户
常规风险
| 风险场景 | 缓解机制 |
|---------|---------|
| 健康检查 `FAIL` 仍继续操作 | 强制 `D-FAIL` 停机，禁止任何查询/写入 |
| 降级模式误报为正常检索 | 必须检查 `degraded` 字段，`D-WARN-*` 目录强制显式警告 |
| 陈旧索引导致决策失误 | `index_fresh=false` 触发 `D-WARN-COMBINED`，撤销词汇检索权威性 |
| 写入无回滚路径 | 预动作门强制验证 `git status`/备份，否则中止 |
| 变更记忆与实际状态冲突 | 实时文件系统检查优先于记忆记录，冲突时降级处理 |
| 误将降级词汇匹配描述为语义检索 | 操作规则4明确禁止，违规即破坏可信度合约 |