---
title: "养龙虾5天血泪史：我的AI Agent为什么总失忆？OpenClaw 记忆调试全记录"
type: source
tags: [AI, Agent, OpenClaw, 记忆管理, Context-Window]
date: 2026-04-02
source_file: raw/微信公众号/养龙虾5天血泪史：我的AI Agent为什么总失忆？OpenClaw 记忆调试全记录.md
---

## Summary
- 核心主题：OpenClaw Agent记忆问题的系统化调试经历
- 问题域：长对话后上下文丢失、搜索返回垃圾结果、Agent找到信息但不使用、模型切换失忆
- 方法/机制：5天逐日排查，最终建立完整的记忆管理规范
- 结论/价值：记忆系统需要写入纪律、检索测试、交接协议；压缩不是敌人，未写入的上下文才是

## Key Claims
- 自动加载的文件只有7个：AGENTS.md/SOUL.md/TOOLS.md/IDENTITY.md/USER.md/HEARTBEAT.md/MEMORY.md
- 启动序列必须放在AGENTS.md顶部，否则Agent不会读取
- 写入纪律比读取纪律更重要：临时上下文必须写盘才能在压缩中存活
- 混合搜索（BM25+向量+重排序）优于纯语义搜索
- 交接协议解决模型切换时上下文丢失问题

## Key Quotes
> "真正的修复不是添加更多文件。而是移除那些什么都不做的文件。" — 比利哥

> "压缩不是敌人。未写入的上下文才是。" — 比利哥

> "你花一个小时配置每日定时任务，切换模型后，Agent表现得像我们从未交谈过。" — 比利哥

## Key Concepts
- [[Context-Compaction]]：对话压缩机制，摘要抓住要点但丢失细节
- [[Memory-Flush]]：压缩前将重要上下文写入磁盘
- [[混合搜索]]：BM25（关键词）+ 向量（语义）+ 重排序
- [[交接协议]]：模型切换前将当前上下文写入每日日志
- [[写入纪律]]：任务结果必须记录到磁盘
- [[检索测试]]：植入标记并跨会话验证Agent能找到

## Key Entities
- [[OpenClaw]]：AI Agent操作系统
- [[星辉]]（xinghui）：OpenClaw Agent，本文主要调试对象
- [[QMD]]：本地Markdown搜索引擎，支持混合搜索
- [[MiniMax-M2.7]]：200K context主力模型
- [[比利哥]]：作者

## Connections
- [[yang-xia-ri-ji-2]] ← 深化 ← [[yang-long-xia-5-tian]]（本文是yang-xia-ri-ji-2记忆思想的详细实践版）
- [[yang-xia-ri-ji-3]] ← 技术支撑 ← [[yang-long-xia-5-tian]]（Obsidian是记忆的物理载体）
- [[yang-xia-ri-ji-4]] ← 问题关联 ← [[yang-long-xia-5-tian]]（Context Limit与记忆管理密切相关）

## Contradictions
- 与"Agent会自动记住重要信息"假设冲突：需要主动设计写入纪律和检索触发
