A hyper-local weather monitoring tool that alerts you only when severe weather polygons physically intersect your specific address coordinates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nws-warning-bot
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 nws-warning-bot 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 NWS Warning Bot?
The NWS Warning Bot is a technical solution designed to eliminate the noise of broad, county-level weather notifications. While traditional alerts trigger for an entire geographic region, this Openclaw Skills utility uses high-precision spatial geometry to check if your specific house or office falls within National Weather Service (NWS) warning polygons. By utilizing a ray-casting algorithm to process GeoJSON data, the bot ensures you are only notified when a Tornado or Severe Thunderstorm warning is physically headed for your coordinates, making it a vital component for anyone building localized emergency response systems using Openclaw Skills.
NWS Warning Bot Use Cases
- Filtering out irrelevant weather alerts for distant parts of your county.
- Triggering automated home safety protocols only when your specific location is within a warning polygon.
- Integrating high-precision weather intelligence into personal monitoring dashboards.
- Building custom notification bridges for teams that need to know when facilities are in the direct path of a storm.
How NWS Warning Bot Works
- The bot polls the NWS API for active severe weather alerts based on your configured state.
- It retrieves GeoJSON data containing the exact spatial boundaries (polygons) of all active warnings.
- The script executes a ray-casting algorithm to determine if your latitude and longitude intersect with these shapes.
- A local SQLite database is queried to deduplicate alerts, ensuring you aren't notified multiple times for the same event.
- If a new, relevant warning is detected, the bot writes the details to a pending file for external notification scripts to process.
NWS Warning Bot Setup
To get started with this Openclaw Skills automation, first obtain your decimal coordinates from Google Maps or a geocoder. Then, configure your environment and run the bot:
# Set your location variables
export WARNING_BOT_LAT=39.9612
export WARNING_BOT_LON=-82.9988
export WARNING_BOT_ADDRESS="123 Main St, Columbus, OH"
export WARNING_BOT_STATE="OH"
# Run a manual check
python3 scripts/warning-bot.py
# Automate via cron (every 5 minutes)
*/5 * * * * /path/to/warning-bot/scripts/warning-bot-cron.sh
NWS Warning Bot Data Schema & Taxonomy
The bot manages state and output through a simple file-based schema:
| File | Description |
|---|---|
data/warning-bot.db |
SQLite database tracking alert IDs with a 24-hour TTL to prevent duplicate notifications. |
data/alert-pending.txt |
A temporary file created when a warning is detected, containing the alert text for external scripts. |
data/warning-bot.log |
Execution logs for monitoring cron job health and API response status. |
NWS Warning Bot Advanced Features
- Support for complex MultiPolygon geometries to ensure accuracy in multi-cell storm events.
- Built-in deduplication engine using SQLite to manage notification frequency.
- Atomic lock file implementation within the shell wrapper to prevent race conditions during frequent polling.
- Zero-dependency Python architecture that relies strictly on standard libraries for maximum portability.
- Flexible integration architecture allowing easy hand-offs to Telegram, Email, or SMS gateways through Openclaw Skills workflows.
SKILL.md
Loading
Related Openclaw Skills
OpenCal
A powerful AI agent skill to log meals, track nutrition progress, and manage calorie goals hands-free using Openclaw Skills.
Writing Plans
A structured framework to decompose technical designs into granular, 2-5 minute tasks with mandatory verification steps.
Brainstorming
A Socratic design refinement skill that ensures clear technical specifications through collaborative exploration and documentation before implementation.
x402 Payments for AI Agents
An autonomous payment protocol enabling AI agents to conduct machine-to-machine micropayments using HTTP 402 and stablecoins.
Faster Whisper Local Service
A high-performance local speech-to-text microservice providing private, offline transcription for AI-driven voice workflows.
System Commander
A high-efficiency skill that prioritizes native Linux and Python commands over AI inference for file processing and data manipulation.
Featured*
