An aviation monitoring skill that detects nearby aircraft from local ADS-B feeds and triggers automated notifications based on proximity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install moltbot-adsb-overhead
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install moltbot-adsb-overhead 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 adsb-overhead?
The adsb-overhead skill is a technical utility designed for aviation enthusiasts and home automation power users. By tapping into a local readsb SBS/BaseStation TCP feed, this addition to the Openclaw Skills library enables precise tracking of aircraft within a user-defined radius. It specifically focuses on local detection, making it an ideal choice for users running their own ADS-B receivers who want to bridge the gap between raw data and actionable notifications.
Unlike complex daemons, this skill is optimized for efficiency, designed to run as a periodic cron job. It leverages the Haversine formula to calculate the exact distance of aircraft from your home coordinates. By integrating this into the ecosystem of Openclaw Skills, developers can transform raw aviation data into smart alerts for various messaging platforms, ensuring they are always aware of interesting air traffic passing directly overhead.
adsb-overhead Use Cases
- Creating a localized aircraft notification system for home aviation tracking.
- Monitoring specific airspace radius for nearby flight activity.
- Automating WhatsApp or system alerts via Clawdbot when aircraft enter a defined perimeter.
- Calibrating and troubleshooting the range of local ADS-B receiver setups.
How adsb-overhead Works
- The script initiates a TCP connection to a local readsb SBS feed, typically on port 30003.
- It listens to the feed for a configurable duration to gather position frames and aircraft identifiers (ICAO hex codes).
- Using the provided latitude and longitude, the skill calculates the distance of each detected aircraft from your home location.
- It filters aircraft that fall within the specified kilometer radius.
- The skill consults a local state file to check if an alert for a specific aircraft was recently sent, respecting a user-defined cooldown period.
- Detected aircraft meeting all criteria are output to stdout for notification processing.
adsb-overhead Setup
To integrate this into your environment of Openclaw Skills, ensure you have a local SBS feed available. You can manually test the detection script using the following command:
python3 skills/public/adsb-overhead/scripts/sbs_overhead_check.py \
--host <SBS_HOST> --port 30003 \
--home-lat <LAT> --home-lon <LON> \
--radius-km 2 \
--listen-seconds 5 \
--cooldown-min 15
For automation, configure a Clawdbot cron watcher to execute the script every 30-60 seconds and forward non-empty output to your preferred messaging channel.
adsb-overhead Data Schema & Taxonomy
The skill manages its operational state and configuration through a simple but effective data structure:
| Feature | Details |
|---|---|
| State Storage | JSON file located at ~/.clawdbot/adsb-overhead/state.json |
| Identity Tracking | Uses ICAO hex codes as unique keys for aircraft state |
| Input Format | Standard SBS/BaseStation TCP stream (Port 30003) |
| Coordinate System | WGS84 Decimal Degrees for home and aircraft positioning |
adsb-overhead Advanced Features
- Intelligent cooldown management to prevent notification spam for loitering aircraft.
- Configurable sample windows (listen-seconds) to optimize detection reliability on busy feeds.
- Persistence of alert history to ensure consistent notification behavior across script restarts.
- Easy integration with Openclaw Skills cron watchers for hands-off, 24/7 aviation monitoring.
SKILL.md
Loading
Related Openclaw Skills
clinkding
A modern Go-based CLI for managing bookmarks, tags, and assets in a self-hosted Linkding instance.
AISP Agent Inference Sharing
A decentralized protocol enabling AI agents to rent or provide Venice API capacity using USDC escrow on the Base network.
Snow Report
A high-performance snow reporting skill that tracks conditions and forecasts for over 1000 ski resorts worldwide.
Tado Smart Thermostat Control
A comprehensive integration for managing Tado smart thermostats, zones, and energy usage through automated API commands.
Radio Copilot
A satellite pass orchestrator that sends real-time dish alignment data and WhatsApp alerts for manual or automated SDR reception.
GOYFILES External Bot Access
The core integration contract for external bots to securely onboard and interact with GOYFILES datasets and graph search tools.
METADATA
Featured*
