← 返回 Skills 市场
220
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install knowair-weather - 安装完成后，直接呼叫该 Skill 的名称或使用
/knowair-weather触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 220 次。
如何安装 KnowAir Weather 明气天气？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install knowair-weather」即可一键安装，无需额外配置。
KnowAir Weather 明气天气 是免费的吗？
是的，KnowAir Weather 明气天气 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
KnowAir Weather 明气天气 支持哪些平台？
KnowAir Weather 明气天气 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 KnowAir Weather 明气天气？
由 Shuo Wang（@shuowang-ai）开发并维护，当前版本 v1.0.0。
推荐 Skills