479
下载量
18
安装量
1
收藏量
★ 5.0
综合评分ⓘ
和风天气-天气查询与天气预警查询#
和风天气查询工具集 — 支持实时天气查询和天气预警查询两个功能。
技能职责#
当需要查询某个城市的 实时天气、 每日天气预报 或 天气预警 时使用此 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 — 实时天气#
查询城市当前天气状况，包括温度、湿度、风力、气压等详细信息。
命令#
bash
python3 cs-qweather-alert/scripts/qweather-get-weather-now.py <城市名> [--host API_HOST] [--token TOKEN]
示例#
bash
# 查询北京实时天气
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）
示例输出#
text
🌤️ 北京 实时天气
🕐 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 天天气预报，包含最高/最低温度、天气状况、风力风向、降水概率、紫外线指数、日出日落、月相等信息。
命令#
bash
python3 cs-qweather-alert/scripts/qweather-get-weather-daily.py <城市名> [--days 7] [--host API_HOST] [--token TOKEN]
参数#
参数默认值说明--days7预报天数，支持 3/7/10/15/30 天
示例#
bash
# 查询北京 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相对湿度（%）
示例输出#
text
📅 北京 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 — 天气预警#
查询城市当前生效的天气预警信息。
命令#
bash
python3 cs-qweather-alert/scripts/qweather-get-weather-alert.py <城市名> [--host API_HOST] [--token TOKEN]
示例#
bash
# 查询北京天气预警
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）🔵
示例输出#
text
🌤️ 北京 天气预警
坐标: 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未识别图标代码时的默认 emojiUV_DESCRIPTION紫外线指数 → 描述文字映射表get_weather_emoji(icon_code)根据图标代码返回对应 emojiuv_description(uv_index)根据紫外线指数返回描述文字
城市名称规则#
- 直辖市（如北京、上海）：直接显示城市名
- 省会/地级市（如南京）：直接显示城市名
- 县级市/区县（如浦东新区）：显示「省市区」格式，自动去重
依赖#
- Python 3（标准库，无需 pip）
