核心用法
X1 Vault Memory 是专为 OpenClaw 智能体设计的加密记忆保险箱。通过简单的 Node.js 命令行工具，用户可将 AI Agent 的核心身份文件（IDENTITY.md、SOUL.md、USER.md、TOOLS.md）及 memory/ 目录打包为 tar.gz，经 AES-256-GCM 军事级加密后上传至 IPFS 去中心化网络，并将内容标识符（CID）永久锚定在 X1 区块链上形成不可篡改的存证记录。
基础操作流程：
1. 配置环境：设置 PINATA_JWT 令牌（Pinata IPFS 服务凭证）与 X1_RPC_URL
2. 生成钱包：通过 @solana/web3.js 创建 Solana 兼容密钥对，存储于 x1_vault_cli/wallet.json——此密钥同时作为加密密钥与区块链交易签名密钥
3. 执行备份：node src/backup.js 完成加密→上传→锚定全链路
4. 按需恢复：node src/restore.js <CID> 下载并解密还原，支持 --only 参数进行选择性文件恢复
5. 版本管理：node src/list.js 查看所有备份历史，配合 SHA-256 校验实现版本回滚
6. 心跳守护（可选）：通过 cron 定时运行 heartbeat.js，监测文件完整性，异常时自动触发恢复
---
显著优点
| 维度 | 特性 |
|------|------|
安全性 | AES-256-GCM 认证加密 + SHA-256 完整性校验，私钥本地保管，服务端零知识
可靠性 | IPFS 分布式存储消除单点故障，CID 区块链锚定提供永久可验证的存证
经济性 | 年成本约 0.03 美元（Pinata 免费层 1GB/500 文件，单次备份约 10-50KB）
便捷性 | 纯 Node.js 实现，零外部 CLI 依赖，支持 Docker 化部署与 cron 自动化
可审计 | 完整本地日志 vault-log.json，所有 CID、时间戳、校验和可追溯
---
潜在缺点与局限性
1. 密钥管理风险：wallet.json 既是区块链钱包也是加密密钥，丢失即永久无法解密；泄露则数据完全暴露。文档虽多次警告"使用专用钱包"，但未提供硬件钱包或分片密钥等进阶方案
2. X1 生态依赖：CID 锚定依赖 X1 区块链的可用性与低廉 Gas，若网络拥堵或代币波动可能影响功能
3. IPFS 可用性：虽然 Pinata 提供免费托管，但长期稳定性依赖第三方服务；用户需自行监控 pinning 状态
4. 恢复时效性：从 IPFS 下载+解密+还原非瞬时完成，不适合需要毫秒级恢复的高可用场景
5. 学习曲线：涉及区块链钱包、JWT 令牌、环境变量配置等多重概念，对非技术用户门槛较高
6. 元数据暴露：虽然内容加密，但 CID、交易记录、时间戳等元数据在链上公开，存在模式分析风险
---
适合人群
- OpenClaw Agent 重度用户：积累了大量个性化记忆、身份设定，无法承受数据丢失
- 去中心化技术爱好者：追求"服务器死亡、容器抹除"场景下的数据主权
- 自动化运维团队：需要可编程、可 cron 调度的 Agent 状态备份方案
- 安全意识强的开发者：理解密钥管理责任，能妥善保管
wallet.json与PINATA_JWT
不适合：追求一键式云备份的普通用户、无法承担密钥丢失风险的机构、需要合规审计支持的企业环境。
---
常规风险
| 风险类型 | 描述 | 缓解建议 |
|----------|------|----------|
密钥丢失 | wallet.json 损坏或删除导致所有备份不可解密 | 离线多份备份密钥，考虑 Shamir 秘密共享 |
JWT 泄露 | PINATA_JWT 被窃取可能导致备份文件被恶意删除 | 定期轮换密钥，限制 Pinata 权限仅保留 pinFileToIPFS |
合约/链风险 | X1 区块链智能合约漏洞或共识故障 | 监控官方安全公告，保留本地 vault-log.json 作为 fallback |
供应链攻击 | @solana/web3.js 或 Pinata SDK 被篡改 | 锁定依赖版本，启用 lockfile，审计构建产物 |
自动化误恢复 | heartbeat.js cron 配置错误可能导致错误覆盖 | 生产环境先测试 --dry-run，手动确认后再启用自动恢复 |