← Back to Skills Marketplace
135
Downloads
1
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install cs-qweather-alert
Description
和风天气查询工具集，支持实时天气查询和天气预警查询。当用户询问城市天气、气温、湿度、刮风下雨等天气状况，或需要查询预警时触发。
README (SKILL.md)
和风天气-天气查询与天气预警查询
和风天气查询工具集 — 支持实时天气查询和天气预警查询两个功能。
技能职责
当需要查询某个城市的实时天气、每日天气预报或天气预警时使用此 skill。
脚本清单
| 脚本 | 功能 |
|---|---|
qweather-get-weather-now.py |
实时天气查询 |
qweather-get-weather-alert.py |
天气预警查询 |
qweather-get-weather-daily.py |
每日天气预报（3/7/10/15/30天） |
qweather_utils.py |
公共工具库（供上述脚本调用） |
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
QWEATHER_API_HOST |
✅ | 和风 API Host，格式为 https://xxx.re.qweatherapi.com |
QWEATHER_CITY |
否 | 默认城市名，作为命令行参数的备用 |
环境变量加载：脚本使用
dotenv库自动从~/.openclaw/.env加载变量（override=True，强制读取最新值避免旧进程缓存干扰），在 OpenClaw 环境下无需手动配置即可使用。Token 配置：JWT Token 默认从
~/.myjwtkey/last-token.dat读取，也可通过--token参数显式传入。
qweather-get-weather-now.py — 实时天气
查询城市当前天气状况，包括温度、湿度、风力、气压等详细信息。
命令
python3 cs-qweather-alert/scripts/qweather-get-weather-now.py \x3C城市名> [--host API_HOST] [--token TOKEN]
示例
# 查询北京实时天气
python3 cs-qweather-alert/scripts/qweather-get-weather-now.py 北京
# 指定 API Host
python3 cs-qweather-alert/scripts/qweather-get-weather-now.py 上海 --host https://md78m2kdwa.re.qweatherapi.com
# 通过环境变量设置默认城市
export QWEATHER_CITY=南京
python3 cs-qweather-alert/scripts/qweather-get-weather-now.py
输出字段
| 字段 | 说明 |
|---|---|
obsTime |
数据观测时间 |
temp |
温度（°C） |
feelsLike |
体感温度（°C） |
text |
天气状况文字 |
windDir / windScale / windSpeed |
风向 / 风力等级 / 风速（km/h） |
humidity |
相对湿度（%） |
precip |
过去1小时降水量（mm） |
pressure |
大气压强（hPa） |
vis |
能见度（km） |
cloud |
云量（%） |
dew |
露点温度（°C） |
示例输出
🌤️ 北京 实时天气
🕐 2026-04-09 22:48 🌫️ 雾 10°C（体感 8°C）
────────────────────────────────────────
💨 风力 ······ 西南风 1级 (4 km/h)
💧 湿度 ······ 96%
🌧️ 降水量 ···· 0 mm
🌡️ 气压 ······ 999 hPa
👁️ 能见度 ···· 3 km
☁️ 云量 ······ 91%
🌫️ 露点 ······ 8°C
────────────────────────────────────────
📡 QWeather | 2026-04-09 22:52
qweather-get-weather-daily.py — 每日天气预报
查询城市未来 3-30 天天气预报，包含最高/最低温度、天气状况、风力风向、降水概率、紫外线指数、日出日落、月相等信息。
命令
python3 cs-qweather-alert/scripts/qweather-get-weather-daily.py \x3C城市名> [--days 7] [--host API_HOST] [--token TOKEN]
参数
| 参数 | 默认值 | 说明 |
|---|---|---|
--days |
7 | 预报天数，支持 3/7/10/15/30 天 |
示例
# 查询北京 7 天预报（默认）
python3 cs-qweather-alert/scripts/qweather-get-weather-daily.py 北京
# 查询上海 15 天预报
python3 cs-qweather-alert/scripts/qweather-get-weather-daily.py 上海 --days 15
# 查询广州 30 天预报
python3 cs-qweather-alert/scripts/qweather-get-weather-daily.py 广州 --days 30
输出字段
| 字段 | 说明 |
|---|---|
fxDate |
预报日期 |
tempMax / tempMin |
最高 / 最低温度（°C） |
textDay / textNight |
白天 / 夜间天气文字 |
iconDay / iconNight |
白天 / 夜间天气图标 |
windDirDay / windScaleDay |
白天风向 / 风力等级 |
precip |
预报当天总降水量（mm） |
uvIndex |
紫外线指数 |
sunrise / sunset |
日出 / 日落时间 |
moonPhase / moonrise / moonset |
月相 / 月升 / 月落 |
humidity |
相对湿度（%） |
示例输出
📅 北京 7天天气预报
────────────────────────────────────────────────────────────
今天 04-27 | ⛅多云 | 9°C~22°C | 北风1-3级 | 💧无降水 | 紫外线: 8(极强)
明天 04-28 | ☀️晴 | 9°C~22°C | 北风1-3级 | 💧无降水 | 紫外线: 9(极强)
后天 04-29 | ☀️晴 | 10°C~25°C | 西南风1-3级 | 💧无降水 | 紫外线: 9(极强)
周四 04-30 | ☀️晴 | 15°C~29°C | 西南风1-3级 | 💧无降水 | 紫外线: 9(极强)
周五 05-01 | ⛅多云→☁️阴 | 14°C~25°C | 南风1-3级 | 💧无降水 | 紫外线: 4(较强)
周六 05-02 | ☀️晴 | 12°C~25°C | 西南风1-3级 | 💧无降水 | 紫外线: 9(极强)
周日 05-03 | ☀️晴→☁️阴 | 15°C~28°C | 西南风1-3级 | 💧无降水 | 紫外线: 9(极强)
────────────────────────────────────────────────────────────
🌅 日出 05:21 / 日落 19:04 🌙 盈凸月 月升 14:46 / 月落 03:11
────────────────────────────────────────────────────────────
📡 QWeather | 更新于 2026-04-27 00:04
紫外线指数等级
| 指数 | 描述 |
|---|---|
| 0-2 | 很弱 / 弱 |
| 3-4 | 中等 / 较强 |
| 5-6 | 强 / 很强 |
| 7-9 | 很强 / 极强 |
| 10-12 | 极强（极高） |
qweather-get-weather-alert.py — 天气预警
查询城市当前生效的天气预警信息。
命令
python3 cs-qweather-alert/scripts/qweather-get-weather-alert.py \x3C城市名> [--host API_HOST] [--token TOKEN]
示例
# 查询北京天气预警
python3 cs-qweather-alert/scripts/qweather-get-weather-alert.py 北京
# 查询多个城市
python3 cs-qweather-alert/scripts/qweather-get-weather-alert.py 上海
预警级别
| 级别 | Emoji |
|---|---|
| 极严重（extreme） | 🔴 |
| 严重（severe） | 🟠 |
| 中等（moderate） | 🟡 |
| 轻微（minor） | 🔵 |
示例输出
🌤️ 北京 天气预警
坐标: 39.90499, 116.40529
────────────────────────────────────────
✅ 目前没有天气预警
公共机制
城市经纬度缓存
- 位置：
scripts/data/location.json（脚本同目录下） - 命中：查询过的城市直接从缓存读取，不调 API
- 失效：永久缓存，人工手动清理文件即可
日志
- 位置：
/tmp/cslog/ - 命名规则：
qweather-get-weather-now-YYYYMMDD.log、qweather-get-weather-alert-YYYYMMDD.log、qweather-get-weather-daily-YYYYMMDD.log - 脱敏：JWT Token 只显示前8后4位，其余用
***替代
共享常量
qweather_utils.py 中定义了以下共享常量，供所有脚本使用：
| 常量 | 说明 |
|---|---|
WEATHER_ICON_EMOJI |
天气图标代码 → emoji 映射表 |
DEFAULT_WEATHER_EMOJI |
未识别图标代码时的默认 emoji |
UV_DESCRIPTION |
紫外线指数 → 描述文字映射表 |
get_weather_emoji(icon_code) |
根据图标代码返回对应 emoji |
uv_description(uv_index) |
根据紫外线指数返回描述文字 |
城市名称规则
- 直辖市（如北京、上海）：直接显示城市名
- 省会/地级市（如南京）：直接显示城市名
- 县级市/区县（如浦东新区）：显示「省市区」格式，自动去重
依赖
- Python 3（标准库，无需 pip）
Usage Guidance
This skill appears to be a legitimate QWeather client, but review the following before installing:
- Metadata mismatch: The registry metadata claims no required env vars, but SKILL.md and the scripts require QWEATHER_API_HOST and a JWT token. Treat the token as sensitive.
- Token handling: By default the scripts will read a JWT from ~/.myjwtkey/last-token.dat. If you keep credentials there, the skill will read them; consider providing a temporary token via --token when invoking or storing tokens in a dedicated, access-controlled location.
- Dotfile reading: The code will attempt to load ~/.openclaw/.env (dotenv override=True). If you have secrets or other environment values in that file, they may be used by the skill.
- Logging: The skill writes logs to /tmp/cslog/ and records API request curl commands (token masked) and response bodies (truncated). Ensure /tmp/cslog/ permissions and contents are acceptable for your environment, and periodically clear or redirect logs if needed.
- Cache: City lookups are cached to scripts/data/location.json inside the skill bundle directory; this is benign but persistent.
If you plan to use this skill, either (a) inspect and run the bundled scripts locally to verify behavior, (b) supply tokens explicitly at runtime and avoid leaving sensitive tokens in the default path, and (c) ensure /tmp/cslog is not accessible to untrusted users or modify the code to disable logging or change log location. The assessment is 'suspicious' because of the undeclared env/credential access and the default home-file reads and logging; these are explainable but warrant manual review.
Capability Analysis
Type: OpenClaw Skill
Name: cs-qweather-alert
Version: 2.0.0
The bundle is a well-structured set of tools for querying the QWeather API. It demonstrates security-conscious practices by explicitly masking sensitive JWT tokens before writing them to local debug logs in `/tmp/cslog/` (found in `qweather_utils.py`). While the scripts read credentials from a specific local path (`~/.myjwtkey/last-token.dat`), this behavior is clearly documented in `SKILL.md` and is consistent with the functional requirements for API authentication. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (weather + alerts via QWeather) matches the included scripts: they call QWeather endpoints and format weather/alert output. However the registry metadata lists no required env/credentials while SKILL.md and the code require an API host (QWEATHER_API_HOST) and a JWT token (via --token or ~/.myjwtkey/last-token.dat). That metadata/instruction mismatch is unexpected and should be corrected.
Instruction Scope
SKILL.md and the scripts instruct the agent to read configuration from ~/.openclaw/.env (dotenv with override=True) and to read a JWT token from ~/.myjwtkey/last-token.dat if no --token is provided. The scripts also write logs (including API response bodies up to 2000 chars) into /tmp/cslog/ and persist a city cache (scripts/data/location.json). Reading user home files and writing potentially sensitive responses to world-readable /tmp logs is outside the minimal scope of a simple weather formatter and is a privacy/safety concern unless the user expects it.
Install Mechanism
No install spec or remote downloads; code is bundled in the skill. The scripts use only Python standard library (dotenv is optional). This is low installation risk (nothing is downloaded/executed from external URLs).
Credentials
The runtime requires an API Host and a JWT token to function (both justified for calling a protected QWeather API). But those requirements are not reflected in the registry metadata. Additionally, the default token location (~/.myjwtkey/last-token.dat) and automatic loading of ~/.openclaw/.env are sensitive behaviors: they access files in the user's home directory that were not declared as required. The scripts also log API responses (which could contain sensitive fields) — token is partially masked in logs but other sensitive data could still be recorded.
Persistence & Privilege
The skill does not request 'always: true' and does not modify other skills or global agent settings. It writes cache files into its data directory and log files to /tmp/cslog; these are ordinary for CLI tools but increase local persistence and information exposure and should be noted.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install cs-qweather-alert - After installation, invoke the skill by name or use
/cs-qweather-alert - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
新增每日天气预报脚本(qweather-get-weather-daily.py)，提取共享emoji/UV常量到qweather_utils.py，修复紫外线指数12描述，更新SKILL.md
v1.4.0
- 默认环境变量加载的 dotenv 库参数由 override=False 改为 override=True，确保读取最新值，避免旧进程缓存干扰。
- 文档（SKILL.md）同步说明，明确 dotenv 行为更改变更。
- 其余功能、交互与依赖未变。
v1.3.0
- 增加对 dotenv 环境变量自动加载，自动从 ~/.openclaw/.env 读取配置，无需手动设置（OpenClaw 环境下可即开即用）
- 文档补充 dotenv 环境变量说明，说明变量加载机制
- 其余功能和调用接口未变，兼容原有用法
v1.2.0
- SKILL.md中名称由“cs-qweather-alert”调整为“和风天气 - 天气和预警查询”，更贴合功能定位
- 其余内容未调整，功能与用法描述一致
- 文档字段与表述未见重大增删
- 本次为文档命名与描述优化，未涉及功能变更
v1.1.1
v1.1.1 变更摘要：
- 对 SKILL.md 进行了全面改版与结构优化，信息更加清晰简明。
- 明确区分并详细说明实时天气、天气预警两个子脚本的用途、参数和输出示例。
- 增加脚本清单、环境变量、日志和缓存等使用规范说明。
- 明确城市名称规则与 emoji 预警级别对照表。
- 利用表格和分节提升可读性，无核心代码变动。
v1.1.0
- 新增“实时天气查询”功能（qweather-get-weather-now），可查询并显示城市实时天气状况、温度、风力、湿度等详细信息，支持 emoji 图标可视化。
- 新增脚本 qweather-get-weather-now.py 和工具库 qweather_utils.py。
- 现有城市经纬度缓存机制与日志记录能力适配实时天气查询。
- 文档（SKILL.md）补充实时天气查询用法、输出说明和字段表。
- 无需额外 pip 包，依旧仅用标准库。
v1.0.0
首次发布：查询城市天气预警，支持多种预警类型和 emoji 可视化
Metadata
Frequently Asked Questions
What is Cs Qweather Alert?
和风天气查询工具集，支持实时天气查询和天气预警查询。当用户询问城市天气、气温、湿度、刮风下雨等天气状况，或需要查询预警时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 135 downloads so far.
How do I install Cs Qweather Alert?
Run "/install cs-qweather-alert" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Cs Qweather Alert free?
Yes, Cs Qweather Alert is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Cs Qweather Alert support?
Cs Qweather Alert is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Cs Qweather Alert?
It is built and maintained by Chenfeng (@savior1987); the current version is v2.0.0.
More Skills