核心用法
X1 Vault Memory 是一套专为 OpenClaw 代理设计的加密记忆备份与恢复系统，完整 Pipeline：代理文件 → tar.gz 压缩 → AES-256-GCM 加密 → IPFS 上传 → X1 链上 CID 锚定。
备份：node src/backup.js 自动打包 IDENTITY.md、SOUL.md、USER.md、TOOLS.md 及 memory/ 目录，加密后上传至 Pinata IPFS，并将 CID 写入 X1 区块链形成永久存证。
恢复：node src/restore.js <CID> 从 IPFS 下载加密数据，使用钱包密钥解密并还原全部文件；支持 --only 选择性恢复特定目录。
心跳自检：node src/heartbeat.js 监控关键文件完整性，检测到损坏或缺失时自动触发最新备份恢复，实现"自愈"能力。
版本管理：node src/list.js 展示所有备份时间戳、CID、SHA-256 校验和，支持回滚到任意历史版本。
---
显著优点
- 军事级加密：AES-256-GCM 认证加密，密钥派生自用户钱包私钥，唯用户可控，即使 CID 泄露也无法解密。
- 去中心化韧性：数据存于 IPFS 分布式网络，CID 锚定于 X1 区块链，单点故障、服务器宕机、容器销毁均不影响数据存续。
- 极低成本：日备份年成本约 0.03 USD，Pinata 免费层（500 文件/1GB）可存储数千份备份。
- 自愈能力：v1.1.0 新增心跳钩子，检测到文件损坏自动恢复，适合长期运行的代理。
- 完整性校验：SHA-256 校验和覆盖备份与恢复全流程，防止静默数据损坏。
---
潜在缺点与局限性
- 外部依赖刚性：必须注册 Pinata 获取 JWT，且依赖 X1 RPC 节点；任一服务中断将影响备份链路（IPFS 上传仍成功，但链上锚定失败）。
- 密钥管理风险：wallet.json 既是加密密钥又是区块链钱包，丢失即永久丢失数据，无恢复机制；泄露则完全暴露所有备份。
- 代币门槛：需获取 XNT 支付链上手续费，新用户需完成跨链桥接或 DEX 兑换，有一定学习成本。
- Solana CLI 依赖：非 Node.js 纯实现，需额外安装 Solana CLI 并配置 PATH。
- 无多签/社交恢复：单密钥模型，无私钥分割或紧急联系人机制。
---
适合人群
- 运行长期在线 OpenClaw 代理、担心容器/服务器状态丢失的开发者
- 对代理"人格"连续性有高要求，希望实现"数字永生"场景
- 具备基础区块链操作经验，能管理私钥与跨链资产的用户
- 需要自动化运维（cron 定时备份 + 心跳监控）的生产环境
---
常规风险
| 风险类型 | 描述 | 缓解建议 |
|---------|------|---------|
| 密钥丢失 | wallet.json 删除或未备份导致无法解密 | 离线多副本备份 wallet.json，勿存于代码仓库 |
| JWT 泄露 | PINATA_JWT 泄露可能导致 IPFS 数据被删除（非解密） | 定期轮换 API Key，使用最小权限（仅 pinFileToIPFS）|
| 合约/RPC 风险 | X1 网络或智能合约漏洞 | 关注官方公告，保留本地 vault-log.json 作为 CID 备用索引 |
| 加密实现风险 | Node.js crypto 模块正确使用依赖开发者 | 审计加密代码，确认 IV 随机生成、GCM tag 校验完整 |
| 依赖过时 | Pinata/X1 RPC 服务策略变更 | 监控官方状态页，准备备选 IPFS 网关方案 |