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시:
1. 오늘의 대화 검토
2. 새로운 사실, 결정, 약속 추출
3. MEMORY.md의 올바른 섹션에 추가
4. 더 이상 관련 없는 것은 제거
5. 새로운 세션 시작

이유 5: 세션 메모리와 장기 메모리를 혼동하고 있습니다

계층 구조를 이해하세요:

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