컨텍스트 윈도우 & 컴팩션
모든 모델은 컨텍스트 윈도우(볼 수 있는 최대 토큰 수)를 가집니다. 장기간 실행되는 채팅은 메시지와 도구 결과를 축적합니다. 윈도우가 꽉 차면, OpenClaw는 제한 내에 머물기 위해 오래된 기록을 컴팩트합니다.컴팩션이란
컴팩션은 오래된 대화를 요약하여 컴팩트한 요약 항목으로 만들고, 최근 메시지는 그대로 유지합니다. 요약은 세션 기록에 저장되며, 향후 요청에는 다음이 사용됩니다:- 컴팩션 요약
- 컴팩션 지점 이후의 최근 메시지
설정
openclaw.json의 agents.defaults.compaction 설정을 사용하여 컴팩션 동작(모드, 목표 토큰 등)을 구성합니다.
컴팩션 요약은 기본적으로 불투명 식별자를 보존합니다 (identifierPolicy: "strict"). identifierPolicy: "off"로 끌 수 있고, identifierPolicy: "custom"과 identifierInstructions로 사용자 지정 텍스트를 제공할 수도 있습니다.
자동 컴팩션 (기본 활성화)
세션이 모델의 컨텍스트 윈도우에 근접하거나 초과할 때, OpenClaw는 자동 컴팩션을 트리거하며 컴팩트된 컨텍스트를 사용하여 원래 요청을 다시 시도할 수 있습니다. 다음과 같은 내용을 볼 수 있습니다:- 자세한 모드에서
🧹 Auto-compaction complete /status에🧹 Compactions: <count>로 표시
수동 컴팩션
컴팩션 패스를 강제하려면 (선택적으로 명령어와 함께)/compact를 사용하세요:
컨텍스트 윈도우 소스
컨텍스트 윈도우는 모델 관련입니다. OpenClaw는 구성된 프로바이더 카탈로그의 모델 정의를 사용하여 제한을 결정합니다.컴팩션 vs 가지치기
- 컴팩션: JSONL에 요약 및 지속됩니다.
- 세션 가지치기: 오래된 도구 결과만을 요청마다 메모리 내에서 잘라냅니다.
OpenAI 서버 측 컴팩션
OpenClaw는 호환되는 OpenAI 직결 모델에 대해 OpenAI Responses 서버 측 컴팩션 힌트도 지원합니다. 이 기능은 로컬 OpenClaw 컴팩션과는 별개이며 함께 병행할 수 있습니다.- 로컬 컴팩션: OpenClaw가 요약을 만들어 세션 JSONL에 저장합니다.
- 서버 측 컴팩션:
store+context_management가 활성화되면 OpenAI가 프로바이더 측에서 컨텍스트를 컴팩트합니다.
팁
- 세션이 오래되었거나 컨텍스트가 방만해졌다고 느낄 때
/compact를 사용하세요. - 대규모 도구 출력은 이미 잘려 있으며, 가지치기는 도구 결과 축적을 추가로 줄일 수 있습니다.
- 새롭게 시작이 필요하면
/new또는/reset으로 새로운 세션 ID를 시작하세요.