风况与场地

某地的风气候与当前风况：风向频率玫瑰图（按方向与风速区间统计的出现频率）及最新风况信息。本功能使用 Open-Meteo 服务（无需 API 密钥）。如需开展详细的城市或建筑尺度风效应分析（例如行人舒适度、建筑转角加速效应等），请使用 CFD 工具；本技能提供的是此类研究所需的场地风数据，用于上下文建模与输入准备。

依赖项

• requests
• numpy
• matplotlib

安装说明：OpenClaw 不会自动安装 Python 包。安装本技能后，请在技能目录下运行一次：pip install -r requirements.txt。若脚本执行时抛出 ModuleNotFoundError，请手动安装缺失的包。

使用方法

1. 当前或近期风况

参数：--lat（纬度）、--lon（经度），可选 --days（0 表示使用预报数据获取当前风况；>0 表示从历史存档中获取最近 N 天的数据）。

python3 scripts/wind_info.py --lat 31.23 --lon 121.47
python3 scripts/wind_info.py --lat 34.05 --lon -118.24 --days 7

输出：最新风速（m/s）与风向（°），若查询多小时数据，则额外给出该时段平均值。

2. 风向频率玫瑰图（Wind Rose）

参数：--lat、--lon、--days（默认为 30）、--output（默认为 wind_rose.png）。

python3 scripts/wind_rose.py --lat 31.23 --lon 121.47 --days 30 --output wind_rose.png

从 Open-Meteo 历史 API 获取逐小时风数据，并绘制风向频率玫瑰图（按方向与风速区间统计各时段占比）。

向 Telegram 发送图像

此功能在 OpenClaw 的 Telegram 对话中调用。风向玫瑰图为图像格式：请使用 wind_rose.py 并指定 --output .png 参数生成 PNG 文件；随后通过 OpenClaw 的消息/媒体工具将该 PNG 文件发送给用户。wind_info.py 仅输出文本，适用于数值结果；风向玫瑰图则用于可视化呈现。

OpenClaw 允许的路径：消息工具仅支持发送位于白名单目录内的文件。若提示“Local media path is not under an allowed directory”，说明图像保存路径不在允许范围内。务必使用白名单中的输出路径保存 PNG 文件：

• ~/.openclaw/media/（例如：--output ~/.openclaw/media/wind_rose.png）
• ~/.openclaw/agents/
• 系统临时目录（例如：/tmp/wind_rose.png）

禁止将技能安装目录（例如：~/.openclaw/skills/windsite/）作为 --output 路径；该路径未被授权，会导致文件发送失败。

Agent 行为规范：当用户请求某场地的风况或风向玫瑰图（含位置描述或经纬度）时，应直接执行对应脚本（使用 exec）：对当前/近期风况使用 wind_info.py 输出文本；对风向玫瑰图则运行 wind_rose.py --output .png，其中 必须属于白名单目录（例如：~/.openclaw/media/wind_rose.png 或 /tmp/wind_rose.png）；随后发送生成的 PNG 图像，并对关键数值作简要总结。无需向用户请求确认，直接执行并返回图像与数据即可。

城市风效应说明

本技能不执行CFD 计算或行人风环境模拟。其作用在于提供：

• 场地风向玫瑰图与风速/风向数据，便于识别主导风向及其强度；
• 上述数据可作为 CFD 或专业分析工具（例如 SimScale、OpenFOAM 或风洞试验）的气候输入，用于开展建筑/城市尺度的风效应与舒适度评估。

示例

用户：“这个场地现在的风况如何？”
操作：根据该场地的经纬度运行 wind_info.py；返回风速、风向及简明解读。

用户：“请提供上海过去 30 天的风向玫瑰图。”
操作：运行 wind_rose.py --lat 31.23 --lon 121.47 --days 30 --output ~/.openclaw/media/wind_rose.png（或 /tmp/wind_rose.png）；发送生成的文件，并附上简短摘要。

用户：“我需要评估一座新建塔楼周边的城市风环境。”
操作：为该场地运行 wind_rose.py 和 wind_info.py；说明针对建筑/城市风效应分析，应使用 CFD 或风洞试验等专业手段，并指出本技能提供的数据可作为其气候边界条件输入。