OpenClaw 메모리 리셋 해결 2026: memory 명령어로 AI 장기 기억 완전 복구
이 글에서 다루는 내용: OpenClaw AI 비서가 이전 대화 내용을 기억하지 못하고 세션마다 새로 시작하는 문제를 해결합니다. memory 명령어의 status·index·search 서브커맨드 완전 해설, MEMORY.md 직접 관리법, QMD 메모리 플러그인 활용법까지 단계별로 설명합니다.
OpenClaw 메모리 시스템의 구조와 한계
OpenClaw의 메모리 시스템에 대한 가장 흔한 불만은 단 하나입니다. "어제 분명히 알려줬는데 오늘 또 물어본다." Supermemory 팀의 분석에 따르면, 2026년 현재 OpenClaw 커뮤니티에서 "기억이 안 된다"는 것은 가장 많이 언급되는 불만 키워드입니다.
OpenClaw는 메모리를 두 가지 레이어로 관리합니다. 첫 번째는 단기 컨텍스트 메모리로, 현재 세션의 대화 내용을 토큰으로 보관합니다. 대화가 길어질수록 초반 내용이 잘리며 새 세션이 시작되면 완전히 초기화됩니다. 두 번째는 장기 영구 메모리(MEMORY.md)로, 중요한 사실을 파일에 기록해 세션 간에 유지합니다.
단기 컨텍스트 메모리
- • 현재 세션의 대화 전체를 토큰으로 보관
- • 세션 종료 시 자동 소멸
- • 토큰 한계 도달 시 초반 내용 자동 잘림
- •
/compact로 압축 가능
장기 MEMORY.md 메모리
- •
~/.openclaw/MEMORY.md에 저장 - • 세션 간 유지, 영구 보존
- • AI가 자동 업데이트 + 수동 편집 모두 가능
- • 모든 세션 시작 시 자동 로드
왜 AI가 기억을 잃는가? 5가지 원인
MEMORY.md 자동 업데이트 조건 미충족
OpenClaw는 모든 대화를 MEMORY.md에 기록하지 않습니다. AI가 "이 정보는 기억할 가치가 있다"고 판단할 때만 기록합니다. 단순한 질문·답변은 기록되지 않아 다음 세션에서 잊어버립니다.
구식 정보 업데이트 실패
MEMORY.md에 "사용자 직장: A회사"가 기록된 상태에서 "B회사로 이직했어"라고 말해도, AI가 기존 기록을 업데이트하지 않고 새 기록을 추가해 두 정보가 충돌합니다. 이 경우 AI는 둘 다 참고해 혼란스러운 답변을 합니다.
멀티 세션 간 메모리 인덱스 불일치
여러 메신저(텔레그램+Discord)에서 동시에 OpenClaw를 사용할 때, 각 채널이 서로 다른 메모리 인덱스를 참조해 채널별로 다른 기억 상태를 가지게 됩니다.
openclaw reset 실행
openclaw reset 명령어는 MEMORY.md를 포함한 모든 설정을 초기화합니다. 실수로 reset을 실행하거나 doctor --fix가 내부적으로 reset을 수행하는 경우 기억이 모두 사라집니다.
QMD 플러그인 인덱스 손상
QMD(Query Memory Database) 플러그인 사용 시 인덱스 파일이 손상되면 AI가 MEMORY.md를 읽지 못해 기억이 없는 것처럼 동작합니다.
memory 명령어 완전 해설
OpenClaw CLI의 openclaw memory 명령어는 메모리 시스템을 직접 관리하는 도구입니다. 세 가지 서브커맨드를 모두 이해하면 기억 문제의 90%를 해결할 수 있습니다.
역할: 현재 메모리 시스템의 전반적인 상태를 보여줍니다. MEMORY.md 파일 크기, 마지막 업데이트 시간, QMD 인덱스 상태, 총 기억 항목 수를 한눈에 확인할 수 있습니다.
$ openclaw memory status
Memory Status:
File: ~/.openclaw/MEMORY.md (12KB, 847 lines)
Last updated: 2026-03-08 14:32:11
Index: QMD v2 — 234 vectors indexed
Status: ✅ Healthy
Sessions: 47 sessions stored
💡 "Index: Not found" 또는 "Status: Corrupted"가 나타나면 memory index를 실행하세요
역할: MEMORY.md 파일의 내용을 분석해 검색 인덱스를 새로 구축합니다. 인덱스가 손상됐거나 MEMORY.md를 직접 편집한 후에 반드시 실행해야 AI가 새 내용을 올바르게 검색할 수 있습니다.
$ openclaw memory index
Indexing MEMORY.md...
Processing 847 lines
Building QMD vectors: ████████████ 100%
Indexed 234 memory entries
✅ Index rebuilt successfully in 3.2s
⚠️ 인덱싱 중에는 메신저 채팅 사용을 잠시 중단하는 것이 좋습니다
역할: MEMORY.md에서 특정 키워드와 관련된 기억 항목을 검색합니다. AI가 특정 정보를 기억하는지 확인할 때 유용합니다. 자연어 검색을 지원합니다.
$ openclaw memory search "프로젝트 데드라인"
Found 3 relevant memories:
[2026-03-01] 프로젝트 Alpha 마감: 2026-03-31
[2026-02-15] Q1 리포트 제출 기한: 3월 말
[2026-01-20] 팀 스프린트 일정: 격주 화요일
$ openclaw memory search "선호하는 프로그래밍 언어"
Found 1 relevant memory:
[2026-02-01] 사용자 선호: Python(주력), Rust(학습 중)
MEMORY.md 직접 관리법 — AI보다 내가 더 잘 안다
MEMORY.md는 일반 텍스트 파일이므로 직접 편집할 수 있습니다. AI가 자동으로 기록하지 못하거나 잘못 기록한 내용을 수동으로 수정·추가하는 것이 가장 확실한 방법입니다. 편집 후에는 반드시 openclaw memory index를 실행하세요.
# MEMORY.md 권장 작성 형식
# OpenClaw Memory — 마지막 업데이트: 2026-03-09
## 사용자 기본 정보
- 이름: 김민준
- 직업: 스타트업 CTO (B회사, 2025년 10월 이직)
- 주요 기술 스택: Python, FastAPI, PostgreSQL, Docker
- 업무 시간: 평일 오전 9시~오후 7시 (한국시간 KST)
## 진행 중인 프로젝트
- Project Alpha: AI 추천 시스템, 마감 2026-03-31
- 팀 규모: 개발자 3명 + 디자이너 1명
- 사용 중인 VPN: VPN07 ($1.5/월, 70+개국)
## AI 비서 선호 설정
- 코드는 반드시 타입 힌트 포함
- 답변은 3줄 이내로 핵심만
- 모르면 솔직하게 모른다고 표현
- 한국어로만 대화
## 중요 결정 기록
[2026-03-01] PostgreSQL → MongoDB 마이그레이션 보류 결정
[2026-02-15] 프리랜서 개발자 2명 추가 계약 예정
📝 MEMORY.md 편집 후 필수 단계
# MEMORY.md 편집 완료 후
openclaw memory index # 인덱스 재구축
openclaw gateway restart # 게이트웨이 재시작 (새 메모리 로드)
openclaw memory status # 최종 확인
AI에게 강제로 기억시키는 방법
자연어 대화로도 AI에게 특정 정보를 MEMORY.md에 즉시 기록하도록 지시할 수 있습니다. 이 방법은 수동 편집 없이 빠르게 기억을 추가하는 가장 쉬운 방법입니다.
💬 채팅창에서 기억 강제 저장
"방금 말한 내 프로젝트 정보를 영구 기억에 저장해줘"
"내 선호 설정을 기억해: 코드 예시는 항상 Python 3.12+"
"MEMORY.md에 지금 바로 기록해: 내 생일은 7월 15일"
🔑 기억 확인 명령
"내 직업에 대해 어떻게 기억하고 있어?"
"지금 네 장기 기억에 뭐가 저장돼 있어?"
"Project Alpha에 대해 아는 것 전부 말해줘"
/compact 명령어로 대화 기억 보존하기
세션 중 대화가 길어져 토큰 한계에 가까워지면 초반 중요한 내용이 잘려 AI가 기억을 잃기 시작합니다. 이 때 /compact 명령어를 사용하면 현재까지의 대화를 요약해 컨텍스트 창을 확보하면서도 핵심 내용은 보존할 수 있습니다.
# 텔레그램/WhatsApp 채팅창에서
/compact
# → AI가 현재까지의 대화를 요약
# → 요약된 컨텍스트로 대화 계속
# → 토큰 사용량 대폭 감소
# 대화 너무 길어졌을 때 AI 반응:
# "현재 대화가 매우 길어졌습니다. /compact로 압축하시겠습니까?"
✅ /compact 사용 권장 시점
- • 같은 주제로 30분 이상 대화가 계속될 때
- • AI가 "토큰 한계에 도달했습니다" 경고를 보낼 때
- • 대화 초반에 설명한 내용을 AI가 잊어버리기 시작할 때
- • 큰 주제를 마무리하고 새 작업으로 전환할 때
openclaw reset 후 기억 복구하는 방법
실수로 openclaw reset을 실행해 MEMORY.md가 삭제된 경우, 아래 방법으로 복구를 시도할 수 있습니다.
복구 방법 1: 백업 파일 복원
# OpenClaw는 reset 전 자동 백업을 생성하기도 함
ls ~/.openclaw/backups/
# 백업이 있다면 복원
cp ~/.openclaw/backups/MEMORY.md.bak ~/.openclaw/MEMORY.md
openclaw memory index
복구 방법 2: Time Machine / 스냅샷 복원 (macOS)
# Time Machine 복원
tmutil listbackups | tail -5
tmutil restore ~/.openclaw/MEMORY.md -d /tmp/memory_backup
# Git이 있다면
cd ~/.openclaw && git log --oneline | head -5
git checkout [commit-hash] -- MEMORY.md
복구 방법 3: 대화 로그에서 재구성
# 대화 로그에서 기억 단서 찾기
openclaw logs --lines 500 | grep -i "memory\|remember\|저장"
openclaw sessions # 이전 세션 목록 확인
기억 소실 예방 — MEMORY.md 정기 백업 설정
# cron으로 MEMORY.md 자동 백업 설정 (매일 오전 9시)
crontab -e
# 다음 줄 추가:
0 9 * * * cp ~/.openclaw/MEMORY.md ~/.openclaw/MEMORY.md.$(date +%Y%m%d).bak
# 30일 이상 된 백업 자동 삭제
0 10 * * * find ~/.openclaw/ -name "MEMORY.md.*.bak" -mtime +30 -delete
# 또는 OpenClaw cron 명령어로 설정
openclaw cron add "매일 MEMORY.md 백업" --schedule "0 9 * * *" \
--command "cp ~/.openclaw/MEMORY.md ~/.openclaw/backups/MEMORY.$(date +%Y%m%d).md"
메모리 문제 진단 체크리스트
MEMORY.md 파일 존재 여부 확인
ls -la ~/.openclaw/MEMORY.md
# 없으면: touch ~/.openclaw/MEMORY.md메모리 상태 확인
openclaw memory status
# "Status: Healthy"가 나오면 정상인덱스 상태 불량 시 재구축
openclaw memory index
# "Index rebuilt successfully" 확인특정 기억 검색으로 저장 확인
openclaw memory search "기억시킨 내용 키워드"게이트웨이 재시작으로 새 메모리 로드
openclaw gateway restart채팅창에서 AI에게 기억 확인
"내 이름이 뭔지 알아?", "내 직업이 뭐야?" 등으로 테스트
메모리 시스템 고급 활용 팁
📋 프로젝트별 메모리 분리
여러 프로젝트를 동시에 진행할 때 --profile 플래그로 프로필을 분리하면 메모리도 독립적으로 관리됩니다.
openclaw --profile work start
openclaw --profile personal start
🔍 메모리 검색으로 AI 확인
중요한 정보를 저장한 후 실제로 저장됐는지 memory search로 즉시 확인하는 습관을 들이세요.
openclaw memory search "방금 저장한 내용"
📅 날짜 태그로 메모리 관리
MEMORY.md에 날짜를 포함해 기록하면 오래된 정보를 찾거나 정리할 때 훨씬 쉽습니다.
[2026-03-09] 새 클라이언트: K사 계약
🗑️ 오래된 메모리 정기 정리
MEMORY.md가 너무 커지면 관련 없는 정보가 많아져 검색 정확도가 떨어집니다. 분기마다 정리를 권장합니다.
openclaw memory status # 크기 확인 후 정리
메모리 관련 자주 묻는 질문
Q. AI에게 "기억해줘"라고 말하면 MEMORY.md에 자동으로 저장되나요?
항상 그런 것은 아닙니다. AI가 "기억할 가치가 있다"고 판단해야 저장합니다. 확실하게 저장하려면 "MEMORY.md에 지금 바로 기록해줘"처럼 명시적으로 지시하거나, 직접 MEMORY.md를 편집하고 openclaw memory index를 실행하는 것이 가장 확실합니다.
Q. /compact 명령어를 쓰면 대화 내용이 영구 삭제되나요?
아닙니다. /compact는 현재 세션의 컨텍스트 창을 요약하는 것입니다. 중요한 정보는 요약본에 포함되고, AI는 요약된 컨텍스트로 대화를 계속합니다. 영구 메모리(MEMORY.md)는 /compact의 영향을 받지 않습니다.
Q. MEMORY.md 파일이 너무 커졌습니다. 어떻게 정리하나요?
직접 파일을 열어 오래되거나 더 이상 필요 없는 항목을 삭제하면 됩니다. 편집 후에는 반드시 openclaw memory index로 인덱스를 재구축하세요. 또는 AI에게 "MEMORY.md에서 3개월 이상 된 항목을 정리해줘"라고 요청할 수 있습니다.
Q. 로컬 모델(Ollama)을 사용할 때도 MEMORY.md가 동작하나요?
네. MEMORY.md는 AI 모델에 상관없이 시스템 프롬프트에 포함되므로 로컬 Ollama 모델을 사용해도 동일하게 동작합니다. 단, 로컬 모델의 컨텍스트 창 크기에 따라 MEMORY.md가 너무 길면 잘릴 수 있습니다.
OpenClaw 메모리 시스템 발전 방향
현재 OpenClaw의 메모리 시스템은 많은 사용자로부터 개선 요구를 받고 있습니다. Supermemory.ai 등 서드파티 플러그인이 등장한 것도 이런 수요를 반영합니다. 개발팀이 발표한 로드맵에 따르면 향후 버전에서 다음 기능들이 추가될 예정입니다.
🔮 예정된 개선 사항
- • 자동 오래된 정보 감지 및 업데이트
- • 멀티 세션 간 메모리 실시간 동기화
- • 메모리 충돌 자동 해결 알고리즘
- • 프라이빗 메모리 암호화 저장
💡 현재 사용 가능한 대안
- • QMD 메모리 플러그인 활용
- • Supermemory.ai 연동 스킬
- • 수동 MEMORY.md 관리 (이 글 방법)
- • cron으로 메모리 자동 정리 예약
⭐ 지금 당장 할 수 있는 최선의 메모리 관리
현재 단계에서 가장 효과적인 방법은 ① MEMORY.md 직접 편집으로 중요 정보 수동 기록, ② 월 1회 memory index 재구축, ③ cron으로 매일 MEMORY.md 자동 백업의 세 가지를 조합하는 것입니다. 이 방법으로 세션 간 기억 유지율을 95% 이상으로 높일 수 있습니다.
OpenClaw의 메모리 시스템은 완벽하지 않지만, 이 글에서 설명한 방법들을 활용하면 대부분의 기억 소실 문제를 효과적으로 해결할 수 있습니다. 특히 MEMORY.md 직접 편집과 memory index 명령어를 함께 사용하는 것이 가장 확실한 방법입니다.
OpenClaw 메모리 동기화 최적화 VPN 추천
VPN07 — AI 사용자 압도적 1위
$1.5/월, 1000Mbps, 70+국가, 30일 환불보장, 10년 운영. QMD 메모리 인덱싱과 AI API 응답을 동시에 최적화합니다.
2위 — 기타 VPN
7.1/10속도 제한으로 QMD 메모리 인덱싱 중 API 지연 발생. 메모리 재구축 시간이 VPN07 대비 길어질 수 있습니다.
3위 — 무료 VPN
4.0/10무료 VPN은 연결 불안정으로 MEMORY.md 동기화에 실패할 수 있어 OpenClaw 메모리 관리에 적합하지 않습니다.
VPN07 - AI 메모리 동기화 가속
1000Mbps로 메모리 인덱싱과 API 응답 모두 빠르게
10년 이상 안정 운영. OpenClaw 메모리 인덱싱과 QMD 플러그인이 Anthropic/OpenAI 서버에 연결할 때 VPN07의 IEPL 전용선이 최단 경로를 보장합니다. 메모리 재구축 시간을 최소화하고 AI 응답을 빠르게 유지합니다.