← Back to Skills Marketplace
220
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install knowair-weather
Description
Get comprehensive air quality forecast from monitoring stations with up to 15-day coverage via the Caiyun Weather API. Returns AQI, PM2.5, PM10, O3, NO2, SO2...
README (SKILL.md)
KnowAir Air Quality — Station-Based AQI Forecast
Query comprehensive air quality forecasts from monitoring stations with up to 15-day coverage using the Caiyun Weather API.
Prerequisites
- A valid Caiyun Weather API token set as
CAIYUN_TOKENenvironment variable, or stored in~/.config/knowair/token. - Coordinates (longitude, latitude) for the target location.
Quick Start
python3 scripts/query_air_quality.py --lng 116.3176 --lat 39.9760
Workflow
- Resolve coordinates — convert city name to coordinates if needed.
- Run the script:
python3 scripts/query_air_quality.py --lng \x3CLNG> --lat \x3CLAT> - Present results — summarize current AQI level, pollutant trends, best/worst periods, and health advice.
Options
| Flag | Description | Default |
|---|---|---|
--lng |
Longitude (-180 to 180) | Required |
--lat |
Latitude (-90 to 90) | Required |
--hours |
Forecast hours (1-360) | 120 |
--detail-level |
Display density 0-6 (0=auto) | 0 |
--lang |
Output language: en or zh |
en |
Defaults
- Hours: 120 (5 days)
- Detail level: auto (0)
- Language:
en
Failure Handling
- Missing token → exit code 2 with setup instructions.
- API error → exit code 1 with error details.
- Station data unavailable → falls back to API forecast data.
Usage Guidance
This skill appears to do what it says: run the included Python script to query Caiyun air-quality APIs. Before installing, ensure you trust the Caiyun token you provide (CAIYUN_TOKEN) and be aware the script will also read ~/.config/knowair/token if present. If you prefer not to store the token on disk, set it only in the environment when running. Confirm you are comfortable allowing network access to api.caiyunapp.com and singer.caiyunhub.com and rotate the token if you later revoke the skill or suspect compromise.
Capability Analysis
Type: OpenClaw Skill
Name: knowair-weather
Version: 1.0.0
The skill is a legitimate tool for querying air quality data from the Caiyun Weather API. The Python script (scripts/query_air_quality.py) uses standard libraries to fetch data and handles API tokens via environment variables or a specific local config file (~/.config/knowair/token), which is standard behavior for such utilities. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill claims to provide Caiyun air-quality forecasts and requires only a Caiyun API token (CAIYUN_TOKEN) and python3. The network calls in the code target Caiyun-related endpoints, which is proportional to the stated purpose.
Instruction Scope
SKILL.md and the script instruct running the included Python script and provide required flags. The runtime reads the CAIYUN_TOKEN environment variable or ~/.config/knowair/token and only performs API requests to Caiyun endpoints; it does not read other system files or environment variables.
Install Mechanism
No install spec is provided (instruction-only plus an included script). Nothing is downloaded or executed from arbitrary URLs and no archives are extracted, so installation risk is low.
Credentials
Only CAIYUN_TOKEN is required (declared as primaryEnv). The token is needed to call Caiyun APIs and the script's fallback of reading ~/.config/knowair/token is documented. No unrelated credentials are requested.
Persistence & Privilege
The skill is not always-enabled and does not request elevated persistence or modify other skills/config. Autonomous invocation is allowed by platform default but not combined with other red flags here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install knowair-weather - After installation, invoke the skill by name or use
/knowair-weather - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of KnowAir Air Quality — station-based AQI forecast:
- Provides comprehensive air quality forecasts (up to 15 days) via Caiyun Weather API.
- Returns AQI, PM2.5, PM10, O3, NO2, SO2, CO values with trend analysis, best/worst periods, and health advice.
- Supports both coordinates and city names for location lookup.
- Customizable forecast duration, detail level, and language output.
- Handles missing API tokens and data fallback scenarios gracefully.
Metadata
Frequently Asked Questions
What is KnowAir Weather 明气天气?
Get comprehensive air quality forecast from monitoring stations with up to 15-day coverage via the Caiyun Weather API. Returns AQI, PM2.5, PM10, O3, NO2, SO2... It is an AI Agent Skill for Claude Code / OpenClaw, with 220 downloads so far.
How do I install KnowAir Weather 明气天气?
Run "/install knowair-weather" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is KnowAir Weather 明气天气 free?
Yes, KnowAir Weather 明气天气 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does KnowAir Weather 明气天气 support?
KnowAir Weather 明气天气 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created KnowAir Weather 明气天气?
It is built and maintained by Shuo Wang (@shuowang-ai); the current version is v1.0.0.
More Skills