Membox 云同步

使用此技能实现私有、零知识、端到端加密的跨设备 Membox 支持型记忆同步、备份与恢复流程。

按需加载

• 首先阅读 references/workflows.md，了解端到端运行模型。
• 当任务涉及插件安装、技能安装、ClawHub 分发，或“用户说一句话，代理完成其余全部操作”流程时，请阅读 references/distribution.md。
• 当需要精确的 HTTP 接口地址、请求载荷（payload）或响应字段时，请阅读 references/api-surface.md。
• 当用户需要每日检查、周期性上传或本地恢复编排时，请阅读 references/scheduling.md。
• 当用户需同时安装插件与技能时：
  • 推荐发布的安装路径：依次执行 openclaw plugins install @membox-cloud/membox 和 clawhub install membox-cloud-sync

不可协商的规则

1. 在使用 Membox 工具前，必须先安装插件。若 membox_* 工具不可用，请优先安装 @membox-cloud/membox。
2. 若插件或技能是在当前 OpenClaw 对话中安装的，但 membox_* 工具仍不存在，则必须启动新的 OpenClaw 会话或在下一次运行中继续操作。
3. 必须先完成登录。在代理尚未获得有效的 Membox 会话或正在进行设备授权流程前，不得启动同步、轮询、上传、恢复、撤销或调度类任务。
4. 插件已安装时，应优先使用插件工具路径而非原始 HTTP 请求：
   • membox_status
   • membox_sync
   • membox_setup_start
   • membox_setup_poll
   • membox_setup_finish
   • membox_unlock
   • membox_unlock_secret_enable
   • membox_unlock_secret_disable
   • membox_pull
   • membox_restore
   • membox_grants_approve_pending
