AI 代理的长期记忆与执行纪律系统

基于 OpenClaw 生态的 AI 代理长期记忆与性能优化系统，通过事实提取、知识图谱构建和生命周期钩子实现跨会话一致性，提升代理执行质量与上下文连续性。

基本信息

• 技能名称?memory-pipeline
• 中文名称?AI 代理的长期记忆与执行纪律系统
• 作者?joe-rlo
• 分类?AI 增强
• 版本?0.1.0
• 标签?automation, productivity, development-engineering, data-analytics, backend, ai-ml

使用方法

使用说明
核心用法
memory-pipeline 是一套双轨制 AI 代理增强系统，包含 Memory Pipeline（Python） 和 Performance Routine（TypeScript） 两大子系统。
Memory Pipeline 在会话间隙运行三阶段流程：

1. Extract — 使用 LLM 从每日笔记和会话记录中提取结构化事实（决策、偏好、学习、承诺）
2. Link — 构建嵌入向量知识图谱，建立事实间的双向链接，检测矛盾并标记过时信息
3. Briefing — 生成紧凑的 BRIEFING.md，包含个性提醒、活跃项目、近期决策等上下文
   Performance Routine 在会话内通过四个生命周期钩子执行：
   before_agent_start ：注入预组装简报包（检查清单+记忆+约束）
   before_tool_call ：执行工具策略（拒绝列表、参数规范化）
   tool_result_persist ：头尾压缩大型工具结果，防止上下文膨胀
   agent_end ：撰写行动后审查，为下次运行积累记忆
   系统支持 OpenAI、Anthropic、Gemini 三家 API，自动检测工作区，可集成到 HEARTBEAT.md 实现自动化。
   显著优点
4. 跨会话连续性 ：解决 LLM 无状态的核心痛点，代理能"记住"用户偏好和项目历史
5. 执行纪律性 ：借鉴运动心理学"分离思考与执行"原则，避免中运行时的指令冲突
6. 上下文效率 ：智能压缩（头60%+尾30%）和 2000 字符简报限制，适配长上下文模型
7. 知识可解释性 ：生成人类可读的知识摘要和矛盾检测报告，便于人工审计
8. 零侵入集成 ：通过 OpenClaw 钩子系统工作，无需修改代理核心逻辑
   潜在缺点与局限性
9. 外部依赖重 ：必须配置至少一家 LLM API 密钥，离线环境无法运行
10. 延迟成本 ：完整管道运行需多次 LLM 调用，可能增加会话启动时间
11. 嵌入质量敏感 ：无 OpenAI 密钥时退化为关键词匹配，链接准确性下降
12. 版本较新 ：v0.1.0 尚未经过大规模生产验证，API 可能变动
13. OpenClaw 绑定 ：Performance Routine 依赖尚未完全发布的 OpenClaw 上下文加载功能
    适合的目标群体
    长期项目型代理用户 ：需要代理持续数周/数月处理复杂任务的开发者
    多会话工作流团队 ：多人共享代理上下文的企业场景
    AI 代理框架开发者 ：研究记忆架构和工具执行纪律的研究者
    高可靠性要求场景 ：金融、医疗等需要决策可追溯性的领域
    使用风险
    API 成本累积 ：每日自动运行可能产生持续的 Token 消耗
    记忆漂移 ：长期运行后知识图谱可能积累矛盾，需定期人工审查
    隐私边界模糊 ：会话记录自动上传至第三方 LLM API，敏感数据需预处理
    文件系统膨胀 ： extracted.jsonl 为追加写入，长期运行需归档策略