An automated monitoring tool that tracks local gas prices and provides daily alerts for the cheapest fuel options including Costco.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install test-gas-skill
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 test-gas-skill 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 Gas Price Alert?
The Gas Price Alert skill is a powerful automation utility designed for Openclaw Skills users who want to minimize their fuel expenses. By leveraging OpenStreetMap data and specialized logic for discount stations, it identifies the best places to refuel within a specific radius of any US location. This skill is particularly valuable for those who frequent high-volume retailers like Costco, as it provides estimated pricing and location data without requiring manual searches.
As part of the broader ecosystem of Openclaw Skills, this tool bridges the gap between raw geospatial data and actionable consumer intelligence. It allows developers and everyday users to set up a hands-off monitoring system that identifies market-beating prices for various fuel grades, including 87, 89, 91, and diesel, ensuring you always know where the most cost-effective pump is located before you even leave your house.
Gas Price Alert Use Cases
- Automatically finding the cheapest 87 octane gas within a 20-mile radius of your current ZIP code.
- Scheduling daily 8:00 AM notifications to get a head start on fuel savings for your morning commute.
- Specifically monitoring Costco fuel stations to take advantage of member-only pricing which typically sits below the market average.
- Exporting local gas station data to JSON for personal fuel consumption analytics and budgeting.
How Gas Price Alert Works
- The skill utilizes the OpenStreetMap Overpass API to fetch all registered gas stations within the user-specified geographical boundaries.
- It cross-references the retrieved stations against a database of known discount brands, with a primary focus on identifying Costco locations.
- A calculation engine applies geodesic distance formulas via the Geopy library to determine precise mileage from the search origin.
- For Costco stations, the skill applies a smart price estimation algorithm based on typical regional discount patterns relative to a base price.
- The data is processed and filtered to remove duplicates and sort stations by their proximity and potential value.
- The final summary is delivered through the Openclaw Skills agent, which can be configured to send the report via Telegram or other messaging channels.
Gas Price Alert Setup
To get started with this skill for Openclaw Skills, install the required Python dependencies first:
pip install requests geopy
Run a manual search for gas stations in a specific ZIP code to verify the installation:
python3 scripts/gas_alternative.py --zip 43215 --radius 20 --fuel 87 --summary
If you require real-time scraping capabilities for sites like GasBuddy, you can optionally install Playwright:
pip install playwright
playwright install
Gas Price Alert Data Schema & Taxonomy
The skill produces a structured dataset representing fuel station information. This allows Openclaw Skills to easily parse and display the results in different formats.
| Attribute | Type | Description |
|---|---|---|
name |
String | The trading name of the gas station |
brand |
String | The associated fuel brand (e.g., Costco, Shell) |
distance |
Float | Calculated mileage from the search center |
price_text |
String | A formatted string containing the estimated price per gallon |
is_costco |
Boolean | Specifically identifies if the station is a Costco location |
scraped_at |
ISO8601 | The timestamp of when the search was executed |
Example Output:
{
"name": "Costco Gas",
"brand": "Costco",
"address": "5000 Morse Rd, Columbus, OH 43213",
"distance": 7.9,
"price": 2.69,
"is_costco": true
}
Gas Price Alert Advanced Features
- Cron-based scheduling support for fully hands-free daily gas price briefings.
- Flexible coordinate system supporting both ZIP code lookups and precise latitude/longitude inputs.
- Multi-grade fuel support allowing tracking of regular, mid-grade, premium, and diesel prices.
- Extensible script architecture within Openclaw Skills that allows for integration with the GasBuddy API for real-time price updates.
- Automated Telegram notification delivery using the Openclaw Skills messaging bridge.
SKILL.md
Loading
Related Openclaw Skills
Quick Test
A lightweight diagnostic utility to verify OpenClaw environment stability through automated system checks and command validation.
Personal Assistant
A minimalist productivity and well-being assistant that generates personalized daily briefings and habit tracking routines using Openclaw Skills.
Gas Price Alert
A powerful automation tool for monitoring gas prices and finding the cheapest fuel stations in your area using Openclaw Skills.
Reverse Image Search
A multi-engine reverse image search tool designed to identify image origins and find visually similar content across the web.
Luban CLI
A comprehensive command-line framework for managing the lifecycle of machine learning experiments, training jobs, and inference services.
Lobster
A deterministic workflow runtime for AI agents designed to execute typed JSON pipelines with mandatory human approval gates for side effects.