← Back to Skills Marketplace
220
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install knowair-forecast
Description
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...
README (SKILL.md)
KnowAir Forecast — Hourly & Daily Weather Forecasts
Query detailed hourly and daily weather forecasts for any location 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_forecast.py --lng 116.3176 --lat 39.9760 --type daily --days 7
Workflow
- Resolve coordinates — convert city name to longitude and latitude if needed.
- Choose forecast type —
hourlyordaily. - Run the script:
python3 scripts/query_forecast.py --lng \x3CLNG> --lat \x3CLAT> --type \x3CTYPE> - Present results — highlight temperature ranges, precipitation probability, and notable weather changes.
Options
| Flag | Description | Default |
|---|---|---|
--lng |
Longitude (-180 to 180) | Required |
--lat |
Latitude (-90 to 90) | Required |
--type |
hourly or daily |
daily |
--hours |
Hours to forecast (1-360, hourly mode) | 48 |
--days |
Days to forecast (1-15, daily mode) | 7 |
--detail-level |
Display density 0-6 (0=auto, 1=every hour, etc.) | 0 |
--lang |
Output language: en or zh |
en |
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
- examples.md — usage examples
Usage Guidance
This skill appears to do what it says: it will use your CAIYUN_TOKEN (from the CAIYUN_TOKEN env var or ~/.config/knowair/token) and send requests to https://api.caiyunapp.com to fetch forecasts for coordinates you provide. Before installing: (1) only provide a Caiyun API token that you control and avoid putting it in public repos or shared locations; (2) be aware the skill will transmit coordinates and your token to Caiyun's API (normal for a weather client); (3) if you prefer not to store the token in ~/.config/knowair/token, set CAIYUN_TOKEN as an environment variable instead; (4) confirm you are comfortable with network access to api.caiyunapp.com and that the token has appropriate scope/limits. The only minor transparency issue is the README/script reading ~/.config/knowair/token while registry metadata lists no config paths — that is not dangerous, but you should be aware the file-path fallback exists.
Capability Analysis
Type: OpenClaw Skill
Name: knowair-forecast
Version: 1.0.0
The skill is a legitimate weather forecast tool that queries the Caiyun Weather API. The Python script `scripts/query_forecast.py` follows standard practices for API token management, reading from environment variables or a local configuration file, and performs network requests only to the official API endpoint (api.caiyunapp.com). No malicious patterns, suspicious instructions, or data exfiltration risks were identified.
Capability Assessment
Purpose & Capability
Name/description (weather forecasts via Caiyun) match the code and declared requirements: the script calls api.caiyunapp.com, needs CAIYUN_TOKEN, and requires python3. There are no unrelated credentials or binaries requested.
Instruction Scope
SKILL.md workflow and CLI usage match the included Python script. The instructions only direct running the script, providing coordinates, and handling the CAIYUN_TOKEN; they do not request unrelated files, system state, or external endpoints beyond Caiyun.
Install Mechanism
No install spec is provided (instruction-only + an included script). Nothing is downloaded or installed automatically, so disk/writing risk is minimal.
Credentials
The only required secret is CAIYUN_TOKEN (declared as primary). One minor inconsistency: registry metadata lists no required config paths, but SKILL.md and the script will also read ~/.config/knowair/token as an alternative token location. This is a minor transparency gap but not a functional mismatch.
Persistence & Privilege
always is false and the skill does not request persistent or elevated privileges or modify other skill/system configs. Autonomous invocation is allowed by default (normal) but does not materially increase risk here given minimal scope.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install knowair-forecast - After installation, invoke the skill by name or use
/knowair-forecast - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of knowair-forecast.
- Provides hourly (up to 360 hours) and daily (up to 15 days) weather forecasts by latitude and longitude via Caiyun Weather API.
- Returns temperature trends, weather conditions, precipitation probability, wind, humidity, and life indices.
- Supports configurable detail levels and language selection.
- Requires python3, internet access, and a valid Caiyun Weather API token.
Metadata
Frequently Asked Questions
What is KnowAir Forecast 明气预报?
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... It is an AI Agent Skill for Claude Code / OpenClaw, with 220 downloads so far.
How do I install KnowAir Forecast 明气预报?
Run "/install knowair-forecast" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is KnowAir Forecast 明气预报 free?
Yes, KnowAir Forecast 明气预报 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does KnowAir Forecast 明气预报 support?
KnowAir Forecast 明气预报 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created KnowAir Forecast 明气预报?
It is built and maintained by Shuo Wang (@shuowang-ai); the current version is v1.0.0.
More Skills