OpenClaw 메모리 설명: 아키텍처, 설정 및 잊어버리는 이유

완전한 OpenClaw 메모리 아키텍처(3개 레이어 설명)

OpenClaw 메모리는 세 가지 개별 계층에서 작동하며 각 계층은 지속성 특성과 오류 모드가 다릅니다.

전체 메모리 수명주기:

Write → Embed/Index → Search → Compact → Recover ↓ ↓ ↓ ↓ ↓ .md file sqlite-vec semantic summary MEMORY.md created indexes it query replaces re-read at on save returns context session start chunks window

이 체인의 모든 단계는 독립적으로 실패할 수 있습니다. 대부분의 망각 문제는 정확히 하나의 깨진 단계로 추적됩니다.

Layer 1 — 활성 컨텍스트 창

이것이 모델의 작업 메모리입니다. 활성 대화를 위해 현재 컨텍스트 창에 로드된 모든 것입니다. 여기에는 시스템 프롬프트, 대화 기록 및 검색 도구에서 검색한 모든 메모리 청크가 포함됩니다.

그것을 채우는 것:

• 시스템 프롬프트(종종 대형)
• 회수된 기억 발췌
• 도구 통화 내역
• 대화 차례

실제 한계: 시스템 프롬프트 및 메모리 오버헤드 이후 실제 대화에 사용할 수 있는 모델의 알려진 컨텍스트 창의 대략 60~70%가 있다고 가정합니다.

Layer 2 — 일일 메모(롤링 2일 기간)

일일 메모는 memory/ 디렉터리에 저장된 YYYY-MM-DD 형식으로 명명된 추가 전용 마크다운 파일입니다. OpenClaw 로드 오늘과 어제 각 세션이 시작될 때 자동으로 파일을 생성합니다.

• 오늘의 작업, 내린 결정, 활성 작업에 대한 사실이 여기에 추가됩니다.
• 편집할 의도가 없습니다. 로그로 취급하세요.
• 이틀 후에는 자동 로드 창에서 벗어나 의미 검색을 통해서만 검색 가능해집니다.

Layer 3 — 내구성 있는 메모리(MEMORY.md 및 memory-wiki)

이름, 프로젝트 컨텍스트, 코딩 기본 설정, 아키텍처 결정 등 세션 전반에 걸쳐 유지되어야 하는 장기적인 사실은 MEMORY.md 또는 구조화된 memory-wiki 플러그인 저장소에 속합니다.

압축 문제 - 작업 중에 지침이 사라지는 이유

압축은 OpenClaw에서 가장 잘 문서화되지 않은 실패 모드입니다. 대부분의 기사는 세션 후 망각에 대해 다루고 있습니다. 주소가 거의 없음 장기 실행 자율 워크플로우의 중간 작업 압축 — 에이전트가 다단계 작업을 실행하는 경우 12단계 중 7단계에서 압축이 자동으로 실행되고 1단계의 동작 지침이 사라집니다.

압축의 역할:

1. 용량에 가까워지는 컨텍스트 창을 감지합니다.
2. 현재 대화를 압축된 블록으로 요약합니다.
3. 원래 컨텍스트를 요약으로 대체합니다.
4. 계속 실행

트리거되는 경우: 기본 memory-core 플러그인에는 구성 가능한 임계값이 없습니다. 작업 단계가 아닌 토큰 수를 기준으로 실행됩니다. 2시간 자율 실행에서는 3~5회의 압축 주기를 예상할 수 있습니다.

압축 방지 파일 아키텍처를 구축하는 방법

대화가 아닌 MEMORY.md에 행동 지침을 고정하세요. 여러 압축 주기를 거쳐야 하는 모든 항목은 각 압축 후에 다시 읽히는 내구성 있는 파일에 있어야 합니다.

권장 고정 패턴:

 ## Agent Behavioral Rules (always active) - Never overwrite files without showing a diff first - Write tests before implementation (TDD mode: on) - Use TypeScript strict mode in all new files ## Project Context - Stack: Node.js 22, Fastify, PostgreSQL 16 - Repo root: /home/user/project - Active sprint goal: migrate auth to Clerk

압축 후에도 유지되는 명명 규칙:

• 중요 섹션 앞에 ## [PINNED]을 붙입니다. 요약자는 대문자 헤더를 높은 우선순위로 처리합니다.
• 가능한 한 각 고정된 사실을 한 줄로 유지하십시오. 조밀한 단락은 요약되고 한 줄의 사실은 그대로 유지되는 경향이 있습니다.
• MEMORY.md과 오늘의 일일 메모에서 가장 중요한 행동 규칙 3~5개를 반복합니다. 중복성은 압축 방지책입니다.

10분 만에 제로-메모리 설정(완전한 파일 스캐폴드)

다른 곳에는 없는 설정 가이드입니다. 이 구조를 복사하고 컨텍스트를 입력하면 실행됩니다.

디렉토리 트리:

memory/ ├── MEMORY.md ├── 2026-04-27.md ← today's daily note (create manually) └── wiki/ ← only if using memory-wiki plugin ├── index.md ├── project-context.md └── decisions.md

스타터 MEMORY.md:

# Persistent Memory ## Identity & Preferences - Name: [your name] - Role: [your role] - Preferred response style: concise, no preamble ## Project: [Project Name] - Stack: [your stack] - Key constraints: [e.g., no external APIs, TypeScript only] - Current focus: [active task or sprint goal] ## Behavioral Rules - [Rule 1] - [Rule 2] ## Decisions Made - [YYYY-MM-DD] Decided to use X because Y

시작 일일 메모(2026-04-27.md):

# 2026-04-27 ## Session Goals - [ ] Task 1 - [ ] Task 2 ## Notes 

플러그인 슬롯 구성(2026 구문):

