Cs Qweather Alert

和风天气查询工具集，支持实时天气查询和天气预警查询。当用户询问城市天气、气温、湿度、刮风下雨等天气状况，或需要查询预警时触发。

Install

openclaw skills install cs-qweather-alert

和风天气-天气查询与天气预警查询

和风天气查询工具集 — 支持实时天气查询和天气预警查询两个功能。

技能职责

当需要查询某个城市的实时天气、每日天气预报或天气预警时使用此 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 <城市名> [--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 <城市名> [--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 <城市名> [--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）