Cs Qweather Alert — Cs 天气预警

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

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

技能职责

当需要查询某个城市的实时天气、每日天气预报或天气预警时使用此 技能。

脚本清单 脚本 功能 qweather-获取-weather-now.py 实时天气查询 qweather-获取-weather-alert.py 天气预警查询 qweather-获取-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 环境下无需手动配置即可使用。

令牌 配置：JWT 令牌 默认从 ~/.myjwtkey/last-令牌.dat 读取，也可通过 --令牌 参数显式传入。

qweather-获取-weather-now.py — 实时天气

查询城市当前天气状况，包括温度、湿度、风力、气压等详细信息。

命令 python3 cs-qweather-alert/scripts/qweather-获取-weather-now.py <城市名> [--host API_HOST] [--令牌 令牌]

示例 # 查询北京实时天气 python3 cs-qweather-alert/scripts/qweather-获取-weather-now.py 北京

# 指定 API Host python3 cs-qweather-alert/scripts/qweather-获取-weather-now.py 上海 --host https://md78m2kdwa.re.qweatherAPI.com

# 通过环境变量设置默认城市 导出 QWEATHER_CITY=南京 python3 cs-qweather-alert/scripts/qweather-获取-weather-now.py

输出字段 字段 说明 obsTime 数据观测时间 temp 温度（°C） feelsLike 体感温度（°C） text 天气状况文字 windDir / wind扩展 / 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-获取-weather-dAIly.py — 每日天气预报

查询城市未来 3-30 天天气预报，包含最高/最低温度、天气状况、风力风向、降水概率、紫外线指数、日出日落、月相等信息。

命令 python3 cs-qweather-alert/scripts/qweather-获取-weather-dAIly.py <城市名> [--days 7] [--host API_HOST] [--令牌 令牌]

参数 参数 默认值 说明 --days 7 预报天数，支持 3/7/10/15/30 天 示例 # 查询北京 7 天预报（默认） python3 cs-qweather-alert/scripts/qweather-获取-weather-dAIly.py 北京

# 查询上海 15 天预报 python3 cs-qweather-alert/scripts/qweather-获取-weather-dAIly.py 上海 --days 15

# 查询广州 30 天预报 python3 cs-qweather-alert/scripts/qweather-获取-weather-dAIly.py 广州 --days 30

输出字段 字段 说明 fxDate 预报日期 tempMax / tempMin 最高 / 最低温度（°C） textDay / textNight 白天 / 夜间天气文字 iconDay / iconNight 白天 / 夜间天气图标 windDirDay / wind扩展Day 白天风向 / 风力等级 precip 预报当天总降水量（mm） uv索引 紫外线指数 sunrise / sun设置 日出 / 日落时间 moonPhase / moonrise / moon设置 月相 / 月升 / 月落 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-获取-weather-alert.py — 天气预警

查询城市当前生效的天气预警信息。

命令 python3 cs-qweather-alert/scripts/qweather-获取-weather-alert.py <城市名> [--host API_HOST] [--令牌 令牌]

示例 # 查询北京天气预警 python3 cs-qweather-alert/scripts/qweather-获取-weather-alert.py 北京

# 查询多个城市 python3 cs-qweather-alert/scripts/qweather-获取-weather-alert.py 上海

预警级别 级别 Emoji 极严重（extreme） 🔴 严重（severe） 🟠 中等（moderate） 🟡 轻微（minor） 🔵 示例输出 🌤️ 北京 天气预警 坐标: 39.90499, 116.40529 ──────────────────────────────────────── ✅ 目前没有天气预警

公共机制 城市经纬度缓存 位置：scripts/data/location.json（脚本同目录下） 命中：查询过的城市直接从缓存读取，不调 API 失效：永久缓存，人工手动清理文件即可 日志 位置：/tmp/cs记录/ 命名规则：qweather-获取-weather-now-YYYYMMDD.记录、qweather-获取-weather-alert-YYYYMMDD.记录、qweather-获取-weather-dAIly-YYYYMMDD.记录 脱敏：JWT 令牌 只显示前8后4位，其余用 *** 替代 共享常量

qweather_utils.py 中定义了以下共享常量，供所有脚本使用：

常量 说明 WEATHER_ICON_EMOJI 天气图标代码 → emoji 映射表 DEFAULT_WEATHER_EMOJI 未识别图标代码时的默认 emoji UV_DESCRIPTION 紫外线指数 → 描述文字映射表 获取_weather_emoji(icon_code) 根据图标代码返回对应 emoji uv_description(uv_索引) 根据紫外线指数返回描述文字 城市名称规则 直辖市（如北京、上海）：直接显示城市名 省会/地级市（如南京）：直接显示城市名 县级市/区县（如浦东新区）：显示「省市区」格式，自动去重 依赖 Python 3（标准库，无需 pip）