Webhook Router for OpenClaw for Openclaw

A versatile webhook receiver and routing engine that connects external services to your agent via secure HTTPS endpoints.

yoder-bawt
v1.0.0
Feb 19, 2026
0
0
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install webhook-router

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-router 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 Router for OpenClaw?

This skill acts as a centralized gateway for managing incoming webhooks from various external services. By leveraging Tailscale Funnel, it provides a secure public HTTPS endpoint that routes traffic directly to specialized handlers within the agent environment. Whether you are managing code repositories, payment notifications, or custom service alerts, this tool ensures that every event is authenticated, logged, and processed efficiently.

It bridges the gap between third-party SaaS platforms and your local automation workflows, enabling real-time responsiveness to external triggers. Using Openclaw Skills like this router allows developers to build complex, event-driven architectures without exposing their local environment to the public internet directly, maintaining a high standard of security and reliability.

Webhook Router for OpenClaw Use Cases

  • Automating notifications and actions based on GitHub push, pull request, or issue events.
  • Processing real-time payment notifications from Stripe to update internal databases or trigger alerts.
  • Integrating custom microservices by registering unique webhook sources and defining bespoke logic.
  • Centralizing audit logs for all incoming external signals within a single workspace for better observability.

How Webhook Router for OpenClaw Works

  1. An external service like GitHub or Stripe sends a JSON payload to your unique Tailscale Funnel URL.
  2. The hooks system intercepts the request and validates the authentication token provided in the X-Hook-Token header.
  3. The main router script inspects the incoming data to identify the source and event type.
  4. The request is dispatched to a specific handler script, such as github.sh or generic.sh, for processing.
  5. The handler executes logic, such as updating a vault, sending a notification, or triggering a follow-up automation.

Webhook Router for OpenClaw Setup

First, ensure your gateway is active to provide the public endpoint:

openclaw gateway start

Next, register a new webhook source to generate your unique URL:

./register.sh github my-repo-name

Finally, configure the generated URL and the X-Hook-Token header in your external service settings (e.g., GitHub repository settings).

Webhook Router for OpenClaw Data Schema & Taxonomy

The skill maintains a structured audit log in JSONL format and organizes metadata through a consistent taxonomy.

Field Description
timestamp ISO 8601 formatted time of receipt
source The registered identifier for the webhook sender
event_type The specific action triggered (e.g., push, release)
payload_hash SHA256 hash of the data for integrity verification
processed Boolean flag indicating successful handler execution

Webhook Router for OpenClaw Advanced Features

  • Extensible handler architecture allowing users to create custom shell scripts in the handlers directory for any service.
  • Multi-channel alerting support via environment variables for platforms like Telegram or generic notification hooks.
  • Integrated vault writing for secure, long-term storage of webhook metadata and state tracking.
  • Support for custom source registration which automatically generates unique endpoint parameters for easy identification.
  • Built-in audit logging for every incoming request to facilitate debugging and historical analysis within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*