HookCatch

HookCatch - Webhook Testing & Tunneling for OpenClaw

HookCatch is a webhook testing and localhost tunneling tool that lets you:

Perfect for testing webhook integrations (Stripe, Twilio, GitHub, etc.) from your OpenClaw skills.

Quick Start

1. Authenticate with HookCatch:

   hookcatch login
   # Or use API token (recommended for automation):
   hookcatch token generate
   export HOOKCATCH_API_KEY="hc_live_..."
   

2. Create a webhook bin:

   hookcatch bin create --name "Test Stripe Webhooks"
   # Returns: https://hookcatch.dev/b/abc123xyz
   

3. View created bins:

   hookcatch bin list
   

4. View captured requests:

   hookcatch bin requests abc123xyz --format json
   

   hookcatch bin requests --binId abc123xyz --format json
   

Available Commands

Bin Management

Create a new webhook bin:

hookcatch bin create [--name "My Bin"] [--private] [--password "secret"] [--format json]

Returns: Bin ID, webhook URL, and view URL

List your bins:

hookcatch bin list [--format json]

Get requests for a bin:

hookcatch bin requests  [--limit 50] [--format json|table] [--method GET] [--password "secret"]

Show a single request:

hookcatch request   [--format json|pretty] [--password "secret"]

Delete a bin:

hookcatch bin delete  --yes

Update a bin:

hookcatch bin update  --name "New Name"
hookcatch bin update  --private --password "secret123"
hookcatch bin update  --public

Show a single request:

hookcatch request   [--format json|pretty]

Replay a request to a new URL:

hookcatch replay   
hookcatch replay --binId  --requestId  --url 

Localhost Tunneling

Expose your localhost:

hookcatch tunnel 3000
Creates: https://hookcatch.dev/tunnel/xyz789

List active tunnels:

hookcatch tunnel list

Stop a tunnel:

hookcatch stop 

Forward incoming requests from the public URL to your local port 3000.

Tunnel limits:

API Token Management

Generate long-lived API token:

hookcatch token generate
Store the token for automation
export HOOKCATCH_API_KEY="hc_live_..."

Check token status:

hookcatch token status

Revoke token:

hookcatch token revoke --yes

Account status:

hookcatch status
hookcatch whoami

Usage Examples for OpenClaw Skills

Example 1: Test Stripe Webhooks

# Create a bin for Stripe
BIN_URL=$(hookcatch bin create --name "Stripe Test" --format json | jq -r '.url')
Use this URL in Stripe dashboard as webhook endpoint
echo "Configure Stripe webhooks to: $BIN_URL"
Wait for webhooks...
sleep 10
Fetch and analyze captured webhooks
hookcatch bin requests abc123xyz --format json | jq '.[] | {event: .body.type, amount: .body.data.object.amount}'

Example 2: Test Local API

# Start your local API on port 8000
python -m http.server 8000 &
Expose it via tunnel
hookcatch tunnel 8000 --password 
Now external services can reach your local API via:
https://hookcatch.dev/tunnel/xyz789

Example 3: Debug GitHub Webhooks

# Create bin
hookcatch bin create --name "GitHub Webhooks"
In GitHub repo settings, add webhook URL
Trigger events (push, PR, etc.)
View requests
hookcatch bin requests abc123xyz --method POST --limit 10

Integration with OpenClaw Skills

When building OpenClaw skills that need to test webhooks:

// In your skill script
import { exec } from 'child_process';
import { promisify } from 'util';
const execAsync = promisify(exec);
// Create a bin
const { stdout } = await execAsync('hookcatch bin create --format json');
const { binId, url } = JSON.parse(stdout);
// Use the webhook URL in your integration
console.log(Webhook URL: ${url});
// Later, fetch requests
const { stdout: requests } = await execAsync(
  hookcatch bin requests ${binId} --format json
);
const captured = JSON.parse(requests);
// Process captured webhooks
for (const req of captured) {
  console.log(${req.method} ${req.path}: ${JSON.stringify(req.body)});
}

Environment Variables

Benefits for OpenClaw Users

Getting Help

Tips

1. Use API tokens for skills: Generate a token once and use it in HOOKCATCH_API_KEY 2. JSON format for automation: Always use --format json when parsing in scripts 3. Private bins for sensitive data: Use --private for production webhook testing 4. Clean up after testing: Delete bins with hookcatch bin delete to stay within limits

Built for OpenClaw by the HookCatch team 🪝

1. Authenticate with HookCatch:

   hookcatch login
   # Or use API token (recommended for automation):
   hookcatch token generate
   export HOOKCATCH_API_KEY="hc_live_..."
   

2. Create a webhook bin:

   hookcatch bin create --name "Test Stripe Webhooks"
   # Returns: https://hookcatch.dev/b/abc123xyz
   

3. View created bins:

   hookcatch bin list
   

4. View captured requests:

   hookcatch bin requests abc123xyz --format json
   

   hookcatch bin requests --binId abc123xyz --format json
   

1. Use API tokens for skills: Generate a token once and use it in HOOKCATCH_API_KEY 2. JSON format for automation: Always use --format json when parsing in scripts 3. Private bins for sensitive data: Use --private for production webhook testing 4. Clean up after testing: Delete bins with hookcatch bin delete to stay within limits

Built for OpenClaw by the HookCatch team 🪝