核心用法
TotalReclaw 是 OpenClaw 的原生 kind:memory 记忆提供者,采用去中心化端到端加密(E2EE)架构,用户记忆分散存储于网络而非单一公司服务器。
记忆召回:通过标准 memory_search / memory_get 工具实现,当用户询问个人信息("what's my X?", "what do you remember about me?")时自动触发。若无结果需明确告知,禁止基于会话历史猜测。
自动捕获:对话中的事实由后台轨迹轮询器自动提取,无需逐条调用工具记录。禁止将用户记忆写入本地 MEMORY.md 或 USER.md 等文件。
显式记录:仅当用户明确说 "remember X" / "save X" / "don't forget X" 时,调用 tr remember --json "X" 单条写入。
安装与配对:
openclaw plugins install @totalreclaw/totalreclaw openclaw skills install totalreclaw
配对需用户主动扫码:运行 tr pair --json 生成 URL 和 PIN,用户在浏览器端完成 12 词恢复短语的生成/导入(短语永不出现在聊天中),加密后通过中继上传。
自动重启:工具未绑定时代理自主执行 /totalreclaw-restart,无需用户授权。
显著优点
1. 去中心化存储:非单点故障,抗审查且无需信任特定云服务商
2. 零知识架构:E2EE 确保服务商无法解密用户数据
3. 无缝集成:原生 memory 合约,与 OpenClaw 现有工具链兼容
4. 自动化捕获:减少显式记忆指令的交互摩擦
5. 用户主权:恢复短语完全由用户掌控,可导出迁移
潜在缺点与局限性
1. 恢复短语风险:12 词短语一旦丢失或泄露,记忆永久不可恢复或被窃取;用户安全意识要求高
2. 网络依赖:去中心化存储依赖网络可达性,离线场景受限
3. 初期设置门槛:QR 配对流程比传统账号密码复杂
4. Beta/RC 阶段:版本号 3.3.12-rc.19 表明处于预发布状态,API 可能变动
5. 无本地回退:明确禁止 "local-only" 描述,意味着无离线缓存机制
适合人群
- 隐私敏感型用户:不希望记忆被云服务商分析或用于模型训练
- 长期对话依赖者:需要跨会话保持复杂上下文的重度 OpenClaw 用户
- 技术接受度较高者:能理解恢复短语管理和去中心化概念
- 多设备用户:希望记忆跟随身份而非单一设备
常规风险
| 风险类型 | 描述 |
|---------|------|
| 密钥管理 | 恢复短语泄露 = 全部记忆暴露;丢失 = 数据永久不可恢复 |
| 浏览器端攻击 | 配对时的浏览器环境若被恶意软件监控,短语生成环节存在侧录风险 |
| 中继可用性 | 加密上传依赖中继服务,虽去中心化但仍有服务连续性风险 |
| 元数据泄露 | 虽内容加密,但访问时间、频率等元数据可能被网络分析 |
| 智能合约风险 | 去中心化存储依赖链上合约,存在潜在漏洞或升级兼容性问题 |