hybrid-memory

核心用法

Hybrid Memory System 是一套双轨并行的智能记忆决策框架，专为 OpenClaw 生态设计，旨在解决 AI 代理长期记忆管理中的场景适配问题。该技能不提供直接的数据操作能力，而是作为策略指南，帮助用户在两种记忆系统间做出最优选择。

向量记忆（memory_search） 适用于文档内容检索和 curated notes 查询。当用户询问"GOALS.md 中有什么内容"或"项目规范是什么"时，系统通过语义搜索遍历 Markdown 文件（MEMORY.md 及 memory/*/.md），利用嵌入向量实现基于语义的相似度匹配。

Graphiti 时序知识图谱 则专注于时间感知型查询。针对"我们何时设置了 Slack"、"上周二用户说了什么"或"Alice 参与了哪些项目"等涉及时序、对话历史和实体关系的问题，Graphiti 通过 temporal knowledge graph 提供精确的时间线追溯能力。

使用流程遵循"Recall Pattern"：先判断问题类型，时序问题优先查询 Graphiti，文档问题使用 memory_search，不确定时双管齐下，低置信度时坦诚告知用户已尝试检索但结果不确定。

显著优点

决策框架清晰化是该技能最大价值。通过明确的分类表格和场景示例，消除了用户在面对双系统时的选择困难，将"该用哪个工具"的认知成本降至最低。

双系统互补性强。向量记忆擅长语义理解和非结构化文档检索，Graphiti 擅长时序推理和实体关系追踪，两者结合覆盖了知识管理的全场景，避免了单一系统的局限性。

即插即用的模板化配置。提供的 AGENTS.md 模板可直接复制到项目配置中，包含完整的命令示例和决策逻辑，大幅降低了集成门槛。

时序感知能力突出。相比传统 RAG 仅关注内容相似度，Graphiti 的时间维度让 AI 具备了"记忆何时发生"的能力，对项目管理和对话历史追踪至关重要。

潜在缺点与局限性

外部依赖风险是首要局限。该技能仅为使用指南，实际的 memory_search 和 graphiti-search.sh 等工具需要单独部署和维护。用户需自行配置 Docker 环境、同步守护进程和嵌入模型（推荐 Gemini），技术门槛较高。

来源可信度约束。作为 T3 级社区项目（clawdbrunner/openclaw-graphiti-memory），相比顶级技术公司或官方基金会背书的项目，长期维护稳定性和安全审计深度存在不确定性。

学习曲线陡峭。用户不仅需要理解两种记忆系统的差异，还需掌握 Graphiti 的 group ID 概念（main-agent、user-personal 等）、命令行参数和同步机制，对非技术用户不够友好。

功能边界模糊风险。文档中明确强调该 skill 本身不执行任何操作，但用户可能误将其视为可直接调用的工具，导致预期落差。

适合的目标群体

OpenClaw 生态开发者是核心受众，特别是需要构建具备长期记忆能力的 AI 代理的工程师。适用于需要处理复杂项目历史、多轮对话上下文和时序数据的场景。

AI 产品经理和系统架构师可借助该框架设计记忆策略，平衡检索精度与系统复杂度。适合知识管理密集型应用，如智能客服、项目管理助手、个人知识库等。

需要时序推理能力的研发团队，如开发日志分析工具、项目复盘系统或对话历史分析平台的团队，能充分利用 Graphiti 的时间维度优势。

使用风险与注意事项

外部工具安全性是首要风险点。该 skill 指导使用的 graphiti-search.sh 和 graphiti-log.sh 脚本未包含在本体中，其实现质量、权限控制和数据处理逻辑需要用户自行审计。若外部工具存在命令注入或越权访问漏洞，可能危及系统安全。

隐私与数据泄露风险。虽然 skill 本身不收集数据，但指导使用的工具可能访问本地文件系统和内存数据。在生产环境部署前，需明确工具的访问边界，避免敏感信息（如密钥、个人身份信息）被不当记录到知识图谱中。

同步与一致性风险。双系统架构意味着数据需要在向量存储和图数据库间保持一致。若同步守护进程失败或配置错误，可能导致记忆碎片化，出现"部分记得、部分遗忘"的诡异现象。

维护成本累积。运行 Graphiti 需要持续的 Docker 资源、嵌入模型 API 调用成本和索引维护工作。对于轻量级应用，双系统的运维开销可能超过收益，建议评估单机向量搜索是否已能满足需求。