Sponsored by Vmake Labs Video Enhancer - Vmake Labs Video Enhancer는 AI를 활용해 동영상 화질을 개선하고, 디테일을 복원하며, 흐림을 줄이고 최대 8K까지 업스케일링합니다.

AI 광고 라이브러리

Openclaw Skills

Session Compactor

Openclaw용 Session Compactor

초기 메시지 기록을 간결하고 밀도 높은 요약으로 압축하여 토큰 소비를 최적화하는 자동화된 세션 관리 도구입니다.

fangbb-coder

v1.0.0

Apr 2, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install session-compactor

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 session-compactor 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Session Compactor란 무엇인가요?

Session Compactor는 AI Agent와의 장기적인 대화를 관리하기 위해 설계된 특수 유틸리티입니다. 대화가 길어질수록 컨텍스트 윈도우를 많이 소비하고 운영 비용이 증가합니다. 이 스킬은 토큰 수를 모니터링하고 오래된 메시지를 프로그래밍 방식으로 구조화된 요약으로 대체하여 이러한 문제를 해결합니다. 이를 통해 Agent는 중요한 컨텍스트, 도구 실행 기록 및 핵심 사실을 유지하면서 새로운 상호 작용을 위한 공간을 확보합니다. Session Compactor를 Openclaw Skills 제품군에 통합하면 장기간 비용 효율적이고 문맥을 잘 이해하는 고성능 AI 워크플로우를 유지할 수 있습니다.

Session Compactor 활용 사례

메시지 수가 30개를 초과하고 모델 컨텍스트 제한에 가까워지는 세션 관리.
긴 대화에서 반복적인 토큰 전송을 최소화하여 운영 비용 절감.
장황하거나 불필요한 대화 기록은 삭제하고 중요한 도구 실행 결과는 보존.
복잡한 추론 또는 코딩 작업을 시작하기 전에 대화 기록을 수동으로 최적화.

Session Compactor 작동 원리

토큰 추정: 이 스킬은 휴리스틱 방법(토큰당 약 4자)을 사용하여 현재 세션 길이를 계산합니다.
임계값 감지: 현재 토큰 수가 사용자가 정의한 maxTokens 제한을 초과하는지 지속적으로 확인합니다.
대상 선택: 알고리즘은 가장 최근 메시지는 그대로 유지하면서 압축할 오래된 메시지를 식별합니다.
요약 생성: 세션 목표, 도구 호출 결과 및 필수 사실을 하나의 구조화된 요약으로 추출합니다.
메시지 대체: 초기 기록은 요약이 포함된 시스템 메시지로 영구적으로 대체되어 토큰 사용량을 크게 줄입니다.

Session Compactor 설정 가이드

이 스킬을 활성화하려면 openclaw.config.json 구성 파일을 업데이트하세요:

{
  "skills": {
    "session-compactor": {
      "enabled": true,
      "maxTokens": 3000,
      "minMessagesToKeep": 5,
      "autoCompact": true
    }
  }
}

CLI를 통해 수동으로 세션 압축을 트리거하려면 다음 명령어를 사용하세요:

openclaw tools call compact_session '{"force": true}'

Session Compactor 데이터 스키마 및 분류 체계

이 스킬은 다음 매개변수와 메타데이터 분류 체계를 통해 세션 데이터를 구성합니다:

매개변수	유형	기본값	설명
`maxTokens`	number	3000	자동 압축을 트리거하는 토큰 임계값.
`minMessagesToKeep`	number	5	자세한 내용을 보존할 최근 메시지의 최소 개수.
`autoCompact`	boolean	true	세션 업데이트 시 백그라운드 압축 활성화 또는 비활성화.
`force`	boolean	false	토큰 수와 관계없이 세션을 강제로 압축하도록 수동 재정의 허용.