ClawTrace

ClawTrace란?

ClawTrace는 OpenClaw 에이전트에 대한 관측성을 제공합니다. 에이전트 실행 중에 무슨 일이 일어났는지 이해할 수 있게 해줍니다—무엇이 실패했는지, 비용이 어디서 증가했는지, 다음에 무엇을 변경할지—그래서 신뢰성을 높이고 지출을 줄일 수 있습니다.

이 제품은 실행 수준 뷰와 LLM 호출, 도구 사용, 하위 에이전트 위임의 상세 추적을 결합합니다. 또한 실시간 실행 데이터를 분석하고 맥락 인식 추천을 제공하는 대화형 에이전트 “Tracy”를 포함합니다.

대화형 실행 추적 (페이로드 포함 trace tree): 실행 내 모든 LLM 호출, 도구 사용, 하위 에이전트 위임을 검사하여 문제가 발생한 지점을 정확히 파악하세요.
실행 및 단계별 비용 가시성: 에이전트 실행 전반에 걸친 지출 변화를 확인하고 단계별 비용 급증을 세부 분석하여 예산 누출 지점을 식별하세요.
실패 진단 및 가능한 근본 원인 제시: 불안정한 동작을 추적하고 가능한 원인을 강조하며 개선을 위한 제안 조치를 표시합니다.
그래프 수준 관계 매핑 (call graph): 에이전트, 도구, 모델이 전체 궤적 전반에 걸쳐 어떻게 연결되는지 시각화하세요.
타임라인 병목 및 병렬성 뷰: 간트 차트 스타일 타임라인을 사용하여 단계 간 병목을 발견하고 병렬성을 이해하세요.
모니터링을 위한 궤적 대시보드: 모든 궤적을 메트릭, 일일 추세, 토큰 사용량, 실행 수준 세부 분석으로 확인하세요.
가이드 분석을 위한 “Tracy” doctor 에이전트: 실행 실패 원인, 병목 위치, 비용 절감 방법을 물어보세요; Tracy는 보고 있는 페이지/맥락에 적응합니다.
실시간 데이터 응답: 오래된 대시보드나 지연 보고서가 아닌 실시간 데이터로 답변을 생성합니다.
대화 후속 질문: Tracy는 대화를 기억하고 후속 질문으로 더 깊이 파고듭니다.

OpenClaw 에이전트에 ClawTrace 플러그인 설치: openclaw plugins install @epsilla/clawtrace.
observe 키로 인증: openclaw clawtrace setup.
게이트웨이 재시작: openclaw gateway restart.
에이전트를 평소처럼 실행: 궤적이 자동으로 ClawTrace로 스트리밍되며, 실시간으로 추적, 스팬, 토큰, 비용을 검사할 수 있습니다.
진단 및 추천을 위해 Tracy 사용: 실패, 병목, 비용 절감에 대한 질문을 하고 분석을 세밀하게 조정하세요.

불안정한 OpenClaw 에이전트 디버깅: 동작이 일관되지 않을 때 실행 추적과 trace-tree 탐색을 사용하여 가능한 근본 원인을 찾고 신뢰성을 높일 수 있는 조치를 확인하세요.
비용 급증 조사: 비용이 예상치 않게 증가할 때 에이전트 실행 및 단계별 지출을 검사하여 토큰 사용량이나 지출 증가를 유발하는 단계를 식별하세요.
비효율적인 루핑 제거: 에이전트가 앞뒤로 반복될 때 타임라인과 call graph를 사용하여 진행이 멈춘 지점과 조정해야 할 궤적 부분을 찾으세요.
변경 전후 개선 비교: 더 저렴한 모델로 전환하거나 반복 가능한 단계를 스크립팅하는 등의 변경 후 실행을 평가하기 위해 Tracy를 사용하세요. 실행을 더 안정적으로 유지할 수 있습니다.
다수 궤적 전반 운영 모니터링: 궤적 대시보드를 사용하여 일일 추세, 토큰 사용량, 실행 수준 세부 분석을 검토하고 배포 전반 반복 문제를 포착하세요.

ClawTrace는 OpenClaw 에이전트와 작동하나요? 네. 사이트에서 ClawTrace를 “OpenClaw 에이전트 관측성”으로 설명하며, 설치 가능한 플러그인과 궤적 스트리밍을 포함합니다.
Tracy는 무엇을 분석하나요? Tracy는 보고 있는 실행/궤적 맥락을 분석하고 실행 실패 원인, 병목 위치, 비용 절감 방법에 대한 질문을 답합니다. 실시간 데이터를 사용합니다.
ClawTrace에서 추적과 비용 세부 정보는 어떻게 표시되나요? ClawTrace는 LLM 호출, 도구 사용, 하위 에이전트 위임을 위한 페이로드 포함 대화형 trace tree와 에이전트 실행 및 단계별 지출 뷰를 제공합니다.
사용 전에 통합 설정이 필요한가요? 네. 기본 워크플로우는 플러그인 설치, observe 키 인증, OpenClaw 게이트웨이 재시작입니다.
데이터는 어떻게 최신 상태로 유지되나요? 사이트에서 Tracy의 답변이 실시간 데이터에서 나오며 오래된 대시보드나 지연 보고서가 없다고 명시합니다.

범용 LLM 관측/텔레메트리 도구: LLM 호출에 대한 로그, 추적, 토큰/비용 지표를 제공할 수 있지만, OpenClaw 전용 궤적 뷰(예: 호출 그래프 관계 및 Tracy 스타일 진단)를 제공하지 않을 수 있습니다.
LLM 워크플로용 오픈소스 추적 프레임워크: 이미 추적 파이프라인이 있다면 에이전트 단계와 도구 호출에 대한 맞춤 대시보드 및 디버깅 뷰를 구축할 수 있지만, 턴키 “실행 실패 → 가능한 근본 원인 → 다음 수정” 워크플로를 잃게 됩니다.
워크플로 모니터링 및 분석 대시보드: 운영 지표(지연, 처리량, 오류율)에 중점을 둔 팀을 위해 분석 도구가 문제를 감지하는 데 도움이 될 수 있지만, 페이로드 가시성과 대화형 궤적 드릴다운이 포함된 단계별 실행 추적을 제공하지 않을 수 있습니다.