核心用法
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 模式存在供应商锁定与定价变动风险
- 合规隐患:企业环境中全量日志可能违反数据最小化原则,需法务评估