← 返回 Skills 市场
154
总下载
1
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install qweather-skill
功能描述
查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。
安全使用建议
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.
功能分析
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.
能力标签
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install qweather-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/qweather-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
和风天气 是什么？
查询全球城市或者经纬度位置的实时天气、天气预报、空气质量等信息的技能。当用户询问某个城市或者经纬度的天气、气温、降雨、风向、空气质量时调用。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 154 次。
如何安装 和风天气？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install qweather-skill」即可一键安装，无需额外配置。
和风天气 是免费的吗？
是的，和风天气 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
和风天气 支持哪些平台？
和风天气 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 和风天气？
由 国冰（@yinguobing）开发并维护，当前版本 v0.5.0。
推荐 Skills