# Send HookCatch to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hookcatch",
    "name": "HookCatch",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/HookCatch/hookcatch",
    "canonicalUrl": "https://clawhub.ai/HookCatch/hookcatch",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/hookcatch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hookcatch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "bin/hookcatch-skill.js",
      "package.json",
      "README.md",
      "SKILL.md",
      "STRUCTURE.md",
      "test.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "hookcatch",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T05:24:17.026Z",
      "expiresAt": "2026-05-11T05:24:17.026Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hookcatch",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hookcatch",
        "contentDisposition": "attachment; filename=\"hookcatch-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "hookcatch"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/hookcatch"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hookcatch",
    "downloadUrl": "https://openagent3.xyz/downloads/hookcatch",
    "agentUrl": "https://openagent3.xyz/skills/hookcatch/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hookcatch/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hookcatch/agent.md"
  }
}
```
## Documentation

### HookCatch - Webhook Testing & Tunneling for OpenClaw

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

Create webhook bins to capture and inspect HTTP requests
Tunnel your localhost to test webhooks locally
Manage bins and view captured requests programmatically

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

### Quick Start

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



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



View created bins:
hookcatch bin list



View captured requests:
hookcatch bin requests abc123xyz --format json

OR
hookcatch bin requests --binId abc123xyz --format json

### Bin Management

Create a new webhook bin:

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

Options:

--name: Optional bin name for organization
--private: Create private bin (PLUS+ tier required)
--password: Set password for private bin (min 4 chars)
--format: Output format (json recommended for automation)

Returns: Bin ID, webhook URL, and view URL

List your bins:

hookcatch bin list [--format json]

Shows all your bins with request counts and status.

Get requests for a bin:

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

Options:

--limit: Number of requests to fetch (default: 50)
--format: Output format - json for scripts, table for viewing
--method: Filter by HTTP method (GET, POST, etc.)
--password: Password for private bins (if required; owners can use their auth token)

Show a single request:

hookcatch request <requestId> <binId> [--format json|pretty] [--password "secret"]

Delete a bin:

hookcatch bin delete <binId> --yes

Update a bin:

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

Show a single request:

hookcatch request <requestId> <binId> [--format json|pretty]

Replay a request to a new URL:

hookcatch replay <binId> <requestId> <url>
hookcatch replay --binId <binId> --requestId <requestId> --url <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 <tunnelId>

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

Tunnel limits:

FREE: 5 min/session, 3 sessions/day
PLUS: 1h/session, unlimited
PRO/ENTERPRISE: Unlimited

### 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

### 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 <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

HOOKCATCH_API_KEY - API token for authentication (recommended for automation)
HOOKCATCH_API_URL - Override API URL (default: https://api.hookcatch.dev)

### Benefits for OpenClaw Users

No more ngrok setup: Use HookCatch tunnels for quick local testing
Webhook inspection: See exactly what Stripe/Twilio/etc. is sending
Automation-friendly: JSON output for easy parsing in skills
Private bins: Keep your test data secure with password protection
Fast & simple: One command to create bins or tunnels

### Getting Help

Documentation: https://docs.hookcatch.dev
Discord: Join #hookcatch in OpenClaw Discord
GitHub: https://github.com/hookcatch/cli
Email: support@hookcatch.dev

### Tips

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

Built for OpenClaw by the HookCatch team 🪝
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: HookCatch
- Version: 1.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T05:24:17.026Z
- Expires at: 2026-05-11T05:24:17.026Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/hookcatch)
- [Send to Agent page](https://openagent3.xyz/skills/hookcatch/agent)
- [JSON manifest](https://openagent3.xyz/skills/hookcatch/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/hookcatch/agent.md)
- [Download page](https://openagent3.xyz/downloads/hookcatch)