> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openclaw.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# 컴팩션

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

모든 모델은 **컨텍스트 윈도우**(볼 수 있는 최대 토큰 수)를 가집니다. 장기간 실행되는 채팅은 메시지와 도구 결과를 축적합니다. 윈도우가 꽉 차면, OpenClaw는 제한 내에 머물기 위해 오래된 기록을 **컴팩트**합니다.

## 컴팩션이란

컴팩션은 **오래된 대화를 요약**하여 컴팩트한 요약 항목으로 만들고, 최근 메시지는 그대로 유지합니다. 요약은 세션 기록에 저장되며, 향후 요청에는 다음이 사용됩니다:

* 컴팩션 요약
* 컴팩션 지점 이후의 최근 메시지

컴팩션은 세션의 JSONL 기록에 **지속**됩니다.

## 설정

`openclaw.json`의 `agents.defaults.compaction` 설정을 사용하여 컴팩션 동작(모드, 목표 토큰 등)을 구성합니다.
컴팩션 요약은 기본적으로 불투명 식별자를 보존합니다 (`identifierPolicy: "strict"`). `identifierPolicy: "off"`로 끌 수 있고, `identifierPolicy: "custom"`과 `identifierInstructions`로 사용자 지정 텍스트를 제공할 수도 있습니다.

## 자동 컴팩션 (기본 활성화)

세션이 모델의 컨텍스트 윈도우에 근접하거나 초과할 때, OpenClaw는 자동 컴팩션을 트리거하며 컴팩트된 컨텍스트를 사용하여 원래 요청을 다시 시도할 수 있습니다.

다음과 같은 내용을 볼 수 있습니다:

* 자세한 모드에서 `🧹 Auto-compaction complete`
* `/status`에 `🧹 Compactions: <count>`로 표시

컴팩션 전에, OpenClaw는 **무음 메모리 플러시** 턴을 실행하여 지속 가능한 노트를 디스크에 저장할 수 있습니다. 자세한 내용과 설정은 [메모리](/concepts/memory)를 참조하세요.

## 수동 컴팩션

컴팩션 패스를 강제하려면 (선택적으로 명령어와 함께) `/compact`를 사용하세요:

```
/compact 결정을 내리고 열린 질문에 집중하세요
```

## 컨텍스트 윈도우 소스

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

## 컴팩션 vs 가지치기

* **컴팩션**: JSONL에 요약 및 **지속**됩니다.
* **세션 가지치기**: 오래된 **도구 결과**만을 요청마다 **메모리 내에서** 잘라냅니다.

가지치기 세부사항은 [/concepts/session-pruning](/concepts/session-pruning)을 참조하세요.

## OpenAI 서버 측 컴팩션

OpenClaw는 호환되는 OpenAI 직결 모델에 대해 OpenAI Responses 서버 측 컴팩션 힌트도 지원합니다. 이 기능은 로컬 OpenClaw 컴팩션과는 별개이며 함께 병행할 수 있습니다.

* 로컬 컴팩션: OpenClaw가 요약을 만들어 세션 JSONL에 저장합니다.
* 서버 측 컴팩션: `store` + `context_management`가 활성화되면 OpenAI가 프로바이더 측에서 컨텍스트를 컴팩트합니다.

모델 파라미터와 오버라이드는 [OpenAI 프로바이더](/ko-KR/providers/openai)를 참조하세요.

## 팁

* 세션이 오래되었거나 컨텍스트가 방만해졌다고 느낄 때 `/compact`를 사용하세요.
* 대규모 도구 출력은 이미 잘려 있으며, 가지치기는 도구 결과 축적을 추가로 줄일 수 있습니다.
* 새롭게 시작이 필요하면 `/new` 또는 `/reset`으로 새로운 세션 ID를 시작하세요.