OpenClaw 컨텍스트 미터 플러그인은 텔레그램 토큰 사용 백분율을 표시합니다

기능 설명

openclaw-context-meter 플러그인은 텔레그램 봇 응답마다 자동으로 토큰 사용률 백분율을 표시합니다. 각 응답 후에 다음과 같은 작은 푸터를 보냅니다: 📊 45k / 200k (22%). 압축이 발생하면(토큰이 크게 감소하면) 다음과 같이 표시합니다: 📊 30k / 200k (15%) — 150k에서 압축됨.

해결하는 문제

이전에는 /status를 계속 입력하지 않고는 컨텍스트 창이 얼마나 채워져 있는지 쉽게 확인할 방법이 없었습니다. 이 플러그인은 토큰 소비에 대한 자동 가시성을 제공합니다.

개발 과정

v1 — OOM 재앙: 처음에는 execSync("openclaw models list --json")를 사용하여 모델 컨텍스트 창을 동적으로 탐색했습니다. 이로 인해 플러그인이 로드될 때마다 전체 OpenClaw 프로세스(~2GB RAM)가 생성되었습니다. 플러그인이 시작 시 4-5번 로드되면(에이전트/런타임당 한 번씩) 다음과 같은 문제가 발생했습니다: 2GB 게이트웨이 + 5 × 2GB 하위 프로세스 = 12GB → 즉시 OOM. OOM 킬러가 sshd와 NetworkManager를 종료시켜 서버를 완전히 접근 불가능하게 만들고 무한 재시작 루프를 생성했습니다.

v2 — 경량화된 수정: 40개 이상의 모델에 대해 컨텍스트 창을 하드코딩했습니다. 하위 프로세스 없음, 메모리 오버헤드 제로. 핵심 깨달음: OpenClaw 플러그인에서는 execSync를 절대 사용하지 말 것, 간단한 CLI 쿼리조차도 모든 플러그인과 TypeScript 컴파일이 포함된 전체 런타임을 생성하기 때문입니다.

포크가 필요 없는 이유

이 플러그인은 원래 before_compaction/after_compaction 훅을 패치하기 위해 OpenClaw를 포크했지만, 업스트림 변경으로 인해 이 작업이 불필요해졌습니다:

• v2026.3.13+ — 업스트림이 이제 압축 훅 컨텍스트에 sessionId + agentId + sessionKey를 전달합니다
• v2026.3.22+ — 내장된 🧹 컨텍스트 압축 중... 알림(이슈 #38805)으로 인해 그들의 압축 코드가 불필요해졌습니다
• v2026.3.22+ — 기본 토큰 표시를 위한 내장 /usage tokens|full|cost 명령어

이 플러그인은 이제 여전히 부족한 부분에 집중합니다: 컨텍스트 창 백분율 표시.

기능

• 비용 없음 — agent_end + message_sent 훅만 사용, 추가 API 호출 없음
• 하위 프로세스 없음 — 모델 컨텍스트 창이 하드코딩됨(execSync OOM 위험 없음)
• 스마트 필터링 — tool_use 턴을 건너뛰고, 최종 텍스트 응답 후에만 푸터를 보냄
• 디바운싱 — 마지막 메시지 후 1.5초 대기하여 스트림 중간에 푸터가 나타나지 않도록 함
• 다중 에이전트 — 여러 에이전트와 텔레그램 계정에서 작동
• 압축 감지 — 토큰 감소를 감지하고 이전/이후 통계를 표시

알려진 제한 사항

• 일부 제공업체(예: Qwen)는 totalTokens: 0을 반환합니다 — 해당 모델에서는 푸터가 표시되지 않습니다
• 하드코딩된 컨텍스트 창이 새로운 모델에 대해 잘못될 수 있습니다 — v2026.3.22 소스에서 가져옴
• 현재 텔레그램만 지원합니다(푸터를 Bot API를 통해 보냄)

설치 방법

cd ~/.openclaw/extensions
npm pack openclaw-context-meter
tar xzf openclaw-context-meter-*.tgz
mv package context-meter
rm openclaw-context-meter-*.tgz

openclaw.json에 추가:

{
  "plugins": {
    "allow": ["context-meter"],
    "entries": {
      "context-meter": {
        "enabled": true
      }
    }
  }
}

OpenClaw >= 2026.3.22 필요.