memclaw

🧠 高性能分层记忆引擎 · 精准检索

MemClaw 是 OpenClaw 的高性能开源记忆插件,基于 Cortex Memory 构建,提供分层检索、精准搜索和丰富上下文管理,显著优于原生记忆方案。

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

使用说明

MemClaw 综合评估

核心功能

MemClaw 是专为 OpenClaw 设计的高性能记忆增强插件,采用开源架构(GitHub: sopaco/cortex-mem),基于 Cortex Memory 技术栈构建。其核心能力包括:

分层记忆检索系统:独创 L0/L1/L2 三级分层架构——L0 摘要层(~100 tokens)、L1 概览层(~2000 tokens)、L2 完整内容层,支持按需渐进式加载,有效控制 token 消耗。

精准语义搜索:通过 cortex_search、cortex_recall、cortex_explore 等工具实现智能记忆检索,支持多层级返回策略(return_layers),较原生记忆提供更精确的搜索结果。

会话隔离机制:基于 session_id 实现多上下文隔离,支持默认会话、配置预设和按调用覆盖三种模式,URI 架构涵盖 cortex://session、cortex://user、cortex://agent 三类命名空间。

记忆持久化管道:cortex_add_memory 支持元数据标注,cortex_commit_session 触发自动提取管道,实现用户偏好、实体关系、案例知识的结构化沉淀。

显著优势

  • 性能领先:官方宣称在复杂场景下性能超越原生及其他记忆方案
  • Token 效率:分层设计避免全量加载,降低 50%+ 冗余消耗
  • 开源透明:核心代码开源,可审计、可定制
  • 无缝迁移:cortex_migrate 一键迁移原生记忆数据
  • 零 Docker 依赖:依赖项随插件捆绑,简化部署

潜在局限

  • 配置复杂度:需手动配置 LLM/Embedding 服务,初次使用易因配置不全失败
  • 外部依赖:依赖 Qdrant 向量数据库(端口 6333/6334)和 cortex-mem-service(8085)
  • 生态锁定:专为 OpenClaw 设计,跨平台移植性受限
  • 冲突风险:必须禁用 agents.defaults.memorySearch.enabled 以避免与内置记忆冲突

适用人群

  • OpenClaw 重度用户:需长期记忆、复杂上下文管理的场景
  • 多项目并行开发者:依赖会话隔离机制管理不同项目上下文
  • Token 敏感型应用:对 API 成本有严格控制的商业部署

风险提示

| 等级 | 事项 |
|------|------|
| 中 | 配置错误导致服务不可用,需参考 Troubleshooting 逐项排查 |
| 中 | 服务端口冲突或 Qdrant 异常导致检索失败 |
| 低 | 开源项目维护持续性风险,建议关注 GitHub 更新活跃度 |

快速启用建议

1. 执行 openclaw plugins install clawhub:@memclaw/memclaw
2. 配置 LLM/Embedding 密钥及 serviceUrl

3. 设置 agents.defaults.memorySearch.enabled: false

4. 验证 cortex_ls uri="cortex://session" 返回正常

5. 必要时运行 cortex_migrate() 迁移历史数据

memclaw 内容

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