什么是SpacetimeDB Memory
SpacetimeDB Memory 是一款专为 OpenClaw 设计的高性能内存集成工具，通过 WebAssembly 技术提供低延迟的本地数据库支持。它直接连接运行在本地的 SpacetimeDB 实例，使用户能够高效地存储、查询、更新和删除长期记忆数据。该工具旨在为智能体或代理系统提供持久化且可扩展的记忆管理能力，避免传统文件读写带来的性能瓶颈。
核心功能围绕四个主要操作构建：stdb_store 用于添加新记忆并附带标签；stdb_search 支持基于文本内容或标签进行快速检索；stdb_edit 允许用户修改已有记忆的元数据和内容；stdb_forget 则彻底删除指定 ID 的记忆项。所有操作均通过轻量级命令行接口完成，便于集成到自动化流程中。
此外，工具包包含一个遗留导入脚本 legacy-import.js，可将旧版扁平化记忆文件（如 MEMORY.md、IDENTITY.md）迁移至 SpacetimeDB 结构中。但出于数据安全考虑，此脚本具有破坏性，必须通过 –confirm 参数显式启用，并会创建 .bak 备份以防误操作导致原始文件丢失。
核心功能特点
- 基于 SpacetimeDB 的低延迟 WebAssembly 内存系统
- 支持记忆存储、搜索、编辑与删除四大核心操作
- 提供环境变量配置以自定义数据库连接参数
- 内置遗留数据迁移脚本，支持从 flat-file 格式转换
- 强制安全机制防止意外覆盖用户关键文件
适用场景
SpacetimeDB Memory 特别适用于需要持久化记忆功能的智能代理、聊天机器人或多轮对话系统。例如，在开发长期交互型 AI 应用时，系统可借助该工具记录用户偏好、历史对话摘要及上下文信息，并在后续会话中快速调取相关记忆以提升连贯性与个性化体验。由于采用本地数据库而非纯文件存储，读写效率显著优于传统方式，尤其适合高频次记忆更新场景。
对于开发者而言，该技能还可作为 OpenClaw 生态中的基础设施组件，用于构建具备自我学习能力的自动化工作流。比如结合自然语言处理模块，自动提取文档要点并打上语义标签存入数据库，再通过 stdb_search 实现知识库的快速检索。同时，其模块化设计使得记忆管理逻辑可独立测试和维护，降低整体架构复杂度。
需要注意的是，尽管功能强大，但在生产环境中部署时应谨慎评估遗留导入脚本的风险。建议仅在明确知晓数据结构差异且已做好备份的前提下执行迁移操作。日常使用中推荐优先采用 stdb_store 和 stdb_search 进行增量式记忆维护，避免大规模批量操作引发性能波动。