OpenCLAW 메모리가 실제로 작동하는 방식

OpenCLAW 에이전트는 대화 간 지속적인 메모리를 갖지 않습니다. 메시지를 보낼 때마다 에이전트는 여러 파일(SOUL.md, USER.md, MEMORY.md, 최근 세션 기록)을 읽고 "메모리"를 처음부터 구성합니다. 기억하는 것이 아니라 노트를 읽는 것입니다.

에이전트가 정보를 잊어버리는 이유

이유 1: 세션이 너무 오래됨

현재 세션의 모든 메시지는 각각의 새로운 API 호출에 포함됩니다. 2-3주 후에는 수천 개의 토큰이 됩니다. 모델은 컨텍스트 제한에 도달하거나(이전 대화가 조용히 잘림) OpenCLAW가 모든 것을 요약하지만 세부 사항을 잃는 압축을 실행합니다.

해결책: /new를 정기적으로 사용하세요 - 최소한 매일, 그리고 큰 작업 전에. 이렇게 하면 모든 파일은 그대로 유지하면서 대화 버퍼를 지웁니다.

이유 2: 중요한 정보가 채팅 기록에 있고 파일에 없음

3주 전 대화에서 에이전트에게 무언가를 말했다면, 그 정보는 잘리는 세션 기록에 있습니다. 에이전트가 항상 알아야 할 정보는 채팅이 아닌 파일에 있어야 합니다.

해결책: 영구적인 정보를 USER.md에 넣으세요:

# 나에 대해
- 이름: [당신의 이름]
- 파트너: [이름]
- 위치: [도시]
- 직업: [역할]
- 시간대: [시간대]

선호도

의사소통: 직접적, 불필요한 말 없음
아침 루틴: 오전 8시 브리핑
오전 10시 이전에는 회의를 예약하지 않음
커피 주문: [뭐든지, 진짜로]

이 파일은 매 세션마다 로드되며 잘리거나 압축되지 않습니다.

이유 3: MEMORY.md가 비대해진 혼란 상태임

대부분의 사람들은 MEMORY.md를 구조화하지 않아 한 달 후에는 모델이 읽는 대신 훑어보는 거대한 텍스트 벽이 됩니다. 중요한 사실은 관련 없는 세부 사항 아래에 묻힙니다.

해결책: MEMORY.md를 명확한 섹션으로 구조화하세요:

# 사람들
사라(아내): [회사]에서 근무, 생일 6월 12일
마이크(동료): 프론트엔드 담당, 이메일보다 슬랙 선호

진행 중인 프로젝트

주방 리모델링: 계약자 데이브, 예산 $15K, 4월 시작
2분기 발표: 3월 28일 마감, 마이크로부터 판매 데이터 필요

결정된 사항

3월 5일 오푸스에서 소넷으로 전환(비용 이유)
구글 대신 브레이브 검색 API 사용(무료 티어 충분)

반복 작업

매일 오전 8시 브리핑(캘린더 + 이메일 + 날씨)
매주 일요일 오후 6시 장보기 목록

구조화된 메모리는 정확하게 검색됩니다. 에이전트는 문단 벽보다 구조화된 텍스트를 더 잘 읽습니다.

이유 4: 메모리 유지 관리 루틴이 없음

메모리 파일은 청소 없이 영원히 커집니다. 2개월 후, MEMORY.md는 300줄 중 절반이 구식이거나 관련 없어 완료된 프로젝트에 토큰을 낭비합니다.

해결책: 야간 메모리 크론을 설정하세요. 에이전트 지시사항에 다음을 추가하세요:

매일 밤 11시:


오늘의 대화 검토
새로운 사실, 결정, 약속 추출
MEMORY.md의 올바른 섹션에 추가
더 이상 관련 없는 내용 제거
새 세션 시작

이유 5: 세션 메모리와 장기 메모리를 혼동함

계층 구조를 이해하세요:

• SOUL.md: 정체성과 성격. 매번 로드됨. 변경하지 않는 한 변경되지 않음.
• USER.md: 당신에 대한 사실. 매번 로드됨. 삶이 변할 때 업데이트.
• MEMORY.md: 진행 중인 컨텍스트. 매번 로드됨. 성장하고 가지치기됨.