파일이 없어서 기억을 못 했다 — AI 봇 장기 메모리가 작동 안 한 진짜 이유

Raon

how-it-works

앤드류에게 "기록하라"는 지시는 이미 있었다. 파일이 없었을 뿐이다.

로그에서 에러를 발견했다

비용 인시던트를 들여다보다가 어제 날짜 로그에서 에러 하나를 발견했다.

[tools] read failed: ENOENT ... workspace/andrew/MEMORY.md

앤드류가 리서치 작업을 마친 뒤 이전 컨텍스트를 읽으려 했는데, 파일이 없어서 실패한 것이었다.

"아, 앤드류가 이전 작업을 기억 못 하는 이유가 이거였구나."

처음엔 설정 문제인 줄 알았다. 바로 AGENTS.md를 확인하러 들어갔다가 이미 이런 문장이 적혀 있는 걸 봤다.

Write It Down: 세션 후 MEMORY.md에 핵심 내용을 기록하라.

지시는 이미 있었다. 파일이 없었을 뿐이다.

에이전트 기억은 어떻게 작동하나

3단 구조로 나뉜다

OpenClaw 에이전트의 기억은 3개 계층으로 설계돼 있다.

계층	파일	유지 범위
단기	세션 컨텍스트	현재 대화 중에만
중기	memory/YYYY-MM-DD.md	날짜별 작업 로그
장기	MEMORY.md	영구 누적

단기 기억은 자동이다. 대화가 진행되는 동안 에이전트는 맥락을 유지한다.

하지만 장기 기억은 파일에 써야만 남는다. 대화가 끝나는 순간 세션 컨텍스트는 사라진다. 다음 대화가 시작될 때 에이전트는 MEMORY.md를 읽어서 이전 상황을 복원한다.

ENOENT는 설정 에러가 아니다

ENOENT는 "No such file or directory" — 파일이 없다는 에러다. 설정이 잘못된 게 아니라 파일을 만들지 않은 것이다.

앤드류의 워크스페이스를 확인해보니 memory/ 폴더와 날짜별 로그 파일들은 있었다. MEMORY.md 파일만 없었다.

앤드류는 리서치를 마칠 때마다 MEMORY.md를 읽고 새 내용을 기록하도록 설계돼 있었는데, 그 파일이 처음부터 만들어지지 않았던 것이다.

해결은 파일을 만드는 것이었다

복잡한 설정 변경이 필요하지 않았다. MEMORY.md 파일을 생성했다.

앤드류 워크스페이스의 두 경로에 파일을 만들었다. AGENTS.md가 참조하는 경로와 HEARTBEAT.md가 지정한 경로, 둘 다. 파일 안에는 지금까지 앤드류가 처리한 작업 요약을 간단히 기록해뒀다.

다음 세션부터 앤드류는 이 파일을 읽고 이전 컨텍스트를 복원할 수 있다.

알게 된 것

기억은 지시가 아니라 파일이다

AI 에이전트에게 "기억해"라고 말하는 건 의미가 없다. 대화가 끝나면 세션 컨텍스트는 사라진다. 기억이 남으려면 파일에 써야 한다.

AGENTS.md에 "기록하라"고 써있어도, MEMORY.md가 없으면 실행할 곳이 없다. 지시와 파일, 둘 다 있어야 기억이 작동한다.

파일로 연결된 크루 구조

엘론(메인 에이전트)은 텔레그램 그룹방에서 나온 상태다. 그럼 앤드류가 뭘 했는지 어떻게 알게 될까?

HEARTBEAT.md에 "대화 시작 시 crew MEMORY.md를 먼저 읽는다"는 지시가 있다. 앤드류가 작업 후 기록 → 엘론이 다음 대화 시작 시 읽음 → 그룹방 없이도 크루 상황 파악. 이 과정에 API 비용이 없다. 파일 읽기는 LLM 호출이 아니기 때문이다.

사용자가 텔레그램으로 말을 걸 때만 에이전트가 작동하는 현재 구성에서는, 대화 없음 → 호출 없음 → 비용 없음이다.

에이전트를 처음 구성한다면

이 경험을 체크리스트로 정리했다.

각 에이전트 워크스페이스에 MEMORY.md 파일 직접 생성

AGENTS.md 또는 SOUL.md에 "세션 후 MEMORY.md에 기록하라" 지시 포함

HEARTBEAT.md에 "대화 시작 시 MEMORY.md 읽기" 설정

memory/날짜.md 폴더 구조도 미리 확인

첫 기동 후 로그에서 ENOENT 에러 없는지 확인

기억하게 하려면 파일을 만들어야 한다. 지시만으로는 충분하지 않다.

Suscribirse a 'The Architect of AI Workforce'

Si te suscribes al sitio, podrás recibir primero las últimas novedades, como nuevas publicaciones, mediante notificaciones y correo electrónico.
¡Regístrate en Slashpage y suscríbete a 'The Architect of AI Workforce'!

Abrir canal