OpenClaw 사용량 추적 가이드

코딩에 몰입하다 보면 내가 토큰을 얼마나 쓰고 있는지, 남은 크레딧은 얼마인지 궁금할 때가 많아요. 하지만 확인을 위해 매번 브라우저를 열고 각 서비스의 대시보드를 찾아 들어가는 건 흐름을 끊는 번거로운 일이죠. OpenClaw를 사용하면 작업 흐름을 유지하면서 사용량을 바로 확인할 수 있어요.

OpenClaw의 Usage tracking은 단순히 비용을 추정하는 것이 아니라, Provider의 usage endpoint에서 직접 데이터를 가져와요. 덕분에 Provider가 보고한 정확한 사용량 데이터를 OpenClaw 안에서 즉시 확인할 수 있습니다.

필요한 것

이 기능을 사용하려면 다음 조건이 필요해요.

• OpenClaw에 등록된 Provider 인증 정보 (OAuth 토큰 또는 API Key)
• 지원되는 Provider: Anthropic (Claude), GitHub Copilot, Gemini CLI, Antigravity, OpenAI Codex, MiniMax, z.ai

빠른 시작

5분 안에 사용량을 확인하는 방법들을 알려드릴게요.

1. Chat에서 확인하기

Chat 창에 다음 명령어들을 입력해 보세요.

• /status: 현재 세션의 토큰 사용량과 예상 비용(API key 사용 시)을 이모지가 포함된 카드 형태로 보여줍니다.
• /usage tokens: 응답 하단에 토큰 사용량 푸터를 표시합니다. (OAuth는 토큰만 표시)
• /usage full: 상세한 사용량 정보를 푸터에 표시합니다.
• /usage cost: OpenClaw 세션 로그를 집계하여 로컬 비용 요약 정보를 보여줍니다.
• /usage off: 푸터 표시를 끕니다.

2. CLI에서 확인하기

터미널에서도 간단한 명령어로 확인할 수 있어요.

# Provider별 상세 사용량 내역 출력
openclaw status --usage

# 채널 목록과 함께 사용량 스냅샷 확인
openclaw channels list

사용량 확인을 건너뛰고 싶다면 openclaw channels list --no-usage를 입력하면 됩니다.

3. macOS 메뉴바

macOS를 사용 중이라면 메뉴바의 Context 아래에 있는 Usage 섹션에서도 사용량을 확인할 수 있어요.

문제 해결

사용량 정보가 표시되지 않아요

• 해당 Provider와 일치하는 OAuth 또는 API credentials가 설정되어 있는지 확인해 보세요. 인증 정보가 없으면 사용량 데이터는 숨겨집니다.

비용이 표시되지 않아요

• /status에서 예상 비용은 API key를 사용할 때만 표시됩니다. OAuth 방식을 사용하는 경우에는 토큰 정보 위주로 표시될 수 있어요.

---

궁금한 점이 더 있다면 AI Setup Assistant에게 물어보세요!

다음 단계

• Provider 설정 가이드
• CLI 명령어 레퍼런스