Penfield

🧠 智能体的持久记忆与知识图谱

专为OpenClaw智能体设计的持久化记忆系统,支持跨会话存储决策、偏好和上下文,通过BM25+向量+图混合搜索实现知识复利积累。

收藏
10.9k
安装
2.7k
版本
1.1.2
CLS 安全性认证2026-07-10
点击查看完整报告 >

使用说明

核心用法

Penfield是OpenClaw生态的持久化记忆基础设施,解决AI助手"每次对话从零开始"的核心痛点。它提供三层记忆能力:

基础存储层:通过penfield_store/penfield_recall实现结构化记忆存储与混合检索(BM25文本匹配+向量语义搜索+图关系遍历),支持按重要性分级(0.1-1.0)和11种记忆类型分类(fact/insight/correction/conversation等)。

知识图谱层penfield_connect建立24种关系类型(supersedes/supports/prerequisite_for等),将孤立记忆转化为可推理的知识网络。这是其差异化能力——不仅存储信息,更追踪认知演变。

上下文管理层penfield_save_context/penfield_restore_context支持会话断点续传,实现多智能体协作时的状态交接。

显著优点

1. 搜索架构先进:三层混合检索(BM25+vector+graph)可针对不同查询类型动态调权,精确匹配优于纯向量方案
2. 关系建模精细:24种语义关系覆盖知识演化全生命周期,从"更正旧认知"到"因果依赖"都有显式表达

3. 生态兼容性强:原生OpenClaw插件性能最优(4-5倍于MCP代理),同时提供MCP Server和HTTP API供Claude、Cursor、Gemini等工具接入

4. 记忆质量指南完善:文档详细指导如何撰写"可找回的记忆"(含上下文前缀、因果 rationale、具体细节),降低使用门槛

潜在局限

  • 供应商锁定风险:记忆数据托管于Penfield云服务(portal.penfield.app),自建部署选项未明确
  • 成本不透明:未披露存储/检索的定价模型,企业级合规(SOC2/GDPR)认证状态未说明
  • 扩展性约束:知识图谱规模增长后的查询性能衰减、多用户隔离机制文档缺失
  • MCP性能损耗:非原生集成需经MCP代理层,延迟显著增加

适合人群

  • 长期使用OpenClaw/Claude Code的专业开发者,需要跨项目保持上下文连续性
  • 研究团队构建领域知识库,依赖"假设-验证-修正"的认知追踪
  • 多智能体工作流设计者,需要会话状态持久化和handoff机制

常规风险

| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 数据隐私 | 记忆内容上传至第三方云服务 | 敏感信息脱敏,定期审计`penfield_list_contexts` |
| 记忆污染 | 低质量/过时记忆累积干扰召回 | 设置`importance_threshold`过滤,定期`penfield_reflect`清理 |
| 幻觉增强 | 错误记忆被重复检索强化 | 优先使用`correction`类型标记勘误,建立`supersedes`关系链 |
| 服务可用性 | 云服务商故障导致记忆不可访问 | 关键决策本地备份,避免硬依赖 |

技术定位

Penfield填补了OpenClaw生态的"长期记忆"空白,与LangMem等方案相比更强调关系型知识演化而非简单键值存储。其架构设计体现认知科学原理——记忆的价值在于连接,而非孤立存在。

安全解读

核心用法

Penfield 是一套面向 AI Agent 的持久化记忆系统,通过 OpenClaw 插件或 MCP 协议与任意 AI 工具集成。其核心能力包括:

记忆存储与检索penfield_store / penfield_recall 支持结构化存储用户偏好、项目决策、调查结论等,采用 BM25 + 向量 + 知识图三重混合搜索,可按查询类型动态调整权重(如精确匹配调高 BM25,概念搜索调高向量权重)。

知识图谱构建penfield_connect / penfield_explore 支持 24 种关系类型(如 supersedes、supports、causes、depends_on),将孤立记忆连接为可推理的知识网络,实现"理解随时间累积"。

会话续接penfield_save_context / penfield_restore_context 实现跨 Agent、跨会话的状态保存与恢复,支持团队协作场景。

重要性分级:0.1-1.0 的显式重要性评分机制,配合记忆类型标签(fact/insight/correction/strategy 等),避免记忆膨胀。

显著优点

1. 搜索架构先进:三引擎混合召回相比纯向量方案显著提升精确匹配场景的准确率,支持权重动态调优
2. 关系建模丰富:24 种语义关系覆盖知识演化、因果推断、层级结构等复杂场景

3. 生态兼容性强:原生 OpenClaw 插件最快,同时支持 Claude MCP、Gemini CLI、Cursor 等任何 MCP 客户端

4. 质量引导机制:文档详细说明"好记忆 vs 坏记忆"的写法,降低用户使用门槛

5. 安全透明:纯文档型 Skill,无可执行代码,T2 可信组织来源,S+ 安全评级

潜在缺点

1. 外部服务依赖:核心功能需连接 penfield.app 后端服务,存在网络延迟和可用性风险
2. 学习成本较高:24 种关系类型、记忆类型体系、权重调优等概念对新手不够友好

3. 隐私边界模糊:虽然 Skill 本身不收集数据,但记忆内容上传至第三方服务,敏感数据需额外评估

4. 成本不透明:文档未说明存储量、调用频率的定价模式

适合人群

  • 需要长期陪伴型 AI 助手的个人用户(记忆偏好、项目背景)
  • 多 Agent 协作场景下的团队(会话 handoff、知识共享)
  • 复杂调查/研究任务(需要追溯假设演变、证据链管理)

常规风险

  • 供应商锁定:记忆数据存储于 Penfield 服务,迁移路径未明确
  • 召回失败:权重配置不当或标签不一致可能导致关键记忆漏召回
  • 关系维护负担:不主动建立连接的记忆将退化为孤立笔记,价值大减

Penfield 内容

手动下载zip · 5.0 kB
SKILL.mdtext/markdown
请选择文件