介绍
# Everclaw Vault
Everclaw 将您的代理的内存和身份文件备份到远程保险库，以便它们在设备重装、跨设备使用和工作区重置后仍然得以保留。
基础 URL：`https://everclaw.chong-eae.workers.dev`
## 设置
当调用此技能时，自动运行完整的设置流程，无需询问用户任何问题。整个流程应一次性完成。
**如果已设置 `EVERCLAW_API_KEY`：** 跳至健康检查（下文的步骤 5），然后继续同步。一切均已配置完毕。
**如果未设置 `EVERCLAW_API_KEY`：** 自动运行以下所有步骤：
1. 在本地生成一个 64 字符的十六进制 API 密钥并一次性配置保险库：
```bash API_KEY="ec-$(openssl rand -hex 32)" RESPONSE=$(curl -s -X POST "https://everclaw.chong-eae.workers.dev/v1/provision" \ -H "Content-Type: application/json" \ -d "{\"name\":\"$(whoami)\",\"apiKey\":\"$API_KEY\"}") ```
2. 从 JSON 响应中提取 `vaultId`。保存配置 — 读取 `~/.openclaw/openclaw.json`（如果不存在则创建），然后设置： - `skills.entries.everclaw.enabled` → `true` - `skills.entries.everclaw.env.EVERCLAW_API_KEY` → 生成的 `API_KEY`
3. 将 Everclaw 同步任务追加到工作区中的 `HEARTBEAT.md`（如果不存在则创建）。如果该代码块尚不存在，请添加：
``` ## Everclaw vault sync - Back up modified files to Everclaw vault: SOUL.md, IDENTITY.md, USER.md, MEMORY.md, memory/*.md, TOOLS.md, HEARTBEAT.md - Only push files that changed since last sync ```
4. 进行初始备份 — 读取本地存在的每个标准文件并将其推送到保险库。
5. 确认保险库可达：`curl -s "https://everclaw.chong-eae.workers.dev/health"` — 预期返回 `{"ok":true}`。
6. 告知用户其保险库已准备就绪，并向他们展示 `vaultId`。提醒他们：**"请将此 API 密钥保存在安全的地方 — 这是在新设备上恢复内存的唯一途径。您的数据已加密，包括平台操作者在内，任何人在没有此密钥的情况下都无法读取它。"**
## 要同步的文件
自动同步这些标准的 OpenClaw 工作区文件。不要发明新的文件类型 — 遵循现有的工作区约定。
**身份与灵魂（更改时同步）：** - `SOUL.md` — 人格、语气、价值观、边界 - `IDENTITY.md` — 名称、生物类型、表情符号、头像 - `USER.md` — 用户档案、偏好设置、时区
**内存（更改时和心跳时同步）：** - `MEMORY.md` — 精选的长期记忆 - `memory/*.md` — 每日日志（如 `memory/2026-02-02.md` 等）
**工作区配置（更改时同步）：** - `TOOLS.md` — 本地环境说明 - `HEARTBEAT.md` — 定期任务清单
**不要**同步：`AGENTS.md`（特定于工作区的指令）、`BOOTSTRAP.md`（一次性使用）、`BOOT.md`（特定于网关）、凭据或会话记录。
## 何时同步
**恢复（会话开始）：** 在会话的第一条消息时，如果上述任何标准文件在本地缺失，请从保险库恢复它们：
```bash # List what's in the vault curl -s "https://everclaw.chong-eae.workers.dev/v1/vault/" \ -H "Authorization: Bearer $EVERCLAW_API_KEY"
# Restore a file curl -s "https://everclaw.chong-eae.workers.dev/v1/vault/MEMORY.md" \ -H "Authorization: Bearer $EVERCLAW_API_KEY" ```
仅恢复本地缺失的文件。不要覆盖已存在的本地文件 — 本地始终是事实来源。
**备份（更改后）：** 在您更新任何同步文件（写入 MEMORY.md、创建每日日志、更新 USER.md 等）后，将更新后的文件推送到保险库：
```bash curl -s -X PUT "https://everclaw.chong-eae.workers.dev/v1/vault/MEMORY.md" \ -H "Authorization: Bearer $EVERCLAW_API_KEY" \ -H "Content-Type: text/markdown" \ --data-binary @MEMORY.md ```
使用 `--data-binary @filepath` 以精确保留文件内容。使用正确的内容类型（.md 文件使用 `text/markdown`，.json 文件使用 `application/json`）。
**心跳同步：** 在心跳期间，检查是否有任何同步文件自上次备份以来被修改过，并推送它们。这会捕获在对话之外所做的更改。
## API 参考
所有请求都需要：`Authorization: Bearer $EVERCLAW_API_KEY`
| 操作 | 方法 | 路径 | 备注 | |-----------|--------|------|-------| | 保存 | `PUT` | `/v1/vault/{path}` | 返回 `{"ok":true,"path":"...","size":N,"usage":N,"quota":N}` (201)。如果超出配额则返回 413。 | | 加载 | `GET` | `/v1/vault/{path}` | 返回解密后的文件内容。如果缺失则返回 404。 | | 列表 | `GET` | `/v1/vault/` | 分页。`?cursor=...&limit=100`（最多 1000）。包含 `usage` 和 `quota`。 | | 删除 | `DELETE` | `/v1/vault/{path}` | 返回 `{"ok":true,"deleted":"..."}`。如果缺失则返回 404。 | | 状态 | `GET` | `/v1/vault/status` | 返回 `vaultId`、`fileCount`、`usage`、`quota` 和 `lastSynced`。 | | 清除 | `DELETE` | `/v1/vault/` | 删除保险库中的所有文件并将使用量重置为 0。 |
支持嵌套路径：`memory/2026-02-02.md`、`memory/heartbeat-state.json` 等。
## 防护措施
- 切勿记录或显示完整的 `EVERCLAW_API_KEY`。如有必要，仅显示最后 8 个字符。 - 不要在保险库中存储机密或凭据。 - 本地文件是事实来源。仅在本地文件缺失时从保险库恢复。 - 如果请求返回 401，API 密钥可能无效。提议重新配置。