sq-memory

核心用法

SQ Memory 是专为 OpenClaw 生态设计的持久化记忆技能，通过连接 SQ（11D 文本存储系统）解决 AI 代理"会话失忆"问题。安装后，代理自动获得 remember、、recall、、forget、、list_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 变更可能导致技能失效，建议锁定版本并关注更新。