A developer-friendly tool for creating webhook bins and local tunnels to test, inspect, and replay HTTP requests programmatically.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hookcatch
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install hookcatch 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 HookCatch?
HookCatch is a specialized utility designed for developers who need to capture and analyze webhook data or expose local development environments to the public internet. As one of the versatile Openclaw Skills, it provides a seamless way to create temporary or permanent endpoints that record incoming HTTP requests, making it indispensable for debugging third-party integrations like Stripe, Twilio, or GitHub.
The tool bridges the gap between local development and cloud services by offering robust tunneling capabilities. Whether you are building complex automation or simply need to see exactly what an incoming payload looks like, this integration ensures your development workflow remains uninterrupted, secure, and highly observable.
HookCatch Use Cases
- Testing third-party webhook integrations from services like Stripe, GitHub, or Twilio.
- Exposing a local development server to the public internet for external testing and feedback.
- Programmatically inspecting HTTP request payloads and headers during the development of Openclaw Skills.
- Debugging asynchronous callbacks and webhooks in complex automated workflows.
- Replaying captured requests to different endpoints to test application logic and retry mechanisms.
How HookCatch Works
- Authenticate the CLI using an API token to enable secure communication and account management.
- Create a webhook bin to generate a unique public URL specifically for capturing incoming requests.
- Configure your external service or provider to send data to the generated HookCatch URL.
- Use CLI commands to list, filter, and inspect the captured JSON payloads and headers in real-time.
- Optionally, start a tunnel to forward traffic from a public URL directly to a specific local port on your machine.
HookCatch Setup
To get started, install the HookCatch CLI via npm:
npm install -g hookcatch
Next, generate your API token and set it as an environment variable for automation:
hookcatch token generate
export HOOKCATCH_API_KEY="hc_live_your_token_here"
Verify that your account is correctly configured:
hookcatch status
HookCatch Data Schema & Taxonomy
HookCatch organizes data around bins, requests, and active tunnels. The following table describes the primary data structures used when interacting with this skill:
| Entity | Description | Key Attributes |
|---|---|---|
| Bin | A container for webhook requests | ID, Name, Webhook URL, Privacy Status |
| Request | An individual captured HTTP hit | Method, Headers, Body (JSON), Timestamp |
| Tunnel | A live local-to-public connection | Tunnel ID, Local Port, Public URL, Session Limit |
| Token | Authentication credentials | API Key, Scope, Expiration Status |
HookCatch Advanced Features
- Private bins with password protection to ensure sensitive test data remains secure.
- Programmatic request replaying to trigger local or remote endpoints with historical data.
- Comprehensive JSON output formatting for all commands, making it easy to pipe data into other Openclaw Skills.
- Long-lived API tokens designed for headless environments and automated CI/CD pipelines.
- Support for custom API URL overrides for enterprise or self-hosted configurations.
SKILL.md
Loading
Related Openclaw Skills
ElevenLabs CLI
A comprehensive command-line interface for the ElevenLabs AI audio platform supporting text-to-speech, transcription, and voice cloning.
YouTube Downloader
A high-performance utility for AI agents to download and register high-quality YouTube videos as local assets.
Janitor
An automated maintenance agent designed to keep your AI workspace organized, healthy, and synchronized.
Seedance 2.0 Prompt Generator
A professional-grade prompt engineering engine designed specifically for ByteDance's Seedance 2.0 AI video diffusion model.
China Weather Forecast (weather-china)
A Python-powered weather skill providing 7-day forecasts and life comfort indices for Chinese cities without requiring an API key.
MemOS External Memory Service
A high-performance REST API service for managing persistent long-term memory and knowledge retrieval for AI agents.
Featured*
