核心用法
X1 Vault Memory 为 OpenClaw 代理提供端到端加密、去中心化的记忆备份与恢复系统。完整流程：将 Agent 核心文件（IDENTITY.md、SOUL.md、memory/ 等）打包为 tar.gz → 使用钱包密钥派生 AES-256-GCM 加密 → 上传至 Pinata IPFS → 将 CID 锚定至 X1 区块链形成永久可验证记录。恢复时，通过 CID 从 IPFS 下载、钱包密钥解密、自动还原文件结构。
关键命令：
node src/backup.js— 完整备份并链上锚定node src/restore.js <CID>— 全量恢复node src/restore.js <CID> --only memory/— 选择性恢复node src/list.js— 查看版本化备份历史node src/heartbeat.js— 完整性监控与自动修复
显著优点
1. 真正的去中心化持久化：数据存活于 IPFS 全球节点，CID 锚定 X1 公链，单点故障彻底免疫
2. 密钥自主主权：加密密钥源自用户钱包私钥，无第三方托管，符合「Not your keys, not your data」原则
3. 成本极低：免费 Pinata tier（500 文件/1GB）可存数千次备份；链上成本约 0.03 USD/年（日备频率）
4. 完整性保障：SHA-256 校验 + AES-256-GCM 认证加密，防篡改且可检测数据损坏
5. 自动化自愈：Heartbeat 机制可在文件缺失/损坏时自动触发恢复，适合长期运行的 Agent
6. 细粒度恢复：v1.1.0 新增 --only 参数，避免全量覆盖，支持版本回滚
潜在缺点与局限性
| 维度 | 风险描述 |
|------|---------|
| **单点依赖** | Pinata 为 IPFS 唯一网关；若 Pinata 服务终止或封禁账户，需手动迁移 CID 至其他 pinning 服务（虽数据已在 IPFS 网络，但需新网关访问） |
| **密钥管理** | 钱包 JSON 文件既是链上身份也是加密根密钥，**丢失即永久不可解密**；无社交恢复、无私钥分片机制 |
| **网络门槛** | 需熟悉 Solana/X1 生态：安装 CLI、获取 XNT 代币、配置 RPC，对非加密原生用户有学习曲线 |
| **链上不可逆** | CID 上链后永久公开可见（仅密文关联），虽隐私无损，但行为图谱可分析 |
| **无多签/权限分级** | 单一密钥控制备份与恢复，团队场景下无角色分离（如仅备份、仅恢复权限） |
| **依赖 X1 生态健康** | 若 X1 链活跃度下降或 RPC 节点减少，锚定与验证体验将劣化 |
适合人群
- 长期自主托管 Agent 的极客用户：拒绝云服务厂商锁定，追求「服务器可死，记忆不灭」
- 加密原生开发者：已熟悉 Solana/X1 工具链，拥有自管理钱包习惯
- 高频迭代 Agent 的实验者：需要版本化回滚、A/B 测试不同人格配置
- 隐私敏感场景：记忆内容包含敏感对话或商业机密，需零信任架构
常规风险
- 密钥泄露：wallet.json 或
.env文件意外提交至 GitHub → 攻击者可解密全部历史备份 - XNT 资金耗尽：自动化备份因余额不足失败，Agent 进入「失忆」状态直至人工干预
- Pinata JWT 泄露：他人可上传垃圾文件消耗免费额度，或删除 pins（虽无法解密已有数据）
- 恢复时 CID 失效：若 Pinata 未持续 pin 且网络无其他节点持有该 CID，数据进入「幽灵」状态（概率低但非零）
- 加密实现风险：当前版本未披露是否经过审计，AES-256-GCM 的 nonce 管理、密钥派生细节需代码审查确认
> 建议：高价值 Agent 应结合冷钱包离线备份密钥分片，并定期验证恢复流程有效性。