메인 콘텐츠로 건너뛰기

​
컨텍스트 윈도우 & 컴팩션

모든 모델에는 컨텍스트 윈도우(확인할 수 있는 최대 토큰 수)가 있습니다. 장시간 실행되는 채팅은 메시지와 도구 결과가 누적되며, 윈도우가 빡빡해지면 OpenClaw 는 한계 내에 머물기 위해 이전 기록을 컴팩션합니다.

​
컴팩션이란 무엇인가

컴팩션은 이전 대화를 요약하여 간결한 요약 항목으로 만들고, 최근 메시지는 그대로 유지합니다. 요약은 세션 기록에 저장되므로, 이후 요청에서는 다음을 사용합니다.
  • 컴팩션 요약
  • 컴팩션 지점 이후의 최근 메시지
컴팩션은 세션의 JSONL 기록에 영구적으로 저장됩니다.

​
구성

openclaw.json에서 agents.defaults.compaction 설정을 사용해 compaction 동작(모드, 목표 토큰 수 등)을 구성하세요.

​
자동 컴팩션(기본값: 켜짐)

세션이 모델의 컨텍스트 윈도우에 근접하거나 초과하면 OpenClaw 가 자동 컴팩션을 트리거하고, 컴팩트된 컨텍스트를 사용해 원래 요청을 재시도할 수 있습니다. 다음이 표시됩니다:
  • 자세한 모드에서 🧹 Auto-compaction complete
  • 🧹 Compactions: <count>를 표시하는 /status
컴팩션 전에 OpenClaw 는 무음 메모리 플러시 턴을 실행하여 영구 노트를 디스크에 저장할 수 있습니다. 자세한 내용과 구성은 Memory를 참고하십시오.

​
수동 컴팩션

/compact 를 사용하여(선택적으로 지침과 함께) 컴팩션 패스를 강제로 실행합니다. 
/compact Focus on decisions and open questions

​
컨텍스트 윈도우 출처

컨텍스트 윈도우는 모델별로 다릅니다. OpenClaw 는 구성된 프로바이더 카탈로그의 모델 정의를 사용하여 한계를 결정합니다.

​
컴팩션 vs 프루닝

  • 컴팩션: 요약을 생성하고 JSONL 에 영구 저장합니다.
  • 세션 프루닝: 이전 도구 결과만 요청 단위로 메모리 내에서 잘라냅니다.
프루닝에 대한 자세한 내용은 /concepts/session-pruning을 참고하십시오.

​
팁

  • 세션이 오래되어 느껴지거나 컨텍스트가 비대해졌을 때 /compact 를 사용하십시오.
  • 큰 도구 출력은 이미 잘려 있으며, 프루닝으로 도구 결과 누적을 더 줄일 수 있습니다.
  • 완전히 새로 시작해야 한다면 /new 또는 /reset 이 새로운 세션 ID 를 시작합니다.