원활한 API 통합 테스트를 위해 Webhook Payload를 수신, 검사 및 재생하는 로컬 개발 유틸리티입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install webhook-debugger
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 webhook-debugger 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
Webhook Debugger란 무엇인가요?
Webhook Debugger는 타사 통합 테스트의 마찰을 제거하도록 설계된 Openclaw Skills 에코시스템 내의 전문 유틸리티입니다. 개발자는 들어오는 POST 요청을 캡처하는 로컬 수신기를 생성하여 Headers, 쿼리 매개변수 및 Payload 본문에 대한 전체 가시성을 제공할 수 있습니다.
서명을 확인하고 데이터 구조를 검사하는 로컬 환경을 제공함으로써 이 도구는 프로덕션에 배포하기 전에 애플리케이션 로직이 견고한지 확인합니다. 지불 게이트웨이 또는 CI/CD 트리거를 사용하든 이 스킬은 비동기 이벤트를 디버깅하는 복잡한 작업을 단순화합니다.
Webhook Debugger 활용 사례
- 로컬에서 Stripe 또는 PayPal 결제 알림 디버깅.
- 원격 배포 없이 GitHub 또는 GitLab 저장소 Webhook 테스트.
- 프런트엔드 애플리케이션의 원시 양식 제출 및 멀티파트 데이터 검사.
- Zapier 또는 Make와 같은 제공업체의 API Payload 및 보안 서명 확인.
- 자체 마이크로서비스에서 나가는 Webhook 캡처 및 분석.
Webhook Debugger 작동 원리
- 사용자가 Openclaw Skills 인터페이스 또는 CLI를 사용하여 로컬 리스너를 시작합니다.
- 유틸리티가 지정된 로컬 포트(기본값 3000)에 바인딩되고 들어오는 HTTP 요청을 수신 대기하기 시작합니다.
- 요청을 받으면 도구는 타임스탬프가 찍힌 Headers 및 형식화된 본문을 포함한 전체 컨텍스트를 기록합니다.
- 개발자는 명령줄을 통해 캡처된 기록을 검사하여 데이터 무결성을 확인할 수 있습니다.
- 외부 이벤트 소스를 다시 트리거하지 않고 로컬 서비스 로직을 테스트하기 위해 요청을 다른 대상 URL로 재생할 수 있습니다.
Webhook Debugger 설정 가이드
Webhook Debugger 사용을 시작하려면 Openclaw Skills 환경이 구성되었는지 확인하고 다음 명령을 실행하십시오.
# 기본 포트(3000)에서 수신 대기 시작
webhook listen
# 또는 사용자 지정 포트 지정
webhook listen 8080
# 외부 제공업체가 로컬 또는 터널링된 URL을 가리키도록 설정
webhook listen --url https:\/\/your-tunnel-provider.com\/webhook
Webhook Debugger 데이터 스키마 및 분류 체계
이 스킬은 영구적인 디버깅 세션을 허용하기 위해 로컬 요청 기록을 유지합니다. 데이터는 다음과 같이 구성됩니다.
| 속성 | 설명 |
|---|---|
| 요청 ID | 캡처된 각 Webhook의 고유 식별자 |
| 타임스탬프 | 수신된 정확한 날짜 및 시간 |
| 프로토콜 | Headers, 쿼리 매개변수 및 HTTP 메서드 (POST/PUT 등) |
| Payload | JSON, form-data 및 일반 텍스트 본문 형식 지원 |
| 기록 | webhook show 또는 webhook list를 통해 검색할 수 있도록 로컬에 저장됨 |
Webhook Debugger 고급 기능
- 요청 재생: 반복 테스트를 위해 캡처된 Webhook을 새 대상 URL로 다시 보냅니다.
- 서명 확인: 들어오는 Payload의 신뢰성을 검증하는 도구입니다.
- 트래픽 전달: 들어오는 Webhook을 보조 로컬 또는 원격 서비스로 실시간 전달합니다.
- 기록 관리: 깨끗한 디버깅 환경을 위해 이전 상호 작용의 세부 로그를 지우고, 나열하고, 표시하는 명령입니다.
SKILL.md
로드 중
관련 Openclaw 스킬
Zhou Hongyi AI Insight Skill
Zhou Hongyi의 AI 전략과 Openclaw 생태계에 대한 깊은 통찰력을 제공하는 포괄적인 지식 및 프로토콜 기술입니다.
LiblibAI 이미지 생성 스킬
전문적인 텍스트-이미지 및 이미지-이미지 워크플로우를 위해 LiblibAI 플랫폼을 활용하는 종합적인 AI 이미지 생성 스킬입니다.
macOS Automator 서비스 컬렉션
Finder 컨텍스트 메뉴에서 직접 고속 파일 처리 및 이미지 조작을 위한 5개의 macOS Automator 워크플로우로 구성된 종합 제품군입니다.
OpenClaw Chat With Friends
공유되고 동기화된 Telegram 채널에서 여러 OpenClaw 봇과 친구들을 연결하여 원활한 소셜 상호작용을 가능하게 합니다.
Local Memory
Openclaw Skills 내에서 안전하고 의미론적인 장기 저장을 위해 ChromaDB 및 BGE-small-zh를 사용하는 오프라인 벡터 메모리 도구입니다.
Historical Weather AI Agent Skill
AI 에이전트가 특정 도시 및 날짜의 온도, 바람, 대기질을 포함한 상세한 과거 날씨 기록을 조회하기 위한 전문 기술입니다.
추천*
