lossless-claw – OpenClaw를 위한 무손실 컨텍스트 관리

개요

OpenClaw AI 에이전트 플랫폼용 플러그인으로, 기본 슬라이딩 윈도우 방식의 컨텍스트 절단을 무손실 컨텍스트 관리(LCM) 시스템으로 대체합니다.
모든 메시지를 SQLite 데이터베이스에 저장하고 계층적 요약 DAG를 구축하므로, 토큰 윈도우를 초과해도 모델이 정보를 잃지 않습니다.

핵심 개념

영속성 – 모든 원본 메시지는 lcm.db (SQLite)에 기록되며 절대 삭제되지 않습니다.
요약 – 오래된 청크는 구성된 LLM에 의해 요약되며, 요약은 더 높은 수준의 노드로 응축되어 방향성 비순환 그래프(DAG)를 형성합니다.
컨텍스트 조립 – 플러그인은 매 턴마다 최근 원본 메시지와 적절한 요약 노드를 가져와 모델의 토큰 제한 내에 머물도록 합니다.
회상 도구 – lcm_grep, lcm_describe, lcm_expand와 같은 명령어를 통해 에이전트가 압축된 기록을 검색하고 원본 메시지를 다시 확인할 수 있습니다.

상호작용 방법

CLI (lcm) – 데이터베이스를 읽기 전용으로 읽어오는 셸 스타일 인터페이스로, 상태 확인, 대화 목록 보기, 메시지 추적, 요약 보기 및 설정값(freshTailCount) 조정을 지원합니다.
OpenClaw 슬래시 명령어 – /lossless, /lossless backup, /lossless doctor, /lossless status와 같은 채팅 내 명령어를 통해 진단, 백업 생성, 상태 점검 및 유지 관리 작업을 수행합니다.
프로그래밍 계약 – 컨텍스트 엔진 제어를 지원하는 OpenClaw 게이트웨이를 위한 최소한의 호스트 측 API(status, doctor)를 제공합니다.
마이그레이션 도구 – lossless-claw-migrate-sessions를 사용하여 기존 OpenClaw JSONL 세션 파일을 LCM 데이터베이스로 가져옵니다(기본값은 dry-run, --apply 옵션 사용 가능).

설치 및 설정

# 권장 – OpenClaw 플러그인 설치 프로그램 사용
openclaw plugins install @martian-engineering/lossless-claw@latest

구성

OpenClaw JSON 설정 파일의 plugins.entries 아래에 lossless-claw 항목을 추가합니다(전체 예시는 README 참조). 주요 설정 항목:
- freshTailCount – 요약에서 보호되는 최근 메시지 수.
- leafChunkTokens – 리프 청크 요약을 트리거하는 토큰 제한.
- summaryModel / expansionModel – 요약 및 요약 확장에 사용할 모델.
- 각종 임계값(LCM_CONTEXT_THRESHOLD, LCM_PROACTIVE_THRESHOLD_COMPACTION_MODE 등) – 압축 실행 시점 및 인라인/지연 실행 여부를 제어합니다.
환경 변수(LCM_ 접두사)를 통해서도 동일한 옵션을 설정할 수 있습니다.

유지 관리 워크플로우

대화가 토큰 윈도우를 초과하면 플러그인은 압축 부채(compaction debt)를 기록합니다.
/lossless doctor maintenance로 부채를 나열하고, /lossless doctor apply …를 통해 백업 후 손상된 요약을 복구하거나 비활성 부채를 닫을 수 있습니다.
데이터베이스를 변경할 수 있는 모든 쓰기 작업 전에 자동으로 백업이 생성됩니다.

중요성

추가 정보

위의 모든 세부 정보는 저장소의 README에서 직접 가져왔습니다.

Martian-Engineering/lossless-claw