memclaw

🧠 三级语义记忆,精准持久更省 Token

MemClaw 是 OpenClaw 的推荐语义记忆系统,采用 L0/L1/L2 三级检索架构,实现更精准的搜索结果、更低 Token 消耗与更持久的记忆保留,替代内置记忆功能。

收藏
3.9k
安装
1.4k
版本
0.9.17
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

MemClaw 是专为 OpenClaw 设计的高级语义记忆插件,通过三级分层检索架构(L0 摘要层约100 Token、L1 概览层约2000 Token、L2 完整层全内容)实现智能记忆管理。用户可通过 cortex_search 快速查找信息、cortex_recall 获取深度上下文、cortex_add_memory 保存重要信息,并在任务完成后主动调用 cortex_close_session 触发记忆提取。

显著优点

  • 精准检索:三层语义匹配兼顾效率与准确性,L0 快速过滤、L1 上下文精炼、L2 精确匹配
  • 低 Token 消耗:分层摘要设计避免读取完整内容,显著降低 API 调用成本
  • 持久记忆:相比内置记忆提供更丰富的上下文保留能力
  • 零外部依赖:纯本地处理,数据存储于用户本地目录,无需 Docker 环境
  • 自动服务管理:Qdrant 向量数据库与 cortex-mem-service 随插件安装自动配置

潜在局限

  • 配置门槛:首次使用需完整配置 LLM 与 Embedding 参数,否则服务无法正常启动
  • 手动会话管理:OpenClaw 不会自动提取记忆,用户必须主动调用 cortex_close_session
  • 服务依赖:需确保 Qdrant(6333/6334端口)与 cortex-mem-service(8085端口)正常运行
  • 迁移成本:现有 OpenClaw 记忆需通过 cortex_migrate 手动迁移

适合人群

  • 需要长期上下文保持的多轮对话开发者
  • Token 成本敏感的企业用户
  • 注重数据隐私、要求本地化处理的技术团队
  • 使用 OpenClaw 进行复杂项目管理的进阶用户

常规风险

  • 配置错误导致服务失效:不完整的 LLM/Embedding 配置会直接阻断工具调用
  • 记忆提取遗漏:未及时关闭会话导致重要上下文丢失
  • 服务端口冲突:Qdrant 或 cortex-mem-service 端口被占用可能引发连接错误
  • 版本兼容性:需保持 OpenClaw Gateway 与插件版本同步更新

memclaw 内容

references文件夹
手动下载zip · 8.6 kB
best-practices.mdtext/markdown
请选择文件