A high-precision weather forecasting skill providing up to 15 days of daily and 360 hours of hourly meteorological data via the Caiyun Weather API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install knowair-forecast
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 knowair-forecast 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 KnowAir Forecast?
KnowAir Forecast is a robust technical integration designed to empower AI agents with real-time meteorological intelligence. By leveraging the Caiyun Weather API, this Openclaw Skills contribution provides granular data including temperature trends, precipitation probability, wind speeds, humidity, and life indices. It is built for developers who need reliable, coordinate-based weather insights for automation or user assistance.
The skill excels in delivering structured weather content that is both human-readable and machine-parsable. Whether you are building a travel assistant or a localized notification bot, KnowAir Forecast ensures your agent has access to hyper-local data with configurable detail levels, making it a versatile addition to the Openclaw Skills ecosystem.
KnowAir Forecast Use Cases
- Planning outdoor events or travel by querying 15-day daily trends.
- Real-time rain alerts using high-resolution hourly precipitation data.
- Temperature trend analysis for smart home or energy management optimizations.
- Generating localized weather reports for specific GPS coordinates within a CLI or agent workflow.
How KnowAir Forecast Works
- The agent receives a location-based query and resolves it to specific longitude and latitude coordinates.
- The system checks for a valid CAIYUN_TOKEN in the environment variables or local configuration files.
- The script executes a request to the Caiyun Weather API based on the requested forecast type (hourly or daily).
- Data is processed to filter for specific metrics like temperature, humidity, and wind based on the user-defined detail level.
- The skill returns a structured summary of the forecast, highlighting significant weather shifts or precipitation risks.
KnowAir Forecast Setup
To integrate this among your Openclaw Skills, ensure you have python3 installed and follow these steps:
- Obtain a Caiyun Weather API token.
- Export the token as an environment variable:
export CAIYUN_TOKEN='your_api_token_here'
- Alternatively, store the token locally:
mkdir -p ~/.config/knowair/ && echo 'your_api_token_here' > ~/.config/knowair/token
- Run a test query:
python3 scripts/query_forecast.py --lng 116.3176 --lat 39.9760 --type daily --days 7
KnowAir Forecast Data Schema & Taxonomy
The skill utilizes a structured parameter set to define the API request and output density. Below are the primary configuration options:
| Parameter | Type | Description | Range |
|---|---|---|---|
--lng |
Float | Longitude of the target location | -180 to 180 |
--lat |
Float | Latitude of the target location | -90 to 90 |
--type |
String | Forecast interval | hourly, daily |
--hours |
Integer | Hourly forecast duration | 1 to 360 |
--days |
Integer | Daily forecast duration | 1 to 15 |
--detail-level |
Integer | Data granularity (0 is auto-adjust) | 0 to 6 |
KnowAir Forecast Advanced Features
- Multi-language support (English and Chinese) for international deployments.
- Configurable detail levels (0-6) to balance between data depth and token economy in LLM contexts.
- Robust error handling for missing tokens, API rate limits, and network connectivity issues.
- Deep integration with Openclaw Skills protocols for seamless coordinate-to-weather workflows.
SKILL.md
Loading
Related Openclaw Skills
KnowAir Historical
A specialized AI agent skill for fetching historical weather, precipitation, and air quality data for the past 72 hours via the Caiyun API.
Workshop Outline Generator
An AI-powered instructional design tool that generates structured, activity-based workshop outlines using professional educational frameworks.
GitCode Release Notes Generator
An AI-powered tool that transforms GitCode commit history into professional, categorized Markdown release notes.
Short Video Script Generator
An AI-powered scriptwriting engine that generates platform-optimized short video content using psychological triggers and retention-focused structures.
Feishu Meeting Summary
A professional automation for Openclaw Skills that converts Feishu meeting records into structured documentation and methodology-driven knowledge bases.
GCP Project Bootstrap
A professional AI skill for creating and bootstrapping Google Cloud projects using industry-standard least-privilege principles and workload-specific configurations.
Featured*