{ "plugins": { "slots": { "memory": "memory-core" } } }

메모리를 완전히 비활성화하려면:

{ "plugins": { "slots": { "memory": false } } }

확인 단계:

1. 세션을 실행하고 에이전트에게 이전 세션에서 말한 내용을 기억해 달라고 요청하세요.
2. memory/YYYY-MM-DD.md이 작성되었는지 확인하세요(새 콘텐츠가 있어야 함).
3. 상담원에게 직접 물어보세요. "나에 대해 무엇을 알고 있나요?" — MEMORY.md에서 가져와야 합니다.

생산 기술 자료를 위한 Configuring memory-wiki

플러그인 슬롯을 교체하여 활성화하십시오.

{ "plugins": { "slots": { "memory": "memory-wiki" } } }

memory-wiki는 memory/wiki/ 아래에 구조화된 저장소를 생성합니다. 각 주제에는 자체 페이지가 있습니다. 플러그인은 세션 시작 시 에이전트가 로드할 수 있도록 신뢰도가 높고 모순되지 않는 사실을 집계하는 digest.md을 컴파일합니다.

프로덕션 에이전트를 위한 실용적인 저장소 구조:

memory/wiki/ ├── index.md ← vault table of contents ├── digest.md ← auto-generated; agent reads this ├── project-context.md ← stack, goals, constraints ├── decisions.md ← architectural decisions log ├── team.md ← stakeholders, contacts └── domain-knowledge.md ← business rules, glossary

Semantic Search and Embeddings — SQLite, sqlite-vec 및 JS 대체

OpenClaw은 다음을 사용하여 메모리 파일을 색인화합니다. SQLite with the sqlite-vec extension 벡터 유사성 검색을 위한 것입니다. 귀하 또는 에이전트가 메모리 검색을 실행하면 쿼리가 포함되고 의미상 가장 관련성이 높은 청크가 검색됩니다.

벡터 저장소가 정상인지 확인하십시오.

# Check that the memory index exists ls memory/.index/ # Reset a corrupted index (safe to run — it rebuilds from .md files) rm -rf memory/.index/ && openclaw reindex

sqlite-vec를 사용할 수 없는 경우(ARM Linux 및 일부 Windows 구성에서 일반적) OpenClaw은 순수 JS 벡터 확장으로 대체됩니다. 명시적으로 대체를 강제합니다.

{ "memory": { "vectorBackend": "js" } }

Segment-Specific Memory Strategies

Solo Developer — 최소 오버헤드, 최대 리콜

권장 설정: memory-core 플러그인, MEMORY.md + 일일 메모만, Wiki Vault 없음.

• MEMORY.md을 200줄 미만으로 유지합니다. 파일이 길어지면 세션 시작이 느려집니다.
• 일일 메모에 적극적으로 추가하세요. 깨끗하게 유지하려고 하지 마세요
• 매주 MEMORY.md을 검토하고 정리합니다. 오래된 사실로 인해 검색 품질이 저하됩니다.

다중 에이전트 파이프라인 — 에이전트 간 공유 메모리

여러 에이전트가 동일한 memory/ 디렉터리를 읽고 쓰는 경우 명시적인 소유권 규칙이 필요합니다.

• One agent owns writes to each file — 동일한 .md 파일에 동시 쓰기를 하면 충돌이 발생합니다.
• 에이전트당 하위 디렉터리 사용: memory/agent-a/, memory/agent-b/, 공유 memory/shared/MEMORY.md
• 공유 볼트에 memory-wiki를 사용하세요. 다이제스트 컴파일은 원시 파일보다 여러 작성자의 최신성을 더 잘 처리합니다.

Long-Running Autonomous Tasks — 생존 실행 시간

시간 단위로 측정되는 작업을 실행하는 에이전트의 경우:

• Force memory writes at checkpoints — 각 주요 작업 단계 후에 에이전트에게 현재 상태를 오늘의 일일 메모에 추가하도록 지시합니다.
• Pre-load compaction-resistant context — 초기 메시지뿐만 아니라 실행이 시작되기 전에 전체 작업 사양을 MEMORY.md에 넣습니다.
• Set explicit continuation markers 일일 메모: <!-- RESUME POINT: completed steps 1-4, next: step 5 --> 에이전트가 압축 주기 후에 자체 방향을 지정할 수 있도록 합니다.

Troubleshooting OpenClaw Memory — 잊어버린 문제를 2분 안에 진단합니다

다음 단계를 순서대로 수행하세요.

Frequently Asked Questions

최종 평결 - 실제로 유지되는 메모리 설정

대부분의 사용자를 위한 Recommended baseline: memory-core 플러그인, 첫 번째 세션 전에 생성된 memory/ 디렉터리, 명확하게 라벨이 지정된 고정 섹션의 행동 규칙이 있는 MEMORY.md, 각 세션 전체에 일일 메모가 추가됩니다.

귀하의 행동 체크리스트:

• 프로젝트 루트에 memory/ 디렉터리를 만듭니다.
• 위의 스타터 MEMORY.md 템플릿을 복사하고 컨텍스트를 입력하세요.
• plugins.slots.memory이 "memory-core"(또는 선택한 플러그인)으로 설정되어 있는지 확인하세요.
• MEMORY.md의 ## [PINNED]에 가장 중요한 행동 규칙 3~5개를 추가하세요.
• 첫 번째 세션 후 날짜가 적힌 일일 메모가 작성되었는지 확인하세요.
• 의미 검색이 기분이 좋지 않으면 openclaw reindex을 실행하여 벡터 인덱스를 다시 작성하십시오.

아키텍처는 일단 이해하면 건전합니다. 대부분의 잊어버리는 문제는 이 체크리스트를 따른 후 10분 이내에 해결됩니다.