KnowAir Air Quality 明气空气质量

v1.0.0

Get hourly (up to 360 hours) and daily (up to 15 days) weather forecasts by latitude and longitude via the Caiyun Weather API. Returns temperature trends, we...

0· 238· 1 versions· 1 current· 1 all-time· Updated 13h ago· MIT-0
byShuo Wang@shuowang-ai·duplicate of @shuowang-ai/knowair-forecast

Install

openclaw skills install knowair-air-quality

KnowAir Forecast — Hourly & Daily Weather Forecasts

Query detailed hourly and daily weather forecasts for any location using the Caiyun Weather API.

Prerequisites

  1. A valid Caiyun Weather API token set as CAIYUN_TOKEN environment variable, or stored in ~/.config/knowair/token.
  2. Coordinates (longitude, latitude) for the target location.

Quick Start

python3 scripts/query_forecast.py --lng 116.3176 --lat 39.9760 --type daily --days 7

Workflow

  1. Resolve coordinates — convert city name to longitude and latitude if needed.
  2. Choose forecast typehourly or daily.
  3. Run the script:
    python3 scripts/query_forecast.py --lng <LNG> --lat <LAT> --type <TYPE>
    
  4. Present results — highlight temperature ranges, precipitation probability, and notable weather changes.

Options

FlagDescriptionDefault
--lngLongitude (-180 to 180)Required
--latLatitude (-90 to 90)Required
--typehourly or dailydaily
--hoursHours to forecast (1-360, hourly mode)48
--daysDays to forecast (1-15, daily mode)7
--detail-levelDisplay density 0-6 (0=auto, 1=every hour, etc.)0
--langOutput language: en or zhen

Defaults

  • Forecast type: daily
  • Days: 7, Hours: 48
  • Detail level: auto (0)
  • Language: en

Failure Handling

  • Missing token → exit code 2 with setup instructions.
  • API error → exit code 1 with error details.
  • Network unreachable → suggest the user check connectivity.

Additional Resources

Version tags

latestvk970czvnmdt7n5dyw4vxtm3pdh82rtex

Runtime requirements

📅 Clawdis
Binspython3
EnvCAIYUN_TOKEN
Primary envCAIYUN_TOKEN