Python 앱과 LLM 에이전트에 OpenTelemetry 트레이스, 메트릭, 로그를 계측하는 관측성 도구 Pydantic Logfire용 Python SDK입니다.
comet-ml/opik-openclaw
에이전트 트레이스, 도구 호출, 토큰 사용량 및 비용을 Opik으로 전송해 관측성을 제공하는 공식 OpenClaw 플러그인입니다.
- 스타
- 726
- 포크
- 87
- 열린 이슈
- 17
- 마지막 커밋
- 17일 전
어떤 프로젝트인가요?
opik-openclaw는 에이전트 실행 데이터를 오픈소스 LLM 관측성 및 평가 플랫폼인 Opik으로 전송하는 공식 OpenClaw 플러그인입니다. LLM 요청 및 응답 스팬, 하위 에이전트 스팬, 입력·출력·오류가 포함된 도구 호출 스팬과 사용량 및 비용을 비롯한 실행 단위 메타데이터를 기록합니다.
이 플러그인은 OpenClaw Gateway 프로세스 내에서 실행되므로, 원격 게이트웨이를 사용하는 경우 해당 호스트에 설치하고 구성해야 합니다. 대화형 CLI 설정 마법사(openclaw opik configure)를 통해 설정할 수 있으며, OPIK_API_KEY 및 OPIK_PROJECT_NAME과 같은 환경 변수로도 설정을 지정할 수 있습니다.
llm_input, llm_output, before_tool_call, after_tool_call, subagent_spawned, agent_end 등의 OpenClaw 라이프사이클 이벤트를 Opik 트레이스와 스팬에 매핑하며, 실행이 끝나면 대기 중인 스팬을 모두 닫습니다.
핵심 기능
- 01LLM 요청 및 응답을 Opik 스팬으로 추적합니다.
- 02도구 호출의 입력, 출력, 오류 및 실행 시간을 수집합니다.
- 03요청자 트레이스에 하위 에이전트의 라이프사이클 스팬을 기록합니다.
- 04실행마다 토큰 사용량 및 비용 메타데이터를 보고합니다.
- 05대화형 설정 마법사와 구성 상태를 확인하는 status 명령을 제공합니다.
활용 사례
- OpenClaw 에이전트의 비용과 토큰 사용량을 모니터링합니다.
- 여러 단계로 진행되는 에이전트 실행에서 실패한 도구 호출을 디버깅합니다.
- 대화 트레이스에서 하위 에이전트의 동작을 살펴봅니다.
빠른 시작
- 1
OpenClaw에 플러그인을 설치합니다
openclaw plugins install clawhub:@opik/opik-openclaw - 2
설정 마법사로 플러그인을 구성합니다
openclaw opik configure - 3
Gateway를 시작하고 테스트 메시지를 보냅니다
openclaw gateway run
사용 전 알아둘 점
- OpenClaw 2026.9.7 이상, Node.js 24.16 이상, npm 10 이상이 필요합니다.
- 구성하려면 Opik 계정 또는 셀프 호스팅 Opik 인스턴스와 API 키가 필요합니다.
- OpenClaw Gateway를 실행하는 호스트에 설치해야 합니다. 원격 Gateway를 사용하는 경우 유의하세요.
포함된 컬렉션
토픽
자주 묻는 질문
- opik-openclaw은(는) 무엇인가요?
- 에이전트 트레이스, 도구 호출, 토큰 사용량 및 비용을 Opik으로 전송해 관측성을 제공하는 공식 OpenClaw 플러그인입니다. opik-openclaw는 에이전트 실행 데이터를 오픈소스 LLM 관측성 및 평가 플랫폼인 Opik으로 전송하는 공식 OpenClaw 플러그인입니다. LLM 요청 및 응답 스팬, 하위 에이전트 스팬, 입력·출력·오류가 포함된 도구 호출 스팬과 사용량 및 비용을 비롯한 실행 단위 메타데이터를 기록합니다.
- opik-openclaw은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- opik-openclaw은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- opik-openclaw은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. opik-openclaw의 마지막 커밋은 2026년 10월 5일입니다.
- opik-openclaw은(는) 어디에 사용할 수 있나요?
- OpenClaw 에이전트의 비용과 토큰 사용량을 모니터링합니다. 여러 단계로 진행되는 에이전트 실행에서 실패한 도구 호출을 디버깅합니다. 대화 트레이스에서 하위 에이전트의 동작을 살펴봅니다.
- opik-openclaw는 어떻게 설치하나요?
- OpenClaw에 플러그인을 설치합니다: openclaw plugins install clawhub:@opik/opik-openclaw 설정 마법사로 플러그인을 구성합니다: openclaw opik configure Gateway를 시작하고 테스트 메시지를 보냅니다: openclaw gateway run
- opik-openclaw은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/comet-ml/opik-openclaw
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
AI 에이전트 추적, LLM 출력 평가, 프롬프트 관리, 프로덕션 모니터링을 위한 오픈소스 LLM 옵저버빌리티 및 평가 플랫폼입니다.
ClickHouse 기반으로 로그, 트레이스, 메트릭, 세션 리플레이와 오류를 검색하고 시각화하는 오픈소스 옵저버빌리티 플랫폼입니다.
여러 관측 백엔드로 트레이스, 메트릭, 로그를 수집·처리·내보내는 벤더 중립 서비스입니다.
Python 앱에서 LLM 호출, 벡터 DB 쿼리, 에이전트 프레임워크를 추적하는 OpenTelemetry 기반 오픈소스 관측성 확장 기능입니다.
호스트에서 메트릭, 로그, 트레이스, 프로파일을 수집해 Datadog 플랫폼으로 전송하는 Datadog의 오픈소스 에이전트입니다.