ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified developer tools Safety 3/5

ngrok-unofficial-webhook-skill

Start an ngrok tunnel to receive incoming webhooks and process them via the LLM. Use when the user asks to listen for webhooks, set up a webhook endpoint, start ngrok, or when another skill (like Zoom RTMS Meeting Assistant) needs a public webhook URL. Receives webhook payloads and lets the LLM decide how to handle them.

Why use this skill?

Learn how to use the ngrok-unofficial-webhook-skill for OpenClaw. Create public tunnels and automate local actions with real-time webhook routing.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/tanchunsiong/ngrok-unofficial-webhook-skill
Or

What This Skill Does

The ngrok-unofficial-webhook-skill serves as a bridge between the public internet and your local OpenClaw agent environment. By leveraging ngrok, this skill creates a secure, public-facing URL that forwards incoming HTTP webhooks directly into your local machine. Once a webhook hits the endpoint, the skill orchestrates the payload processing, utilizing a smart auto-routing mechanism to deliver the data to the appropriate registered skill, or notifying the user if the intent is unclear. It eliminates the friction of manual webhook configuration, acting as the centralized listener for external platforms like Zoom, GitHub, or custom APIs.

Installation

To get started, navigate to your skills directory and clone the repository. Change into the skill folder and execute npm install to resolve all dependencies. You must configure the .env file with your NGROK_AUTHTOKEN obtained from the ngrok dashboard. Ensure the OPENCLAW_BIN and notification channels (like WhatsApp) are correctly set up to allow the agent to inform you of incoming requests. Once configured, you can launch the listener with node scripts/webhook-server.js or manage it as a background process using nohup for persistent connectivity.

Use Cases

This skill is indispensable for scenarios requiring real-time updates from third-party services. Primary use cases include: 1) Integrating Zoom RTMS Meeting Assistant to receive meeting start/stop triggers. 2) Setting up automated workflows where file uploads or repository events on external platforms trigger local bash scripts or Python automation via the webhookCommands feature. 3) Debugging and testing webhook payloads from external APIs in a development environment without deploying to production servers. It is perfect for developers who need their local agent to act as a reactive system responding to live events.

Example Prompts

  1. "OpenClaw, please start an ngrok webhook listener so I can receive Zoom meeting updates."
  2. "Can you set up a webhook endpoint for my local server and let me know when it's live?"
  3. "Start the webhook listener, I'm expecting a notification regarding my latest cloud recording download."

Tips & Limitations

To ensure optimal performance, use a stable domain if your provider supports it, as this prevents the need to update your external service configurations every time the tunnel restarts. Always verify that your skill.json files are correctly formatted, as the listener scans sibling folders to build its routing table. Note that this skill requires an active internet connection and that exposing ports to the web carries inherent risks; ensure your local services listening on the forwarded ports are secured. If no matching skill is found, ensure your notification settings are correct so the agent can alert you to handle the payload manually.

Metadata

Stars982
Views2
Updated2026-02-14
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-tanchunsiong-ngrok-unofficial-webhook-skill": {
      "enabled": true,
      "auto_update": true
    }
  }
}

Tags(AI)

#ngrok#webhooks#automation#integration#tunneling
Safety Score: 3/5

Flags: network-access, code-execution