dztabel-happy/openclaw-memory-fusion

Registry 信息

项目简介

OpenClaw 融合记忆方案是一个针对 Claude Skill 的零插件、零侵入记忆解决方案，实现了基于 cron 的三层记忆流水线：自动提取、蒸馏和巩固。它确保跨会话的持久、永不遗忘的上下文，无需修改任何现有代码。

要点

• 三层 cron 流水线：提取、蒸馏、巩固
• 零插件、零侵入——无需修改代码
• 跨 Claude Skill 会话的自动记忆持久化
• 通过定时记忆刷新实现永不遗忘的上下文
• 轻量级 Python 实现，易于集成

使用场景

• 在 Claude Skill 中维护长期对话上下文
• 为 AI 助手自动化记忆管理
• 无需外部插件构建持久知识库
• 增强 Claude Skill 的跨会话回忆能力
• 为开发者和高级用户简化记忆工作流

README 摘要

# OpenClaw Memory Fusion > 一套基于 OpenClaw 原生能力的「永不失忆」融合记忆方案：**不漏、去噪、防套娃、可运维、可升级**。 这套方案的核心理念是： - **事实源**来自本地 session JSONL（而不是 `sessions_list/sessions_history`） - **提炼**来自 LLM（但只喂干净、可控的高信号输入） - **落盘**来自 Markdown（可审计、可迁移、可被 QMD 搜索） 说明： - OpenClaw 近版本已经提供 **pre-compaction memory flush** 与可选的 **`session-memory` hook** - 本仓库的定位不是替代官方 memory，而是在其上补强 **deterministic 提取**、**isolated cron 可见性** 与 **Telegram 可观测运维** ## 为什么需要这个？ OpenClaw 官方现在已经提供默认的 memory flush，并且可以用 hook 在 `/new` 前做补充快照；这些能力很好，也建议保留。 本方案聚焦的是另一层问题： - `--session isolated` 的后台任务仍可能遇到 session 可见性与上下文膨胀问题 - 你可能希望**固定时刻**运行三段记忆整理，而不是把它们并入 heartbeat - 你可能希望**每次任务结果都投递到 Telegram 群/话题**，形成可巡检的运营面板 因此这里保留 **三层 cron**，但尽量与官方 memory / QMD / config hot reload 的当前做法对齐。 ## 参考与融合来源 | 来源 | 我们采纳/改良的点 | |---|---| | Calicastle 三层架构 | Hourly/Daily/Weekly 分层分频 | | Linux.do 终极记忆系统 | 去噪、剪枝、MEMORY.md 软上限思路 | | OpenClaw 官方 | QMD 后端（BM25+向量+reranking）与 sessions transcript 索引 | 链接（仅供阅读，不影响运行）： - Calicastle: https://x.com/calicastle/status/2021229394724102229 - Linux.do: https://linux.do/t/topic/1621623 - OpenClaw Memory/QMD: https://docs.openclaw.ai/concepts/memory ## 你会得到什么（优势） ### 1) isolated cron 下也不会“看不到主会话” 很多实现依赖 `sessions_list(activeMinutes=...)`，但在 `--session isolated` 的 cron 中，工具可见性可能被限制为“当前 session tree”，造成漏读。 当前推荐同时给 cron job 开启 `--light-context`，避免后台任务把整套 bootstrap context 带满。 本方案把 **`~/.openclaw/agents/<agent>/sessions/`** 作为唯一事实来源： - `*.jsonl`（活跃会话持续 append） - `*.jsonl.reset.*`（`/new` 归档） ### 2) 增量游标按 byte offset：不丢不重 - 每个文件维护一个 **byte offset cursor**（写在 `memory/_state/*.json`） - 只推进到最后一个完整换行（容忍半行 JSON） - 同一会话文件后续 append 不会漏 - 断网/关机漏跑是可恢复的：下一次会把 gap 补齐 ### 3) 防套娃（递归污染）是“硬约束”而不是靠运气 三道保险： 1. cron prompt 第一行统一以 `[cron:` 开头（例如 `[cron:memory-hourly] ...`） 2. 扫描器忽略 cron 会话（heuristic：该 session 的首条 user 消息以

话题

暂无话题