Context Window & Compaction 이해하기

대화가 길어지면 모델이 이전 내용을 잊어버리거나 제한된 용량 때문에 에러가 발생하곤 하죠. 컨텍스트 윈도우(Context Window) 제한은 LLM 애플리케이션을 개발할 때 누구나 마주치는 까다로운 문제입니다. OpenClaw는 이 문제를 해결하기 위해 오래된 기록을 요약하고 정리하는 기능을 제공해요.

필요한 것

• OpenClaw 설치 및 기본 설정
• Provider Catalog에 설정된 모델 정보

빠른 시작

OpenClaw는 컨텍스트 윈도우가 가득 차기 전에 자동으로 기록을 정리하지만, 직접 제어할 수도 있어요. 5분 안에 시작하는 방법입니다.

1. 자동 Compaction 확인: 기본적으로 활성화되어 있습니다. 세션이 모델의 컨텍스트 제한에 도달하면 OpenClaw가 자동으로 요약을 진행해요.
2. 수동 Compaction 실행: 대화 도중 직접 기록을 요약하고 싶다면 /compact 명령어를 입력하세요.
3. 지시 사항 추가: 특정 부분에 집중해서 요약하고 싶다면 뒤에 내용을 덧붙일 수 있습니다.

/compact Focus on decisions and open questions

Compaction이란 무엇인가요?

Compaction은 오래된 대화 내용을 하나의 요약본으로 압축하는 과정이에요. 최근 메시지는 그대로 유지하면서 이전 기록만 요약하기 때문에, 모델은 전체 맥락을 파악하면서도 컨텍스트 공간을 확보할 수 있습니다.

이 요약본은 세션의 JSONL 히스토리에 직접 저장(Persist)됩니다. 따라서 다음 요청부터는 ‘요약본 + 최근 메시지’ 조합이 모델에게 전달돼요.

Compaction vs Pruning

두 기능은 비슷해 보이지만 명확한 차이가 있어요.

• Compaction: 전체 대화를 요약하며, 결과가 JSONL 파일에 영구적으로 저장됩니다.
• Session Pruning: Tool Result만 제거하며, 메모리 상에서만 일시적으로 작동합니다.

문제 해결

컨텍스트가 너무 비대해진 것 같아요

자동 Compaction을 기다리지 말고 /compact 명령어를 직접 사용해 보세요. 세션이 무겁게 느껴질 때 유용합니다.

완전히 새로 시작하고 싶어요

기존 기록을 정리하는 대신 아예 새 세션을 시작하고 싶다면 /new 또는 /reset 명령어를 사용하세요. 새로운 Session ID가 생성됩니다.

Tool 결과가 너무 많아요

OpenClaw는 큰 Tool 출력값을 자동으로 자르지만, 여전히 기록이 쌓인다면 Pruning 설정을 확인해 보세요.

---

더 궁금한 점이 있나요? AI Setup Assistant에게 물어보세요!

다음 단계

• Compaction 설정 및 모드 자세히 보기
• Session Pruning 이해하기
• Memory 설정 및 Durable Notes 알아보기