sq-memory

🧠 开源代理持久记忆引擎

基于开源SQ存储为OpenClaw代理提供跨会话持久记忆,支持自托管零依赖,实现多代理协作与上下文突破。

收藏
3.1k
安装
743
版本
v1.0.1
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

核心用法

SQ Memory 是专为 OpenClaw 生态设计的持久化记忆技能,通过连接 SQ(11D 文本存储系统)解决 AI 代理"会话失忆"问题。安装后,代理自动获得 rememberrecallforgetlist_memories` 四个核心工具,可将用户偏好、对话摘要、任务状态等数据以层级坐标形式存储至 SQ 服务端,实现跨会话的记忆延续。

配置灵活支持双模式:自托管(本地 1337 端口,5 分钟搭建,完全免费)或 SQ Cloud 托管服务($50/月)。坐标系统采用 namespace.1.1/category.subcategory.item/1.1.1 的 11D 结构,天然隔离多代理数据,同时支持通过共享坐标实现多代理协作。

显著优点

零依赖架构:纯 Node.js 原生实现(仅使用 http/https 内置模块),彻底消除供应链攻击风险,审计透明度高。

开源可控:MIT 协议,代码完全开放,用户可选择自托管实现数据主权,无供应商锁定。

确定性检索:区别于向量数据库的相似性搜索,SQ 基于精确坐标寻址,代理可直接读取完整文本,避免"幻觉式"记忆偏差。

多代理就绪:通过共享坐标空间,不同代理可读写同一记忆,为复杂工作流编排奠定基础。

轻量高效:单条记忆支持 1MB 文本,免费 tier 提供 100MB 存储与 1000 次/日调用,个人与小型团队场景充足。

潜在缺点与局限性

网络依赖:所有记忆操作需实时连接 SQ 服务端,离线场景不可用,网络延迟直接影响响应速度。

传输层隐患remember 操作使用 GET 请求传输数据,存储内容可能暴露于 URL 及服务器访问日志,敏感信息存在泄露风险。

生态绑定:专为 OpenClaw 设计,迁移至其他代理框架需适配成本;SQ 作为新兴项目,长期维护与社区规模待验证。

功能边界:非通用数据库,不支持复杂查询、事务或聚合计算,仅适合键值型层级存储场景。

商业服务成本:托管版 $50/月的定价对轻度用户偏高,自托管虽免费但需自行运维。

适合的目标群体

  • OpenClaw 深度用户:需要突破上下文窗口、构建长期个性化交互的代理开发者
  • 多代理系统架构师:探索代理协作、任务分发的技术团队
  • 隐私敏感型用户:倾向自托管、追求数据主权的个人或企业
  • 快速原型开发者:希望零配置快速验证记忆功能的场景

使用风险

性能风险:高频记忆操作可能成为延迟瓶颈,建议本地缓存热点数据;无请求超时设置,极端网络条件下可能挂起。

数据持久性:自托管版本需自行配置备份策略;托管服务依赖 mirrorborn.us 的商业持续性。

安全风险:避免存储密码、API 密钥、PII 等高度敏感信息;务必启用 HTTPS 防止中间人攻击。

版本兼容性:SQ 与 OpenClaw 均为快速迭代项目,API 变更可能导致技能失效,建议锁定版本并关注更新。

安全解读

核心用法

SQ Memory 解决 OpenClaw 智能体"会话失忆"问题,通过连接 SQ 持久化存储服务实现:

  • remember(key, value):以 11D 坐标存储任意文本(最大 1MB/坐标)
  • recall(key):精确检索存储内容
  • forget(key):删除指定记忆
  • list_memories(prefix):层级遍历记忆空间

坐标格式采用 namespace.1.1/category.subcategory.item/1.1.1 层级结构,天然支持多智能体隔离或共享记忆。

显著优点

1. 零依赖安全:仅使用 Node.js 内置 http/https 模块,无第三方 npm 包,供应链攻击面为零
2. 开源透明:MIT 许可证完整开源,代码 882 行简洁可读,无混淆或隐藏逻辑

3. 自托管自由:5 分钟本地部署,完全掌控数据,无供应商锁定

4. 结构化寻址:11D 坐标系统超越扁平键值,支持层级组织和精确检索

5. 确定性召回:与向量数据库不同,直接读取原文本,无相关性猜测或幻觉风险

潜在缺点与局限

  • 网络依赖:所有记忆操作需 HTTP 请求,离线或高延迟场景性能受限
  • 配置门槛:需单独部署 SQ 服务或订阅云端($50/月),增加运维复杂度
  • 明文风险:默认自托管配置使用 HTTP,生产环境需手动配置 TLS
  • 存储限制:免费版 100MB/1,000 次日调用,高频场景需付费升级
  • 非关系型:无复杂查询能力,仅支持前缀匹配和精确坐标检索

适合人群

  • 需要长期记忆能力的 OpenClaw 智能体开发者
  • 重视数据主权、倾向自托管的技术团队
  • 多智能体协作场景需共享记忆空间的架构
  • 对向量数据库召回不确定性敏感的应用

常规风险

| 风险项 | 说明 | 缓解措施 |
|--------|------|----------|
| 传输加密 | 默认 HTTP 存在明文风险 | 生产环境强制 HTTPS,TLS ≥1.2 |
| API 密钥泄露 | Authorization Header 传输 | 定期轮换密钥,配置端点白名单 |
| 服务端故障 | 托管服务可用性依赖 | 关键数据定期导出 .phext 备份 |
| 频率限制 | 免费版 1,000 次/天 | 本地缓存或升级付费方案 |

sq-memory 内容

examples文件夹
手动下载zip · 25.3 kB
conversation-history.jstext/javascript
请选择文件