三重记忆系统

一个综合性的记忆架构，结合了三个互补的系统，以实现跨会话的最大化上下文保留。

架构概览

User Message
     ↓
[LanceDB auto-recall] → injects relevant conversation memories
     ↓
Agent responds (using all 3 systems)
     ↓
[LanceDB auto-capture] → stores preferences/decisions automatically
     ↓
[Git-Notes] → structured decisions with entity extraction
     ↓
[File updates] → persistent workspace docs

三大系统

1. LanceDB（对话记忆）

• 自动召回：每次响应前注入相关记忆
• 自动捕获：自动存储偏好/决定/事实
• 工具： memory_recall,memory_store,memory_forget
• 触发词："记住"、"偏好"、"我的X是"、"我喜欢/讨厌/想要"

2. Git-Notes 记忆（结构化，本地）

• 分支感知：每个git分支的记忆相互隔离
• 实体提取：自动提取主题、名称、概念
• 重要性级别：严重、高、普通、低
• 无外部 API 调用

3. 文件搜索（工作区）

• 搜索范围：MEMORY.md、memory/*.md、任意工作区文件
• 脚本： scripts/file-search.sh

设置

启用 LanceDB 插件

{
  "plugins": {
    "slots": { "memory": "memory-lancedb" },
    "entries": {
      "memory-lancedb": {
        "enabled": true,
        "config": {
          "embedding": { "apiKey": "${OPENAI_API_KEY}", "model": "text-embedding-3-small" },
          "autoRecall": true,
          "autoCapture": true
        }
      }
    }
  }
}

启用自动内存刷新（预压缩前）

添加到您的 Clawdbot 配置中，以便在压缩前自动保存上下文：

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard",
        "memoryFlush": {
          "enabled": true,
          "softThresholdTokens": 8000,
          "systemPrompt": "Session nearing compaction. Preserve context using triple memory system (git-notes, LanceDB, files).",
          "prompt": "Context is at ~80%. Write session summary to memory/YYYY-MM-DD.md, update MEMORY.md if needed, store key facts to git-notes. Reply NO_REPLY when done."
        }
      }
    }
  }
}

当上下文达到约 80% 时，此设置会触发自动内存转储，从而在信息因压缩而丢失之前进行保存。

安装 Git-Notes 内存

clawdhub install git-notes-memory

创建文件搜索脚本

复制scripts/file-search.sh到您的工作区。

用法

会话启动（始终执行）

python3 skills/git-notes-memory/memory.py -p $WORKSPACE sync --start

存储重要决策

python3 skills/git-notes-memory/memory.py -p $WORKSPACE remember \
  '{"decision": "Use PostgreSQL", "reason": "Team expertise"}' \
  -t architecture,database -i h

搜索工作区文件

./scripts/file-search.sh "database config" 5

对话记忆（自动）

LanceDB会自动处理。手动工具：

• memory_recall "查询内容"- 搜索对话记忆
• memory_store "文本内容"- 手动存储内容
• memory_forget- 删除记忆（GDPR合规）

重要性级别

各系统使用时机

文件结构

workspace/
├── MEMORY.md              # Long-term curated memory
├── memory/
│   ├── active-context.md  # Current session state
│   └── YYYY-MM-DD.md      # Daily logs
├── scripts/
│   └── file-search.sh     # Workspace search
└── skills/
    └── git-notes-memory/  # Structured memory

静默操作

切勿向用户宣布内存操作。直接执行：

• ❌ “我会记住这个”
• ❌ “正在保存到内存”
• ✅ （静默存储并继续）