← Back to Skills Marketplace
hefengweather
by
aaronjager92
· GitHub ↗
· v1.0.0
· MIT-0
103
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install hefeng-weather
Description
查询指定城市的实时天气、逐小时、每日预报及分钟级降水，需配置和风天气API Key后使用。
README (SKILL.md)
和风天气查询技能
🤖 支持平台：飞书 / 微信（文字）
查询实时天气、逐小时预报、每日预报、分钟级降水等
⚠️ 首次使用必读
使用前必须配置和风天气 API Key，否则无法运行！
配置方式：
- 获取 Key：https://www.minimaxi.com/
- 设置环境变量：
export HEFENG_WEATHER_API_KEY="your-key"或创建配置文件：cp config.example.txt config.txt并填入 Key - 验证：
python3 scripts/weather_query.py "北京" --type now
详见下方「首次使用配置」章节。
功能
当用户询问天气时，自动调用和风天气 API：
- 解析用户需求（城市、时间范围）
- 调用对应的和风天气 API
- 格式化返回结果
触发方式
用户发送以下任一方式都会触发：
北京天气怎么样今天会下雨吗上海明天温度深圳空气质量广州逐小时预报天气查询 北京
首次使用配置
1. 获取和风天气 API Key
- 注册和风天气开放平台：https://id.qweather.com/
- 在控制台创建项目，获取 API Key
- 设置环境变量（推荐）：
export HEFENG_WEATHER_API_KEY="your-api-key-here"
2. 配置文件方式（可选）
如果不想设置环境变量，可以创建配置文件：
cp config.example.txt config.txt
# 编辑 config.txt，填入你的 API Key
3. 验证
python3 scripts/weather_query.py "北京" --type now
使用方式
命令行参数
# 实时天气
python3 scripts/weather_query.py "北京" --type now
# 逐小时预报（24小时）
python3 scripts/weather_query.py "北京" --type hourly
# 每日预报（3天）
python3 scripts/weather_query.py "北京" --type daily
# 分钟级降水（未来2小时）
python3 scripts/weather_query.py "北京" --type minutely
返回格式
输出 JSON 格式，便于后续处理。
技术细节
API 端点
| 类型 | 端点 | 说明 |
|---|---|---|
| 实时天气 | /v7/weather/now |
温度/风力/湿度等 |
| 逐小时 | /v7/weather/24h |
未来24小时 |
| 每日预报 | /v7/weather/7d |
未来3-7天 |
| 分钟降水 | /v7/minutely/15m |
未来2小时 |
依赖
- Python 3.8+
requests库：pip install requests
文件结构
hefeng_weather/
├── SKILL.md # 本文件
├── config.example.txt # 配置示例
├── scripts/ # 脚本目录
│ └── weather_query.py # 主脚本
└── references/ # 参考文档
└── README.md # 详细说明
常见问题
Q: 提示"网络请求失败"
A: 检查 API Key 是否正确配置，网络是否畅通
Q: 提示"API返回错误"
A: 检查 API Key 是否有对应接口权限
Q: 提示"城市不存在"
A: 检查城市名称是否正确，可使用城市 ID（如北京=101010100）
城市 ID
常用城市 ID：
| 城市 | ID |
|---|---|
| 北京 | 101010100 |
| 上海 | 101020100 |
| 广州 | 101280101 |
| 深圳 | 101280601 |
| 成都 | 101270101 |
| 武汉 | 101200101 |
| 杭州 | 101210101 |
贡献
欢迎提交 Issue 和 PR！
Usage Guidance
This skill is functionally a simple HeFeng (qweather) weather client and the code appears not to exfiltrate data beyond calls to devapi.qweather.com. However, the registry metadata neglects to declare the required HEFENG_WEATHER_API_KEY environment variable even though SKILL.md and the script require it. Before installing: (1) confirm you are comfortable providing your HeFeng API key to this skill and store the key securely (use environment variable rather than committing to files), (2) review the script yourself to verify only qweather endpoints are called, (3) prefer running the script locally first (python3 scripts/weather_query.py "城市" --type now) to observe behavior, and (4) ask the publisher/registry to update metadata to explicitly list HEFENG_WEATHER_API_KEY so automated permission systems can surface that requirement. If you need higher assurance, request a signed/verified package or a maintainer statement that no other network endpoints are used.
Capability Analysis
Type: OpenClaw Skill
Name: hefeng-weather
Version: 1.0.0
The skill bundle is a legitimate weather query tool for the Hefeng (QWeather) API. The core logic in `scripts/weather_query.py` is transparent, using the standard `requests` library to fetch data from official API endpoints and formatting it for the user. There is no evidence of malicious execution, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md and the Python script are coherent: they implement a HeFeng (qweather) weather query client and only call qweather endpoints. However the registry metadata declares no required env vars while the skill explicitly requires HEFENG_WEATHER_API_KEY — this mismatch is unexpected and should be corrected.
Instruction Scope
Runtime instructions and the script are narrowly scoped: read API key from env or local config file, call devapi.qweather.com endpoints, format and print JSON/text. The SKILL.md does not instruct reading unrelated system files or sending data to other endpoints.
Install Mechanism
Instruction-only skill with a small Python script and a single dependency (requests). No install spec or external downloads; nothing being extracted or executed from third-party URLs.
Credentials
The skill requires a single API key (HEFENG_WEATHER_API_KEY) to function, which is proportionate for a weather client. The concern is that the package/registry metadata did not declare this required environment variable — that omission could lead to unexpected permission/consent behaviour in automated installs.
Persistence & Privilege
No elevated privileges requested, not always-enabled, and the skill does not modify other skills or system-wide agent configs. It only reads a local config file or environment variable as described.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hefeng-weather - After installation, invoke the skill by name or use
/hefeng-weather - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
hengfeng-weather 1.0.0 初始发布：
- 新增基于和风天气 API 的天气查询功能，支持实时天气、逐小时、每日及分钟级降水预报。
- 支持飞书和微信平台的文本查询触发方式。
- 首次使用需配置和风天气 API Key，支持环境变量或配置文件方式。
- 命令行工具支持多种天气类型查询，结果以 JSON 格式返回。
- 附带详细的首次配置说明和常见问题解答。
Metadata
Frequently Asked Questions
What is hefengweather?
查询指定城市的实时天气、逐小时、每日预报及分钟级降水，需配置和风天气API Key后使用。 It is an AI Agent Skill for Claude Code / OpenClaw, with 103 downloads so far.
How do I install hefengweather?
Run "/install hefeng-weather" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is hefengweather free?
Yes, hefengweather is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does hefengweather support?
hefengweather is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created hefengweather?
It is built and maintained by aaronjager92 (@aaronjager92); the current version is v1.0.0.
More Skills