核心定位与架构
ClawVault 是面向 OpenClaw AI 代理的便携式身份保险箱，采用「iCloud + Git」混合架构，解决 AI 代理在多台机器间知识断层的核心痛点。系统通过 Ed25519 非对称加密实现端到端安全，私钥永不出本地，公钥注册至存储后端。
核心用法
初始化流程：clawvault.sh init 生成密钥对并扫描本地环境 → 选择存储后端（8 种 BYOS 选项或托管云）→ 30 秒内自动同步启动。日常完全无感，文件变更自动提交推送。
关键命令矩阵：
- 状态感知：
status、log、diff三级透明度 - 迁移场景：
migrate.sh pull交互式恢复、push-identity显式人格备份（需用户确认） - 包管理：
track-packages.sh扫描/比对/安装工作流 - 版本控制：
rollback支持历史状态回退
显著优点
1. 多存储后端零锁定：Google Drive、Dropbox、S3、WebDAV、Git、FTP/SFTP、本地挂载全覆盖，用户完全掌控数据主权
2. 隐私优先设计：敏感文件分级策略明确——SOUL.md、IDENTITY.md 等本地人格文件默认永不自动同步，避免跨设备人格污染
3. 离线优先架构：本地全功能运行，变更队列化，联网后自动 flush
4. 成本可控：典型个人用户 10-30 MB 完全免费，重度用户 <$1/月，无实例/带宽附加费
潜在局限与风险
技术局限：依赖外部存储 API 稳定性（OAuth token 过期、S3 兼容性问题）；Git 后端用户需自行处理大文件；无原生去重机制，版本历史可能膨胀存储成本。
安全风险：虽然私钥本地存储（600 权限），但文件系统被攻破即等同于密钥泄露；credentials/ 目录虽独立加密，但文档未说明具体加密方案强度；依赖用户正确区分「共享知识池」与「本地人格」的边界，误配置可能导致敏感信息意外同步。
运营风险：ClawVault Cloud 为付费托管选项，长期可持续性未知；MIT 许可证意味着官方支持有限。
适合人群
- 多设备 AI 用户：工作station + 笔记本 + 云端开发环境频繁切换
- 团队协作者：共享
knowledge/projects/与requirements.yaml实现环境一致性 - 隐私敏感型用户：拒绝 SaaS 锁定，偏好 BYOS 方案
- 自动化爱好者：希望 AI 代理「记住」跨会话的长期上下文
常规风险
- 同步冲突：多设备并发编辑时可能产生合并冲突，需人工介入
- 存储后端凭证泄露：OAuth token 或 S3 key 的管理责任转嫁用户
- 版本历史膨胀：长期运行的 vault 可能累积大量 commit，需定期清理或接受存储成本上升
- 密钥丢失：无恢复机制，密钥轮换后旧设备需重新授权