← 返回 Skills 市场

KnowAir Forecast 明气预报

Name: KnowAir Forecast 明气预报
Author: shuowang-ai

作者 Shuo Wang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

220

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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...

使用说明 (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_TOKEN environment 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 — hourly or daily.

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

安全使用建议

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.

功能分析

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.

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install knowair-forecast
安装完成后，直接呼叫该 Skill 的名称或使用 /knowair-forecast 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug knowair-forecast

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题