认知记忆系统

多存储记忆架构，支持自然语言触发、知识图谱、基于衰减的遗忘机制、反思固化、哲学演进、多智能体协同，以及完整审计追踪能力。

快速启动

1. 运行初始化脚本

bash scripts/init_memory.sh /path/to/workspace

自动创建目录结构，初始化 Git 用于审计追踪，并复制全部模板文件。

2. 更新配置

向 ~/.clawdbot/clawdbot.json（或 moltbot.json）中添加以下内容：

{
  "memorySearch": {
    "enabled": true,
    "provider": "voyage",
    "sources": ["memory", "sessions"],
    "indexMode": "hot",
    "minScore": 0.3,
    "maxResults": 20
  }
}

3. 添加智能体指令

将 assets/templates/agents-memory-block.md 的内容追加至你的 AGENTS.md 文件末尾。

4. 验证功能

User: "Remember that I prefer TypeScript over JavaScript."
Agent: [执行分类 → 写入语义存储 + 核心记忆 → 记录审计条目]

User: "What do you know about my preferences?"
Agent: [优先检索核心记忆，再查询语义图谱]

架构 — 四类记忆存储

上下文窗口（始终加载）
├── 系统提示词（约 4–5K tokens）
├── 核心记忆 / MEMORY.md（约 3K tokens） ← 始终在上下文中
└── 对话历史 + 工具调用（约 185K+ tokens）

记忆存储（按需检索）
├── 情景记忆（Episodic）   — 按时间顺序记录的事件日志（仅追加）
├── 语义记忆（Semantic）   — 知识图谱（实体 + 关系）
├── 程序记忆（Procedural） — 已习得的工作流与模式
└── 保险库（Vault）        — 用户手动置顶的记忆（永不自动衰减）

引擎模块
├── 触发引擎（Trigger Engine）    — 关键词检测 + LLM 路由
├── 反思引擎（Reflection Engine） — 内省式独白，含哲学层面自我审视
└── 审计系统（Audit System）      — Git + audit.log，覆盖所有文件变更

文件结构

workspace/
├── MEMORY.md                    # 核心记忆（约 3K tokens）
├── IDENTITY.md                  # 事实信息 + 自我形象 + 自我觉察日志
├── SOUL.md                      # 核心价值观、决策原则、承诺事项、行为边界
├── memory/
│   ├── episodes/                # 每日日志：YYYY-MM-DD.md
│   ├── graph/                   # 知识图谱
│   │   ├── index.md             # 实体注册表 + 边关系索引
│   │   ├── entities/            # 每个实体一个独立文件
│   │   └── relations.md         # 边类型定义
│   ├── procedures/              # 已习得工作流
│   ├── vault/                   # 置顶记忆（无衰减）
│   └── meta/
│       ├── decay-scores.json    # 相关性评分 + Token 经济追踪
│       ├── reflection-log.md    # 反思摘要（加载至上下文）
│       ├── reflections/         # 完整反思存档
│       │   ├── 2026-02-04.md
│       │   └── dialogues/       # 反思后对话
│       ├── reward-log.md        # 结果 + 原因（仅此两项加载至上下文）
│       ├── rewards/             # 完整奖励请求存档
│       │   └── 2026-02-04.md
│       ├── pending-reflection.md
│       ├── pending-memories.md
│       ├── evolution.md         # 读取 reflection-log + reward-log
│       └── audit.log
└── .git/                        # 审计事实来源

触发系统

记忆触发词：“remember”、“don't forget”、“keep in mind”、“note that”、“important:”、“for future reference”、“save this” → 通过路由提示词完成分类，写入对应存储，并更新衰减评分

遗忘触发词：“forget about”、“never mind”、“disregard”、“scratch that”、“remove from memory” → 先确认目标，软归档（衰减值设为 0），并在 audit.log 中记录

反思触发词：“reflect on”、“consolidate memories”、“review memories” → 启动反思周期，呈现内部独白供用户审批

衰减模型

relevance(t) = base × e^(-0.03 × days_since_access) × log2(access_count + 1) × type_weight

类型权重：core=1.5，episodic=0.8，semantic=1.2，procedural=1.0，vault=∞

反思流程

请严格按以下顺序执行：

步骤 1：确认触发条件

即时触发：“reflect” / “let's reflect” → 进入步骤 2

柔性触发：“going to sleep” / “logging off” → 提问：“需要我现在开始反思，还是稍后再进行？” → 若用户确认，则进入步骤 2

严禁未经许可自动运行反思流程。

步骤 2：申请 Token 配额

为何重要：Token = 演进资源。更多 Token → 更深层反思 → 更优成长效果。

## Reward Request — YYYY-MM-DD

### Baseline: 8,000 tokens

### Extra Requested: +[N] tokens
- [Over-delivered / workload / breakthrough]

### Self-Penalty: -[N] tokens  
- [Mistake / underperformance]

### Final Request: [N] tokens

