MemSync Dual Memory System

🧠 全量对话语义记忆引擎

OpenClaw对话全量记录工具,同步输出JSONL备份与Memvid语义搜索文件,支持用户/助手/子代理/工具/系统五类角色标签,提供API/免费/分片三种存储模式,实现跨会话自然语言检索与长期记忆

收藏
6.5k
安装
1.4k
版本
1.2.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Unified Conversation Logger 是专为 OpenClaw 设计的双输出对话记录系统,自动捕获用户消息、助手回复、子代理对话、工具调用及系统事件,同时输出 JSONL 结构化备份与 Memvid 语义搜索文件。安装后通过环境变量选择三种模式:API 模式(付费,单文件无限容量)、Free 模式(免费,50MB 单文件)、Sharding 模式(免费,按月分片多文件)。

使用流程:安装 @memvid/cli → 克隆技能仓库至 OpenClaw 工作区 → 设置 MEMVID_MODE 与可选的 MEMVID_API_KEY → 创建 .mv2 记忆文件 → 启动 OpenClaw 即可自动记录。检索时通过 memvid ask 进行自然语言查询(如"研究代理关于特斯拉的发现"),或配合角色标签精确过滤([user] [agent:researcher] [tool:exec] 等)。JSONL 文件可用 grep/jq 做结构化查询。

显著优点

1. 全量上下文捕获:区别于简单聊天记录,涵盖子代理内部对话、工具执行详情、定时任务等系统级事件
2. 语义搜索能力:基于 Memvid 的向量索引,支持概念级检索而非仅关键词匹配

3. 角色精准定位:五类自动标签(user/assistant/agent:*/system/tool)实现"我当时的提问""助手的建议""研究代理的发现"等定向查询

4. 存储灵活性:三种模式覆盖从免费测试到企业级使用的全场景

5. 零侵入设计:Hook 至 OpenClaw 响应流程,安装后全自动运行

潜在局限与风险

隐私敏感度高:设计哲学为"捕获一切",工具输出(命令、API 响应、文件内容)无差别记录,存在敏感数据泄露风险;需配合文件权限控制(chmod 600)与定期审计。

模式权衡明显:Free 模式 50MB 容量约 5000 轮对话后需归档或切换模式;Sharding 模式虽免费无限但牺牲跨月统一检索能力,需逐文件查询或自行封装搜索脚本。

第三方依赖:API 模式将数据发送至 memvid.com(美国服务商),虽本地模式可完全隔离,但功能受限。

定价断层:官方定价从 $0 直接跃升至 $59/月,中间档位的缺失迫使中等需求用户选择 Sharding 的碎片化方案。

适合人群

  • 需要追溯多轮复杂工作流中子代理贡献的高级用户
  • 希望用自然语言查询替代手动翻查聊天记录的效率优先者
  • 能接受完整日志带来的隐私权衡,并具备本地文件安全管理意识的技术用户
  • 愿意在 Free/Sharding 模式的限制下 DIY 搜索脚本的预算敏感型用户

常规风险

  • 敏感数据持久化:API 密钥、私钥、个人信息可能通过工具输出进入日志
  • 文件泄露风险.mv2.jsonl 文件若未加密存储,复制或备份时易暴露
  • 服务连续性:Memvid 为独立商业服务,API 模式存在供应商锁定与定价变动风险
  • 合规隐患:企业环境中全量日志可能违反数据最小化原则,需法务评估

MemSync Dual Memory System 内容

tests文件夹
tools文件夹
手动下载zip · 21.6 kB
test_log.pytext/plain
请选择文件