核心用法
maasv Memory 是一个面向 OpenClaw Agent 的认知层记忆后端,替代默认内存系统。它通过 @maasv/openclaw-memory 插件与本地运行的 maasv 服务器协同工作,为 Agent 提供结构化、可检索的长期记忆能力。
安装配置需三步:安装 Python 依赖并启动 maasv-server(默认端口 18790),安装 npm 插件,最后在 openclaw.json 中激活并配置自动召回(autoRecall)、自动捕获(autoCapture)和知识图谱(enableGraph)等开关。
提供五大核心功能:
- memory_search:语义+关键词+知识图谱三重信号检索
- memory_store:去重感知的记忆存储
- memory_forget:永久删除特定记忆
- memory_graph:实体搜索、画像与关系图谱
- memory_wisdom:推理日志、结果记录与历史决策检索
自动召回会在每轮对话前注入相关记忆;自动捕获在会话结束后提取实体信息。
显著优点
1. 多维度检索:三信号融合(语义向量、关键词匹配、图结构)显著提升召回率和准确性
2. 认知架构完整:实体提取、时序版本控制、经验学习闭环,超越简单向量存储
3. 数据主权本地:SQLite 本地存储,无云端依赖,隐私可控
4. OpenClaw 原生集成:插件化设计,配置即插即用
5. 可解释性强:知识图谱使记忆关联可视化,便于调试 Agent 行为
潜在局限
1. 依赖链复杂:需同时维护 Python 服务端和 Node.js 插件环境
2. 运维负担:maasv-server 需独立运行,崩溃或网络问题会中断记忆服务
3. 无内置高可用:单机 SQLite 设计,无复制或分布式能力
4. 学习曲线陡峭:三信号调参、图谱构建、版本控制等概念对用户有一定要求
适合人群
- 需要 Agent 具备长期上下文记忆能力的开发者
- 对数据隐私敏感、要求本地部署的企业用户
- 研究认知架构、探索 Agent 经验学习机制的 AI 工程师
常规风险
- 服务可用性:maasv-server 进程异常将导致记忆功能失效,建议配置进程守护
- 数据备份:SQLite 文件需定期备份,防止单点故障丢失
- 版本兼容性:Python 服务端与 npm 插件版本需保持同步
- 资源占用:知识图谱和向量索引随数据增长可能占用显著磁盘/内存