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

# 컴팩션

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

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

## 컴팩션이란 무엇인가

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

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

컴팩션은 세션의 JSONL 기록에 **영구적으로 저장**됩니다.

## 구성

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

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

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

다음이 표시됩니다:

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

컴팩션 전에 OpenClaw 는 **무음 메모리 플러시** 턴을 실행하여
영구 노트를 디스크에 저장할 수 있습니다. 자세한 내용과 구성은 [Memory](/concepts/memory)를 참고하십시오.

## 수동 컴팩션

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

```
/compact Focus on decisions and open questions
```

## 컨텍스트 윈도우 출처

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

## 컴팩션 vs 프루닝

* **컴팩션**: 요약을 생성하고 JSONL 에 **영구 저장**합니다.
* **세션 프루닝**: 이전 **도구 결과**만 요청 단위로 **메모리 내에서** 잘라냅니다.

프루닝에 대한 자세한 내용은 [/concepts/session-pruning](/concepts/session-pruning)을 참고하십시오.

## 팁

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