← Back to Skills Marketplace
154
Downloads
1
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install qweather-skill
Description
查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。
Usage Guidance
This skill appears to be a straightforward CLI client for QWeather and its requirements are reasonable for that purpose. Before installing or providing credentials: 1) verify the GitHub repository/source code (cargo install --git will compile code from that repo); 2) only provide the QWEATHER_PRIVATE_KEY if you trust the repo and service, and prefer giving the private key as a file with restricted permissions rather than pasting it into open environments; 3) the BASE_URL/GEO_URL env vars let the client talk to custom endpoints — ensure they point to the official QWeather endpoints; 4) if you are unsure, inspect the repository code first or request a packaged release from a trusted source.
Capability Analysis
Type: OpenClaw Skill
Name: qweather-skill
Version: 0.5.0
The qweather-skill is a standard integration for the QWeather API, providing a CLI-based interface (qw) for weather, air quality, and astronomical data. It uses standard environment variables for JWT authentication and follows typical Cargo-based installation patterns. No evidence of data exfiltration, malicious execution, or prompt injection was found in the SKILL.md or _meta.json files.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description (weather queries) match the declared env vars and CLI: QWEATHER_KID, QWEATHER_PROJECT_ID, and a PRIVATE_KEY for JWT are plausible for the QWeather API; BASE_URL and GEO_URL let the client target regional/custom endpoints.
Instruction Scope
SKILL.md only documents installing a CLI (cargo) and using env vars or CLI flags to call QWeather endpoints. It requires reading a private key file (QWEATHER_PRIVATE_KEY points to a .pem path), which implies filesystem access to that key — expected for JWT auth but worth noting as sensitive.
Install Mechanism
No registry-level install spec is present; SKILL.md recommends 'cargo install' or installing from the GitHub repo. Installing via cargo or from a GitHub repo is standard; it compiles and places a binary on disk (moderate-risk if you don't trust the source).
Credentials
Five environment variables are requested; they directly map to authenticating and contacting the QWeather service. The PRIVATE_KEY is sensitive (a file path to a PEM) and is declared as primaryEnv — this is proportionate but requires care with file permissions and supply method.
Persistence & Privilege
always is false, the skill is user-invocable, and there is no instruction to modify other skills or system-wide settings. It does not request persistent platform-level privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install qweather-skill - After installation, invoke the skill by name or use
/qweather-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.5.0
Version 0.5.0 introduces improved geographic flexibility and documentation updates.
- 支持通过经纬度查询全球位置天气，描述文本及参数说明中均已补充（不仅限城市）。
- 新增 geo reverse（经纬度反查行政区划）命令行用法示例。
- 说明文档精简了安装方法；curl+install.sh 安装指引移至官方文档。
- description 字段更新，明确支持城市或经纬度查询。
v0.4.0
**Command-line interface (CLI) structure updated for improved usability and flexibility**
- CLI entry point renamed from qweather to qw; all commands and help now reference qw.
- Command structure refactored to use commands and subcommands (e.g., weather now, weather daily, geo city-lookup) replacing global flag-based dispatch.
- Binary install path updated to provide qw (not qweather) after installation.
- All main query types (weather, grid, air, indices, geo, etc.) now use consistent subcommand syntax and explicit argument patterns.
- Added multiple ways to specify location: --city, --location-id, or --lon/--lat; these options are mutually exclusive.
- Documentation, examples, and quick-reference sections fully updated to match the new CLI structure.
v0.3.1
- Renamed skill from qweather-skill to qweather.
- Upgraded version from 0.2.0 to 0.3.0.
- Switched installation method to Cargo and provided curl + shell installer; removed pip-related instructions.
- Updated authentication to require JWT environment variables and removed API key fallback.
- Changed primary credential to QWEATHER_PRIVATE_KEY.
- Updated CLI command from qweather-skill to qweather.
- Removed Python API documentation and instructions; CLI documentation only.
- Adjusted install metadata to use Cargo.
v0.1.1
- Added missing version, homepage, and metadata fields to SKILL.md.
- Declared required environment variables and primary credential for better environment and deployment management.
- No changes to core functionality or code; documentation and metadata updates only.
v0.1.0
qweather-skill v0.1.0
- Initial release with global city real-time weather, forecast, and air quality queries via command line.
- Supports both JWT and API KEY authentication, configured by environment variables.
- Provides rich CLI commands: realtime weather, daily/hourly forecasts, minutely precipitation (China-only), air quality, indices, warnings, sun/moon/solar info, and grid weather.
- Flexible query parameters (e.g., --type, --days, --hours, --date, --tz, --alt) with clear usage limits by type.
- Advanced features (POI search, air monitoring stations) available via Python API only.
Metadata
Frequently Asked Questions
What is 和风天气?
查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 154 downloads so far.
How do I install 和风天气?
Run "/install qweather-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 和风天气 free?
Yes, 和风天气 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 和风天气 support?
和风天气 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 和风天气?
It is built and maintained by 国冰 (@yinguobing); the current version is v0.5.0.
More Skills