토큰 사용 및 비용

OpenClaw은 문자가 아닌 토큰을 추적합니다. 토큰은 모델별로 다르지만, 대부분의 OpenAI 스타일 모델은 영어 텍스트에서 토큰당 약 4자입니다.

시스템 프롬프트 구축 방법

OpenClaw은 매 실행마다 자체 시스템 프롬프트를 조립합니다. 포함 항목:

• 도구 목록 + 간단한 설명
• 스킬 목록 (메타데이터만; 지시사항은 read로 요청 시 로드)
• 워크스페이스 + 부트스트랩 파일
• 시간 (UTC + 사용자 시간대)
• 런타임 메타데이터

컨텍스트 창에 포함되는 것

모델이 받는 모든 것이 컨텍스트 한도에 포함:

• 시스템 프롬프트
• 대화 기록
• 도구 호출 및 도구 결과
• 첨부 파일/트랜스크립트
• 압축 요약 및 프루닝 아티팩트

현재 토큰 사용량 확인 방법

채팅에서 사용:

• /status → 세션 모델, 컨텍스트 사용량, 마지막 응답 토큰, 예상 비용(API 키 전용)이 포함된 상태 카드.
• /usage off|tokens|full → 모든 응답에 사용량 푸터 추가.
• /usage cost → OpenClaw 세션 로그에서 로컬 비용 요약 표시.

비용 추정 (표시될 때)

비용은 모델 가격 설정에서 추정:

models.providers.<provider>.models[].cost

100만 토큰당 USD로 input, output, cacheRead, cacheWrite. 가격이 없으면 토큰만 표시. OAuth 토큰은 달러 비용을 표시하지 않음.

캐시 TTL 및 프루닝 영향

프로바이더 프롬프트 캐싱은 캐시 TTL 창 내에서만 적용. OpenClaw은 선택적으로 cache-ttl 프루닝을 실행할 수 있습니다.

하트비트가 유휴 갭 사이에서 캐시를 따뜻하게 유지할 수 있습니다.

자세한 노브별 가이드는 프롬프트 캐싱을 참조하세요.

토큰 압력 줄이기 팁

• /compact로 긴 세션 요약.
• 워크플로에서 큰 도구 출력 줄이기.
• 스크린샷이 많은 세션에서 agents.defaults.imageMaxDimensionPx 낮추기.
• 스킬 설명을 짧게 유지 (스킬 목록이 프롬프트에 주입됨).
• 장황하고 탐색적인 작업에는 더 작은 모델 선호.