OpenClaw API 지출을 모니터링하고, 예산을 집행하며, 비용 이상 징후를 로컬에서 감지하는 프라이버시 우선 재무 거버넌스 도구입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install trustlog-guard
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 trustlog-guard 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
TrustLog Guard란 무엇인가요?
TrustLog Guard는 OpenClaw 에이전트를 위해 설계된 전문 재무 거버넌스 스킬입니다. 로컬 세션 로그를 파싱하여 개발자와 사용자에게 AI API 지출에 대한 완전한 가시성을 제공합니다. 메시지, 모델, 세션별로 숨겨진 비용을 드러냄으로써 원시 데이터를 실행 가능한 인사이트로 변환하여 성능 저하 없이 AI 개발이 비용 효율적이고 효율적으로 유지되도록 합니다.
이 스킬은 모든 토큰에는 가격이 있으며, 모든 사용자는 이를 알 권리가 있다는 핵심 원칙에 따라 작동합니다. OpenClaw가 이미 계산하지만 로그 파일에 숨겨져 있는 데이터를 노출함으로써 AI 상호작용을 더 스마트하고 투명하게 만드는 비침해적 감사 도구로 구축되었습니다. Openclaw Skills 생태계의 일부로서, 전적으로 로컬 데이터에서 실행되어 사용자 프라이버시를 우선시합니다.
TrustLog Guard 활용 사례
- 예상치 못한 청구를 피하기 위해 여러 AI 모델에 걸친 일일 및 월간 API 지출 모니터링.
- 급격한 루프 또는 재귀적 에이전트 행동으로 인한 비용 폭주 방지.
- 짧은 요약과 같은 간단한 작업에 저렴한 모델로 전환하여 비용 절감 기회 식별.
- 실시간 진행률 추적 및 소진율 예측을 통한 엄격한 예산 한도 설정.
- 세션 기록을 감사하여 가장 비용이 많이 드는 상호작용을 찾고 컨텍스트 사용 최적화.
TrustLog Guard 작동 원리
- OpenClaw 에이전트 디렉토리 구조 내에 .jsonl 형식으로 저장된 로컬 세션 로그에 액세스합니다.
- 각 메시지 기록을 파싱하여 입력, 출력 및 캐시 관련 비용을 포함한 비용 객체를 추출합니다.
- 기간(오늘, 이번 주, 이번 달), AI 모델 유형 및 특정 세션 식별자별로 재무 데이터를 집계합니다.
- 현재 소비량을 로컬 구성 파일에 저장된 사용자 정의 예산 임계값과 비교합니다.
- 휴리스틱 기반 이상 탐지 규칙 세트를 실행하여 비정상적인 지출 급증 또는 비효율적인 모델 사용을 표시합니다.
- 채팅 인터페이스에서 직접 최적화 팁과 시각적 진행 지표가 포함된 고품질 형식의 보고서를 생성합니다.
TrustLog Guard 설정 가이드
TrustLog Guard를 시작하려면 OpenClaw 에이전트가 세션 로그를 생성하고 있는지 확인하세요. 이 스킬은 로컬 데이터를 읽으므로 외부 API 키나 클라우드 연결이 필요하지 않습니다.
# 스킬은 자동으로 다음 위치에서 로그를 찾습니다:
# ~\/.openclaw\/agents\/{agent}\/sessions\/*.jsonl
# 시작하려면 첫 번째 일일 예산을 설정하세요:
\/budget set daily $5.00
# 장기 거버넌스를 위한 월간 한도를 설정하세요:
\/budget set monthly $100.00
TrustLog Guard 데이터 스키마 및 분류 체계
TrustLog Guard는 기존 OpenClaw 로그를 읽고 예산 추적을 위한 작은 로컬 구성을 유지합니다. 이를 통해 Openclaw Skills의 모든 재무 데이터가 사용자의 컴퓨터에 유지됩니다.
| 위치 | 파일 유형 | 용도 |
|---|---|---|
~\/.openclaw\/agents\/{agent}\/sessions\/ |
.jsonl |
메시지당 비용 및 모델 사용량에 대한 신뢰할 수 있는 소스. |
~\/.openclaw\/workspace\/trustlog-guard\/ |
budgets.json |
일일/월간 한도 및 통화 기본 설정을 저장합니다. |
예산 스키마:
daily: 부동 소수점 (USD)monthly: 부동 소수점 (USD)currency: 문자열 (기본값 "USD")
TrustLog Guard 고급 기능
- 소진율 급증 감지: 최근 메시지 비용이 세션 평균보다 현저히 높은지(5배 임계값) 자동으로 식별합니다.
- 모델 에스컬레이션 알림: 세션 도중 Haiku와 같은 저렴한 모델에서 Opus와 같은 비싼 모델로 전환될 때 표시합니다.
- 캐시 비효율 분석: cacheWrite 대 cacheRead 값을 추적하여 재사용되지 않는 컨텍스트에 낭비되는 지출을 강조합니다.
- 급격한 루프 보호: 단일 세션 내에서 10분 이내에 20개 이상의 메시지가 발생하면 알림을 트리거합니다.
- 자동 최적화 팁: 짧은 출력 작업에 대해 비싼 모델을 저렴한 대안으로 전환할 때 예상되는 절감액을 제공합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
도서 토론 (멀티 렌즈)
다각도 토론을 통해 사용자가 책, 사상가 또는 개인 메모의 아이디어를 깊이 이해하도록 돕는 정교한 분석 엔진입니다.
Visual File Sorter
컴퓨터 비전을 사용하여 어지러운 로컬 파일을 식별하고 이름을 변경하며 보관하는 지능형 파일 관리 에이전트입니다.
Vibe Harvester
사용자의 미적 취향에 따라 고품질 참조 사진을 선별하고 다운로드하기 위해 이미지 플랫폼을 자동으로 스크롤하는 지능형 시각 보조 도구입니다.
태스크 와치독 (Task Watchdog)
장시간 실행되는 컴퓨터 작업을 모니터링하고 방해되는 팝업을 자동으로 제거하여 중단 없는 완료를 보장하는 디지털 가디언입니다.
Jina DeepSearch
Jina AI의 고급 검색 모델을 사용하여 AI 에이전트가 근거 있는 정보를 검색할 수 있도록 하는 고성능 심층 검색 기능입니다.
추천*
