Webhook Debugger for Openclaw

A local development utility to receive, inspect, and replay webhook payloads for seamless API integration testing.

chenxuyaun
v1.0.0
Mar 13, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install webhook-debugger

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install webhook-debugger using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Webhook Debugger?

Webhook Debugger is a specialized utility within the Openclaw Skills ecosystem designed to eliminate the friction of testing third-party integrations. It allows developers to create a local receiver that captures incoming POST requests, providing full visibility into headers, query parameters, and payload bodies.

By providing a local environment to verify signatures and inspect data structures, this tool ensures that your application logic is robust before deploying to production. Whether you are working with payment gateways or CI/CD triggers, this skill simplifies the complex task of debugging asynchronous events.

Webhook Debugger Use Cases

  • Debugging Stripe or PayPal payment notifications locally.
  • Testing GitHub or GitLab repository webhooks without remote deployments.
  • Inspecting raw form submissions and multi-part data from frontend applications.
  • Verifying API payloads and security signatures from providers like Zapier or Make.
  • Capturing and analyzing outgoing webhooks from your own microservices.

How Webhook Debugger Works

  1. The user initiates a local listener using the Openclaw Skills interface or CLI.
  2. The utility binds to a specified local port (defaulting to 3000) and begins listening for incoming HTTP requests.
  3. Upon receiving a request, the tool logs the full context, including timestamped headers and formatted bodies.
  4. Developers can inspect the captured history via the command line to verify data integrity.
  5. Requests can be replayed to a different target URL to test local service logic without re-triggering the external event source.

Webhook Debugger Setup

To start using the Webhook Debugger, ensure you have the Openclaw Skills environment configured and run the following commands:

# Start listening on the default port (3000)
webhook listen

# Or specify a custom port
webhook listen 8080

# Point your external provider to your local or tunneled URL
webhook listen --url https://your-tunnel-provider.com/webhook

Webhook Debugger Data Schema & Taxonomy

The skill maintains a local request history to allow for persistent debugging sessions. Data is organized as follows:

Attribute Description
Request ID Unique identifier for each captured webhook
Timestamp Exact date and time of receipt
Protocol Headers, Query Parameters, and HTTP Method (POST/PUT/etc)
Payload Supports JSON, form-data, and plain text body formats
History Stored locally for retrieval via webhook show or webhook list

Webhook Debugger Advanced Features

  • Request Replay: Re-send any captured webhook to a new target URL for iterative testing.
  • Signature Verification: Tools to validate the authenticity of incoming payloads.
  • Traffic Forwarding: Real-time forwarding of incoming webhooks to secondary local or remote services.
  • History Management: Commands to clear, list, and show detailed logs of previous interactions for clean debugging environments.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*