核心用法
OpenClaw Memory Pensieve v2.1 是一套面向 AI 长期记忆的区块链锚定系统,工作流程分为六个阶段:
1. 本地层初始化:确保 memory/ 目录存在,支持 events、semantic、procedural、self_model 四层结构
2. 事件捕获:重要事件写入 events.jsonl,严格遵循追加-only 和哈希链完整性
3. 梦境周期:每日运行 dream_cycle_daily.py 将稳定模式从短期层提升至长期层
4. Algorand 锚定:加密完整记忆内容后分批上链,支持多交易承载大 payload
5. v2.1 强化验证:锚定后强制运行 hardening_v21_validate.py,验证恢复保真度
6. 灾难恢复:通过 recover_from_blockchain.py 从链上 note 重建完整记忆状态
显著优点
- 加密锚定:全内容(非仅哈希)加密存储于 Algorand,即使本地全毁仍可恢复
- 哈希链完整性:每层 JSONL 形成 Merkle-like 链,可检测任何篡改
- 分层记忆模型:events/semantic/procedural/self_model 区分处理,支持渐进式遗忘与强化
- 自动化流水线:6 个 Python 脚本覆盖日常运维,降低人工操作风险
- v2.1 硬ening 强化:锚定后验证成为阻塞性检查,杜绝"已锚定但不可恢复"的虚假安全感
潜在缺点与局限性
- 链上成本:Algorand 虽低成本,高频锚定仍需预算规划
- 密钥管理依赖:
.secrets/本地保管,丢失则链上加密数据永久不可解密 - 恢复延迟:完整重建需扫描链上多笔交易,大规模记忆恢复耗时分钟级
- 单链依赖:当前仅支持 Algorand,跨链备份需自行扩展
- 梦境周期黑箱:模式提炼规则未完全透明,关键记忆可能因统计不显著被降级
适合人群
- 运行长期自主 AI agent 需要可审计记忆历史的开发者
- 对本地数据持久化不信任、要求区块链最终一致性的场景
- 需要合规存档(如金融、医疗 AI 助手)的企业部署
- 研究记忆架构与去中心化存储结合的技术探索者
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 密钥泄露 | `.secrets/` 被复制或提交到仓库 | 文件系统权限 + gitignore + 定期轮换 |
| 链上数据不可用 | Algorand 网络拥堵或 note 字段限制变更 | 监控链健康,预留多 TX 分片逻辑 |
| 恢复验证失败 | hardening_v21_validate.py 阻塞后续流程 | 立即停止并调查锚定逻辑或链同步问题 |
| 梦境周期过度压缩 | 关键细节在模式提炼中丢失 | 调整 promotion 阈值,关键事件标记 exempt |
| 追加-only 膨胀 | JSONL 文件无限增长影响性能 | 定期归档冷层,锚定后本地可截断(需重链验证) |