Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Checks a local ADS-B SBS/BaseStation TCP feed for aircraft flying within a configurable radius of a home location. Runs as a periodic cron job rather than a daemon, persists cooldown state to avoid duplicate alerts, and sends notifications via WhatsApp through Clawdbot.
Running as a lightweight cron job instead of a persistent daemon means no process management overhead and trivial integration with any scheduler.
When to use it
- Get a WhatsApp ping when a plane flies over your house
- Monitor aircraft near a specific GPS coordinate
- Tune alert radius to catch low-altitude flights only
- Suppress repeat alerts for the same aircraft with cooldowns
- Debug a local readsb setup by testing live position detection
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: notify me on WhatsApp when a plane is within 3 km of my home
- 1Configure home coordinates, radius, and SBS host in the script arguments
- 2Set up a Clawdbot cron job to run the script every 30-60 seconds
- 3Script connects to the readsb TCP feed and listens for position frames
- 4Computes Haversine distance per ICAO hex and checks cooldown state
- 5If stdout is non-empty, Clawdbot sends the alert text as a WhatsApp message
WhatsApp notification with aircraft details when a plane enters the 3 km radius, silenced for that aircraft until the cooldown expires
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.