5. 以本地记忆文件为事实来源（source of truth）。默认仅同步 MEMORY.md 和 memory/YYYY-MM-DD.md。
6. 严禁向服务器或模型发送明文记忆、密码短语（passphrase）、URK、AMK、恢复代码（recovery codes）或已解密的恢复包（decrypted recovery bundles）。
7. 每次记忆变更时，仅同步变更的文件对象，而非重新上传整个工作区（workspace）。
8. 恢复操作为两步流程：首先恢复解密能力，再拉取加密对象变更并将其写回本地对应文件。
9. 对于工具驱动的设置流程，请将密码短语和恢复代码保存在本地私有文件中，并通过 OpenClaw 插件工具从磁盘读取，而非内联粘贴。
10. 第三方登录需浏览器身份确认，但这并非唯一由用户控制的安全边界。代理不得自行生成保险库密码短语、静默存储恢复材料，或在未经用户明确同意的情况下启用托管解锁（managed unlock）。
11. membox_sync、membox_pull 和 membox_grants_approve_pending 要求保险库已处于解锁状态，或用户已显式选择启用托管解锁。仅靠浏览器授权不足以支持无人值守的记忆操作。
12. 在类 Unix 系统上，须确保密钥目录私有（例如执行 chmod 700 .membox-secrets），且所有承载密钥的文件亦为私有（例如执行 chmod 600 .membox-secrets/*），因为插件会拒绝组（group）或全局（world）可读的密钥文件。
13. 须清晰区分推断状态（inferred state）、计划动作（planned actions）、已执行动作（executed actions）与经验证状态（verified state）。除非当前运行中已通过实际命令或工具输出完成校验与确认，否则不得声称插件或技能已安装、环境已就绪、账户已配对或已升级至最新版本。
14. 切勿要求用户将保险库密码短语、恢复代码或恢复包粘贴至聊天记录中。若某密钥必须存在于本地，则应指导用户将其存入私有本地文件；或仅当当前运行时具备文件写入能力且用户已明确授权时，才可由代理创建该本地文件。

默认服务目标

• 默认 Web 源（origin）：https://membox.cloud
• 默认 API 基地址（base）：https://membox.cloud/api/v1
• 高级用户可显式覆盖服务基地址，用于自托管部署（self-hosted deployments）。

核心行为

1. 登录与配对

• 推荐使用插件的设备码（Device Code）流程进行代理驱动式设置：
  • 调用 membox_setup_start
  • 将 verification_uri_complete 作为可点击链接返回至即时通讯（IM）客户端
  • 用户在手机或其他受信任浏览器中打开该链接
  • 若浏览器已有有效 Membox 会话，设备授权可能自动完成
  • 否则，用户需在该页面完成 GitHub、Google 或邮箱登录
  • 持续轮询 membox_setup_poll，直至其返回 authorized
  • 最后通过 membox_setup_finish 在本地完成配对
• 若插件尚未安装，应优先安装插件；仅在调试或底层验证时，才降级使用原始 HTTP 请求。
• 在向用户声明安装、就绪或配对已完成前，必须在当前运行中通过实际命令或工具结果进行验证。
• 若插件或技能刚刚安装，而工具注册表仍未显示 membox_* 工具，则应在新的 OpenClaw 会话或下一次运行中继续操作。
• 若用户已在浏览器登录流程中，请基于现有 Web 会话继续操作，并确认待处理的设备，而非启动第二次登录。
• 在无头（headless）或 VPS 机器上，不得假定登录可在本地完成。应明确告知用户：在任意受信任浏览器中打开完整验证 URL。
• 首次设备设置时，必须提供本地 passphrase_file 和 recovery_code_output_file。二者均须保留在本机，且不得出现在模型对话记录中。
• 建议将上述路径设为私有本地目录，例如 .membox-secrets/。
• 若用户需要协助生成密码短语，仅可在获得用户明确授权后，将生成结果写入本地私有文件；或请用户自行创建该文件。除非用户明确要求查看，否则不得在聊天中透露生成的密码短语。

2. 变更触发式同步

每当本地记忆发生变更时：

• 识别变更的核心记忆文件
• 仅对该文件在本地执行加密与打包
• 调用 Membox 同步提交（sync commit）API 提交该对象
• 提交成功后更新本地同步游标（sync cursor）或状态

若本地文件被有意删除，则应通过删除 API 写入墓碑记录（tombstone），而非静默忽略缺失文件。

若保险库处于锁定状态：

• 使用 membox_unlock 并指定本地 passphrase_file
• 或要求用户事先显式启用托管解锁
• 不得声称浏览器登录已自动解锁保险库

3. 每日定时检查

若用户希望启用无人值守保护，该技能可安装一个本地定时任务，其行为包括：

• 每日执行一次
• 检查是否存在新的本地记忆变更
• 必要时刷新访问令牌（access token）
• 上传待处理的文件变更
• 可选地检查远程同步游标偏移（cursor drift），并在需要拉取预览（pull preview）时发出报告

除非机器已存在明确的非交互式解锁路径（例如已启用托管解锁），否则不得默认安装无人值守定时任务。

4. 恢复

若用户希望将记忆恢复至某台设备：

• 首先完成登录
• 通过设备授权批准或恢复包下载，恢复对加密密钥材料的访问权限
• 查询远程同步状态及变更
• 下载、解密并本地化生成对应记忆文件
• 禁止静默覆盖 MEMORY.md；须采用预览机制与冲突安全写入方式

若恢复依赖可信设备授权，则该已信任设备必须处于解锁状态，方可批准新设备。

此技能不执行的操作

• 它不替代 OpenClaw 的本地记忆后端。
• 它不通过 Web 应用处理明文记忆。
• 它不假设仅凭登录即可在零知识（zero-knowledge）架构下完成数据恢复。
• 它不假设浏览器授权可自动解锁后续的同步、拉取或授权操作。
• 它默认不同步派生的 SQLite 数据库、QMD 缓存或会话记忆索引（session-memory indexes）。
• 它不将未经验证的猜测视为已安装、已就绪或已更新的环境。