iqair
Get real-time air quality data from IQAir API for any location worldwide. Returns AQI (Air Quality Index) with visual indicators and quality levels. Use when asked about air quality, pollution levels, or AQI in specific cities/locations (e.g., "How is the air in Riga?", "Is it safe to go outside in Beijing?", "What's the air quality like?"). Also use when asked about general weather to supplement weather data with air quality information (e.g., "What's the weather in Budapest?", "How's the weather today?").
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/atesluks/iqairWhat This Skill Does
The IQAir skill acts as a bridge between the OpenClaw agent and the global IQAir air quality database. It provides real-time, accurate pollution data for any location on Earth. When invoked, the skill retrieves the Air Quality Index (AQI), categorizes the environmental status using standardized color-coded health indicators, and translates complex data into simple, human-readable advice for the user. It functions as a specialized tool for health-conscious individuals, travelers, and outdoor enthusiasts who need immediate data on current air purity.
Installation
To begin using this skill, ensure you have the OpenClaw environment properly configured. Run the installation command: clawhub install openclaw/skills/skills/atesluks/iqair. Once installed, you must authenticate your access to the IQAir service. Obtain a free Community plan API key from the IQAir dashboard. Set this key as an environment variable in your system configuration by running export IQAIR_API_KEY="your_key_here". This ensures the script has the required permissions to query the API endpoints securely.
Use Cases
This skill is versatile and serves several distinct purposes:
- Health Planning: Checking if it is safe to exercise outdoors in a specific city.
- Travel Support: Getting a quick snapshot of the pollution environment before visiting a new destination.
- Contextual Awareness: Augmenting general weather reports to provide a holistic view of the local climate.
- General Research: Quickly verifying air quality levels for news reports or environmental awareness.
Example Prompts
- "What is the air quality like in downtown Tokyo today? Is it safe for a morning jog?"
- "How does the air look in Paris, France right now?"
- "I'm planning a day trip to Berlin, what is the weather and current air quality there?"
Tips & Limitations
For the most consistent results, use geographic coordinates (latitude and longitude) rather than city names, as location names can sometimes be ambiguous. Always keep the API rate limits in mind: the free plan is restricted to 5 calls per minute and 500 per day. If you receive an error, verify that your environment variable IQAIR_API_KEY is correctly set and active. For highly specific local data, try including the state or province in your location string to help the API resolve the correct sensor network.
Metadata
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 skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-atesluks-iqair": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: external-api, code-execution