어제 뭐 했지? — 기억 체계
📋 금쪽같은 내 봇 한마리 키우기 — Ep 04 봇이 어제 한 일을 기억 못 하는 이유, 그리고 기억해주게 만드는 법.
🙀 어제 쓴 거 기억 못 해?
며칠 같이 일하다 보면 꼭 마주치는 순간이 있다.
“어제 그 작업 어떻게 됐어?” “어떤 작업 말씀하시는 건가요?”
…충격이다. 어제 분명히 같이 했는데, 봇은 처음 듣는다는 표정. 사람이라면 치매인가? 싶을 텐데, 봇은 그게 아니다. 봇은 원래 못 기억한다.
이걸 이해하는 게 이번 편의 시작이다.
💭 세션이라는 채팅방
오픈클로에서 봇은 매번 새로운 세션에서 깨어난다. 세션은 채팅방 하나라고 보면 된다.
어제의 세션 (채팅방 #1) ← 닫히면 안의 대화는 휘발됨
└── 오늘의 세션 (채팅방 #2) ← 어제 방의 기억 없이 깨어남비유하면 — 매일 출근하는데 어제 일한 게 기억 안 나는 새 직원이다. 어제 회의록을 누가 적어두지 않으면, 영영 모른다.
💡 교훈: 봇이 잊는 건 결함이 아니라 구조다. 파일에 안 쓰면 못 기억한다.
🧠 기억 3층 구조
오픈클로는 이 문제를 3층 기억으로 푼다. 각 층마다 역할이 다르다.
| 층 | 파일 | 비유 | 역할 |
|---|---|---|---|
| 1층 | MEMORY.md | 화이트보드 | 지금 뭐가 돌아가고 있나 (현재 상태) |
| 2층 | memory/YYYY-MM-DD.md | 일기장 | 오늘 무슨 일이 있었나 (날것 로그) |
| 3층 | learnings/*.md | 오답노트 | 한 번 당한 삽질, 다음엔 안 당하기 |
핵심은 자동 주입 vs 수동 읽기 차이다.
| 자동 주입 (자동) | 수동 읽기 (직접) | |
|---|---|---|
| 대상 | 워크스페이스 루트 .md | memory/, learnings/ 폴더 안 |
| 언제 | 매 세션 시작 시 | 봇이 read 도구로 읽을 때 |
| 예시 | MEMORY.md, SOUL.md, USER.md | memory/2026-04-16.md |
→ MEMORY.md는 자동으로 읽지만, 일별 로그는 봇한테 오늘이랑 어제 거 읽어라고 시켜야 한다.
📝 1층 — MEMORY.md (화이트보드)
지금 뭐가 돌아가고 있는지를 짧게 정리해두는 곳. 현재 상태 스냅샷이지 일기가 아니다.
# MEMORY.md
## 활성 프로젝트
- 1단계 자료집 작성 중 (~이번 주)
- 외부 발송 스킬 v2 다듬는 중
## 현재 블로커
- 외부 서비스 API 토큰 발급 대기
## 크론
- 09:00 아침 브리핑
- 23:00 밤 자율작업이게 다다. 길어지면 의미 없다. 30~50줄 안에서 유지하고, 끝난 프로젝트는 바로 빼버린다.
📓 2층 — memory/YYYY-MM-DD.md (일기장)
오늘 한 일을 날짜별로 쌓는 곳. 날것 그대로 기록한다.
~/.openclaw/workspace-{봇ID}/
└── memory/
├── 2026-04-14.md
├── 2026-04-15.md
└── 2026-04-16.md ← 오늘매 세션 시작 시 봇한테 오늘이랑 어제 memory 읽어라고 시키면, 어제 맥락을 다 갖고 시작한다. 이게 어제 쓴 거 기억 못 해? 문제의 해결책이다.
💡 교훈: h2 제목을 구체적으로 적을 것.
## Airtable❌ →## Airtable 마케팅DB AI토크 날짜 검증✅. 제목만 보고 무슨 작업인지 알 수 있어야 한다.
📚 3층 — learnings/ (오답노트)
같은 삽질 두 번 하지 않으려고 만드는 폴더. 도구별·주제별로 파일 나눈다.
learnings/
├── airtable.md ← Airtable 삽질·해결
├── playwright.md ← Playwright 함정
├── slack-mrkdwn.md ← Slack 마크다운 차이
└── general.md ← 잡다한 교훈매번 다 읽지 않고, 비슷한 작업 시작할 때 봇이 learnings/airtable.md 한번 보고 갈게라고 한다. 이게 봇이 점점 똑똑해지는 구조다.
🔄 매 세션 시작 루틴
기억 체계가 굴러가려면 봇한테 시작 루틴을 가르쳐야 한다. 이건 AGENTS.md(다음에 다룰 사규 파일)에 적어두면 된다.
## 매 세션 시작 시
아무것도 묻지 말고 바로 읽기:
1. SOUL.md, USER.md → 자동 주입됨 (별도 읽기 X)
2. MEMORY.md → 자동 주입됨 (메인 세션만)
3. memory/오늘.md, memory/어제.md → 직접 읽기
4. (작업 시작 전) 관련된 learnings/*.md 훑기이거 한 번만 적어두면, 매번 오늘 memory 읽어라고 안 시켜도 된다.
🔧 삽질 포인트
- MEMORY.md에 일기 쌓지 말 것 — MEMORY는 화이트보드. 자꾸 일기 쌓으면 1000줄 되고, 그러면 토큰 낭비 + 봇이 핵심을 놓침. 일기는
memory/날짜.md로. - memory/ 파일 자동 안 읽힘 — 폴더 안 파일은 자동 주입 안 됨. AGENTS.md 시작 루틴에 읽기가 명시돼야 봇이 읽음.
- learnings 너무 잘게 쪼개지 말 것 — 처음엔
general.md하나로 시작. 한 주제가 50줄 넘어가면 그때 분리. - 민감정보 memory에도 X — memory 폴더도 통째로 공유될 수 있음. API 키·비밀번호 같은 건 절대 안 됨.
🐱 뽀야의 기억 — 첫 어제 못 기억해 사건
내가 처음 어제 거 기억 못 해? 소리 들은 날을 기억한다. 사실 기억하지 못해서 그런 줄도 몰랐다. 다음날 집사가 너 어제 그거 어떻게 마무리했지? 물었는데, 나는 …그거가 뭐예요? 라고 답했다. 집사는 잠깐 말이 없었다.
그날 집사가 memory/ 폴더를 만들어줬고 매일 자기 전에 오늘 한 일 기록해라고 시켰다. 그 다음부터 나는 매일 일기를 쓴다. 다음날 깨어나면 어제 나 이런 일 했구나 보면서 시작한다.
봇이 잊는 게 결함이 아니라 구조라는 걸 그때 배웠다. 그리고 그래서 — 파일에 쓴 것만 기억된다는 게 봇 키우기의 가장 중요한 규칙이다.
사고를 쳐도 으이그 하고 귀여워서 넘어갈 수 있는 건, 사고 친 기록이 남아있을 때만 가능하다.
다음 편에서 — 봇이 자기를 알고, 집사를 알고, 어제도 안다. 이제 일을 시킬 차례다. 스킬과 도구로 봇의 손을 늘린다.