[인공지능/OpenClaw] 클로드 사용량 보여주기

디스코드랑 연결 된 오픈클로에서 클로드(모델)의 사용량 (5시간 세션, 주간 리밋)을 보여주고 싶었다.

메인 프로바이더를 OpenAI로 쓰고 있기는 한데 복잡한 코딩을 할 때에는 클로드(앤트로픽)을 사용하라고 설정한 상태이다.

단 오픈클로 사용량이 95% 이상이 되면 백업으로 OpenAI로 코딩을 하라고 설정하고 싶었고, 전제 조건으로 어떻게든 클로드 사용량을 가져와야만 했다.

 

처음 시도한 방법은, 오픈클로가 설치 된 우분투에 xrdp를 연결하여 크롬 브라우저를 실행해서 사용량 페이지(https://claude.ai/settings/usage)를 띄어놓고 캡쳐해서 OCR을 통해 사용량을 보여주게 했는데 크게 2가지 문제가 있었다.

1. 해상도나 xrdp 상태에 따라서 캡쳐가 안되거나 OCR이 제대로 안  돈다.

2. 이미지 OCR 해석하는 API 초과 ( 딱히 어디라고 지정 안 했는데 오픈클로가 어딘가랑 연동하고 알아서 해석하고 있었다 )

 

위와 같은 이유로 다른 방법을 찾던 중 GUI가 아닌 TUI를 이용하면 될까 싶어서 진행했는데 너무 잘 되서 방법을 작성한다.

---

준비사항

1. (오픈클로 설치 환경에서) 클로드 CLI 설치

2. (오픈클로 설치 환경에서) tmux 설치 및 세션 실행

3. 이전 단계에서 생성 tmux 세션에서 claude 실행

---

준비사항을 끝마쳤으면 위 사진처럼 클로드 대화창이 나타나 있어야 한다.

 

 

그럼 이제 오픈클로한테 적당한 프롬프트를 주면 되는데 몇 가지 조건을 붙였다.

1. 현재 & 주간 전부 보여줄 것

2. 세션 초기화 시간이랑 그때까지 얼마나 남았는지 보여줄 것 ( 0 단위 제외 )

3. 현재 또는 주간 세션 중 하나라도 85% 이상이면 디스코드에서 나를 태그에서 알람 전송

시간을 들여 몇번씩 수정하면서 테스트를 했고 만족스럽게 실행이 되서, 오픈클로한테 설정 방법을 프롬프트로 만들어 달라고 했더니 아래처럼 나왔다.

 

## OpenClaw용 Claude 사용량 수집 프롬프트

Claude 사용량을 **이미지 OCR 없이 tmux 텍스트만**으로 수집하세요.

### 1) 대상
- tmux pane: `openclaw_claude_usage:1.1`

### 2) 실행 순서
1. pane에 `/usage` 입력 후 Enter
2. **10초 대기**
3. 아래 명령으로 텍스트 캡처
- `tmux capture-pane -p -J -t openclaw_claude_usage:1.1 -S -160`
4. 캡처 텍스트에서 아래 항목 파싱
- `Current session`의 `% used` + `Resets ...`
- `Current week (all models)`의 `% used` + `Resets ...`
5. 수집 후 **Esc 1회** 눌러 usage 패널 닫기
6. 값이 안 나오면 **최대 3회 재시도**

### 3) 시간 처리 규칙 (Asia/Seoul)
- `Resets Feb 24, 2am`처럼 날짜+시간이면 그대로 사용
- `Resets 2am`처럼 **시간만 있으면**:
- 아직 안 지난 시각이면 **오늘**
- 이미 지난 시각이면 **내일**
- 남은 시간 표기:
- 앞쪽 0 단위는 생략
- 중간 0 단위는 유지
- 예: `47분`, `2일 0시간 47분`

### 4) 출력 형식 (한국어)
- `Claude 현재 세션: <percent>% 사용 / <리셋시각> 재설정 / <남은시간> 남음`
- `Claude 주간 한도: <percent>% 사용 / <리셋시각> 재설정 / <남은시간> 남음`
- `판정: <주의|정상>`

### 5) 판정 기준
- 현재 세션 또는 주간 한도 중 하나라도 **85% 이상**이면 `주의`
- 그 외는 `정상`

 

 

프롬프트 잘 넘겨주면 디코로 알람이 잘 온다.