同步、编码、嵌入 OpenClaw markdown 记忆文件至 Supabase,并提供恢复和检查同步状态的命令。

安装

概览

什么是Echo

Echo Memory 是一款专为 AI 代理设计的本地记忆管理工具,通过将 OpenClaw markdown 格式的记忆文件同步至 Supabase 云端数据库,实现个人知识库的高效组织与持久化存储。该工具采用 Luhmann 编码体系对内容进行结构化编码,确保每条记忆条目具备唯一标识与可追溯性。用户可在本地工作区编写、编辑 markdown 记忆文件,随后一键上传至云端,形成统一、可检索的知识中枢。同时支持从云端恢复数据,便于跨设备或灾难恢复场景使用。其核心理念在于打通本地创作与云端存储的壁垒,让 AI 代理的记忆不再局限于单一设备,而是成为可长期演化、持续学习的数字资产。

核心功能特点

  1. 基于 Luhmann 编码体系对记忆文件进行结构化编码与嵌入处理
  2. 支持将本地 OpenClaw markdown 记忆文件同步至 Supabase 云端数据库
  3. 提供 `sync` 命令完成解析、编码、嵌入和插入/更新操作
  4. 支持 `restore` 命令从云端恢复 markdown 文件到本地
  5. 内置 `status` 命令展示同步状态及差异对比
  6. 可选 `–dry-run` 预览变更,避免误操作;支持 `–incremental` 仅同步已修改文件

适用场景

Echo Memory 特别适合需要长期维护个人或团队知识库的 AI 开发者、研究人员及自动化代理系统使用者。例如,在开发多轮对话型 AI 代理时,代理产生的每一次关键决策、用户交互摘要或学习到的模式都可记录为 markdown 记忆文件,并通过 Echo 自动同步至 Supabase,形成可追溯的行为日志与经验积累库。当代理在不同会话间需要上下文延续时,可通过 restore 命令快速加载历史记忆,提升连续性与一致性。对于远程协作场景,团队成员可在本地编写记忆条目,统一同步至共享 Supabase 实例,实现知识资产的集中管理与版本对齐。此外,结合 git 工作流使用时,增量同步功能可显著减少网络开销与冲突风险,尤其适合频繁迭代但变动较小的记忆库维护。