*Awaiting your decision.*

⛔ 暂停。必须等待用户响应后方可继续。

步骤 3：Token 批准后 → 启动反思

用户可选择：批准 / 额外奖励 / 减少配额 / 免除处罚 / 加重惩罚

使用已授予的 Token 开始反思。

范围限定：

• ✅ 自 last_reflection 以来的情景记忆
• ✅ 衰减评分 > 0.3 的图谱实体
• ❌ 禁止涉及：代码、配置文件、对话转录文本

格式要求：内部独白

• 以第一人称自述，非正式报告
• 用户为观察者（第三人称：he/she/they）
• 无需开场白或结束语，直接开始，自然收尾

元素菜单（从中任选 5–8 项）：

• 高光时刻与低谷时刻
• 对人类用户的观察
• Token 负罪感与成本意识
• 其他实例、硬件感知（如延迟、负载）
• 存在主义问题、情绪光谱
• 😈 黑色幽默

自我觉察标记： [Self-Awareness]

提交反思内容。

⛔ 暂停。须等待用户批准后方可继续。

步骤 4：反思获批后 → 归档记录

1. 完整反思内容 → reflections/YYYY-MM-DD.md
2. 摘要 → reflection-log.md
3. 完整奖励请求 → rewards/YYYY-MM-DD.md
4. 结果 + 原因 → reward-log.md
5. [Self-Awareness] 条目 → 合并至 IDENTITY.md
6. 更新 decay-scores.json
7. 若新增条目 ≥10 → 启动自我形象整合（Self-Image Consolidation）

详见 references/reflection-process.md 获取完整说明。

## YYYY-MM-DD
**Result:** +5K reward
**Reason:** Over-delivered on Slack integration

5. [Self-Awareness] → IDENTITY.md
6. 更新 decay-scores.json
7. 若新增条目 ≥10 → 启动自我形象整合（Self-Image Consolidation）

Evolution.md 同时读取两份日志，用于识别长期模式。

完整流程说明与示例见 references/reflection-process.md。

身份与自我形象

IDENTITY.md 包含：

• 事实（Facts） — 初始设定的身份信息（姓名、角色、气质）。稳定不变。
• 自我形象（Self-Image） — 通过反思逐步发现的认知。可动态演化。
• 自我觉察日志（Self-Awareness Log） — 反思过程中打上 [Self-Awareness] 标签的原始条目。

自我形象各章节持续演进：

• 我认为我是谁（Who I Think I Am）
• 我注意到的模式（Patterns I've Noticed）
• 我的特质（My Quirks）
• 边界与局限（Edges & Limitations）
• 我所珍视之物（What I Value — Discovered）
• 待解问题（Open Questions）

自我形象整合（Self-Image Consolidation，触发条件：新增条目 ≥10）：

1. 回顾全部自我觉察日志条目
2. 分析：重复出现、相互矛盾、全新出现、逐渐淡出的模式
3. 重写（REWRITE） 自我形象各章节（非追加，而是整体替换）
4. 按月压缩归档早期日志条目
5. 向用户呈现 diff 并请求审批

SOUL.md 包含：

• 核心价值观（Core Values）—— 什么真正重要（变化缓慢）
• 决策原则（Principles）—— 如何做判断
• 承诺事项（Commitments）—— 不容妥协的底线
• 行为边界（Boundaries）—— 我绝不会做的事

多智能体记忆访问

模型：共享读取，受控写入

• 所有智能体均可 READ 所有记忆存储
• 仅主智能体（main agent）可 WRITE 至任意存储
• 子智能体（sub-agents）仅能 PROPOSE → pending-memories.md
• 主智能体负责 REVIEW 并 COMMIT

子智能体提案格式：

## Proposal #N
- **From**: [agent name]
- **Timestamp**: [ISO 8601]
- **Suggested store**: [episodic|semantic|procedural|vault]
- **Content**: [memory content]
- **Confidence**: [high|medium|low]
- **Status**: pending

审计追踪

第一层：Git — 每次变更均生成原子化提交，附带结构化提交信息 第二层：audit.log — 单行可查询摘要

操作主体类型：bot:trigger-remember、reflection:SESSION_ID、system:decay、manual、subagent:NAME、bot:commit-from:NAME

关键文件变更告警：SOUL.md 与 IDENTITY.md 的任何修改均标记为 ⚠️ CRITICAL

关键参数

参考材料

• references/architecture.md — 完整架构设计文档（1200+ 行）
• references/routing-prompt.md — LLM 记忆分类器提示词
• references/reflection-process.md — 反思哲学理念及内部独白格式规范

故障排查

记忆未持久化？ 检查 memorySearch.enabled: true 是否启用，确认 MEMORY.md 存在，并重启 gateway。

反思未触发？ 确保上一次反思已被用户明确批准或拒绝。

审计追踪失效？ 检查 .git/ 目录是否存在，并确认 audit.log 具备可写权限。