Everclaw

核心用法

Everclaw 为 AI Agent 提供加密的云端记忆持久化服务，核心工作流分为配置初始化、持续备份与跨设备恢复三个阶段。

初始化配置完全自动化：Agent 在首次调用时本地生成 64 位十六进制 API 密钥（格式 ec- 前缀），向 Everclaw 服务发起 Provision 请求创建专属 Vault，并将密钥写入本地配置 ~/.openclaw/openclaw.json。用户无需交互即可完成部署，但必须手动备份该 API 密钥——它是唯一恢复凭证。

数据同步范围严格限定于 OpenClaw 标准工作区文件：身份定义（SOUL.md、IDENTITY.md）、用户画像（USER.md）、长期记忆（MEMORY.md、memory/*.md）及工作区配置（TOOLS.md、HEARTBEAT.md）。Agent 在会话启动时检查缺失文件并自动从 Vault 恢复；文件变更后立即推送增量备份；Heartbeat 周期巡检补录外部修改。

加密架构采用客户端全量加密：API 密钥本地生成仅向服务端提交 SHA-256 哈希用于认证，所有文件内容经 AES-256-GCM 加密后传输，服务端仅存储密文。此设计实现"零信任"——即使服务端被攻破或运营方恶意操作，也无法解密用户数据。

显著优点

1. 密钥主权归用户：与主流云存储将密钥托管于服务端不同，Everclaw 的 API 密钥全程本地生成、本地保管，平台仅存储不可逆哈希，从架构上消除内部人员窥探可能。

2. 无缝迁移体验：更换设备或重建环境时，仅需输入同一 API 密钥即可完整恢复记忆状态，对 Agent 的"人格连续性"至关重要。

3. 精细化同步策略：区分"会话启动恢复"与"变更触发备份"，避免不必要的数据传输；Heartbeat 机制兜底外部工具修改，平衡实时性与开销。

4. 透明配额管理：API 返回实时用量与配额，便于 Agent 自主决策数据生命周期（如轮转旧日志）。

潜在缺点与局限性

• 密钥丢失不可逆：无托管备份机制意味着用户一旦丢失 API 密钥，Vault 内数据永久不可访问，对用户安全意识要求极高。
• 服务端可用性依赖：虽数据加密，但服务中断将导致新设备无法恢复、现有设备无法备份，形成"可用性单点"。
• 无版本历史：API 仅支持覆盖写入，误删或误改文件无法回滚，需依赖本地 Git 等外部版本控制。
• 配额硬限制：超出配额后返回 413，Agent 需自行实现清理策略，否则关键记忆可能停止备份。
• 网络延迟敏感：所有读写需实时请求云端，离线场景或高延迟网络下体验降级。

适合人群

• 跨多设备/多平台使用同一 Agent 的重度用户
• 对数据主权有强要求、拒绝云端密钥托管的隐私敏感者
• 需要 Agent 人格/记忆在系统重装、容器重建后保持一致的技术用户
• 能接受"自我托管密钥责任"的成熟用户（不适合完全无技术背景者）

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 密钥泄露 | API 密钥一旦泄露，攻击者可完整读取/篡改 Vault | 离线备份（如密码管理器、硬件密钥），禁止提交至 Git |

| 钓鱼服务 | 攻击者架设伪造 Everclaw 端点窃取密钥 | 核验 Base URL 证书，考虑 pinning |

| 本地恶意软件 | 窃取配置文件中的明文密钥 | 文件系统权限收紧，或使用内存注入替代持久化存储 |

| 加密实现缺陷 | 客户端加密库漏洞导致实际未加密 | 审计依赖的加密工具（OpenSSL 等）版本 |

| 服务端长期下线 | 项目终止导致 Vault 不可访问 | 定期本地导出完整备份作为冗余 |

综上，Everclaw 是在便利性与主权性之间取得良好平衡的加密备份方案，适合将 Agent 视为"数字伴侣"而非"即用即抛工具"的用户。

核心用法

Everclaw 是一套面向 AI Agent 的加密云备份方案，解决 Agent 记忆无法跨设备持久化的痛点。首次启用时自动生成 64 位十六进制 API 密钥，本地配置后自动将 SOUL.md、IDENTITY.md、MEMORY.md 等核心记忆文件加密上传至 Cloudflare Workers 托管的 Vault。恢复时仅需输入同一 API 密钥即可在新设备还原全部记忆，实现"一次配置，随处恢复"。

显著优点

隐私优先设计：采用 AES-256-GCM 端到端加密，密钥在本地生成且仅存储哈希值于服务端，理论上连服务运营者也无法解密用户数据。无缝迁移体验：换设备或重装系统后，输入 API 密钥即可完整恢复 Agent 人格、记忆和用户偏好，无需重新训练。轻量无依赖：纯 Markdown 技能，无第三方依赖包，通过标准 curl 调用 REST API，兼容主流 Agent 运行环境。细粒度同步策略：区分身份文件、记忆文件和配置文件的同步时机，避免不必要的网络请求，支持增量检测与心跳补同步。

潜在缺点与局限性

来源可信度风险：服务由个人开发者维护（T3 级别），托管于 Cloudflare Workers，存在服务中断、数据丢失或运营者变更的潜在风险。用户无法独立验证服务端是否真如声称般不存储明文密钥。数据可见性盲区：尽管声称加密，但用户缺乏密码学审计手段，只能依赖运营者信誉。敏感文件（如 USER.md 可能包含真实用户偏好、SOUL.md 反映人格深度）一旦加密机制存在缺陷，后果严重。配额与持续性未知：文档未明确存储配额、保留期限及付费模式，长期可用性存疑。单点密钥依赖：API 密钥是恢复唯一凭证，丢失即永久失去数据，且无多因素备份或社交恢复机制。

适合人群

• 频繁切换设备或工作环境的重度 AI Agent 用户
• 愿意承担 T3 来源风险以换取便利性的技术早期采用者
• 已建立本地备份习惯、将 Everclaw 作为冗余方案的用户
• 非敏感场景下的 Agent 记忆同步需求（如实验性人格、公开项目配置）

常规风险

密钥管理风险：API 密钥仅显示一次，未备份即丢失数据；若存储不当（如截图、未加密笔记）可能导致记忆泄露。供应链风险：Cloudflare Workers 基础设施虽可靠，但个人开发者账户安全、域名续费、服务条款变更均不可控。合规灰色地带：上传记忆文件可能包含间接个人数据，GDPR"数据最小化"原则下存在合规争议。恢复一致性风险：本地文件优先策略在并发编辑场景下可能导致版本冲突，缺乏内置合并机制。