前言¶

在对话式 Agent 里加天气能力，常见做法是自己找一套免费气象接口，写请求、解析字段、再拼成自然语言。问题是接口字段各家不一，降水概率、风力风向、空气质量的命名和单位都不一样，换一个城市或换一段时间范围就要改代码。下面介绍的 weather Skill 把这一步封装成标准工具调用，Agent 只需要给出地点和天数。

这是什么¶

weather 是一个基于通用 SKILL.md 格式的 Skill，坐标 @congwupiece/free-weather-api，由 congwupiece 发布并维护，来源为 clawhub，当前版本 1.0.0。它解决的问题是：让 Agent 在对话中按统一接口查询指定城市或地区的天气，返回结构化数据后再由 Agent 组织成报告。

分类上，SkillHub 归为 life-service，ClawHub 归为 Lifestyle。标签包含 #weather、#天气查询、#天气预报、#天气，以及 requires_api_key=false，即不需要自备 API Key。

核心功能¶

官方 SKILL.md 写明的能力如下。

1、查询指定城市或地区的天气，输入为地点名称，例如「北京」「上海浦东」。
2、返回实时天气与未来多日预报。预报天数可选 1-7 天，默认当天。
3、实时部分返回温度、体感温度、天气状况、湿度、风速、风向、气压、能见度。
4、预报部分逐日返回最高/最低温度、白天/夜间天气、降水概率、风力、空气质量（AQI）、紫外线指数。
5、可选 details 参数，用于获取空气质量、紫外线等详细信息。
6、数据中若包含预警信息（暴雨、台风、高温、寒潮、大风、雾霾等），由 Agent 在报告中突出提示。

字段命名以官方示例为准：current 下的 temperature、feels_like、weather、humidity、wind_speed、wind_direction、pressure、visibility；forecast 数组下的 temp_high、temp_low、weather_day、weather_night、precipitation_prob、wind、aqi、uv_index。温度单位统一为摄氏度。

安装与启用¶

官方给出的安装命令如下，面向 OpenClaw agents：

openclaw skills install @congwupiece/free-weather-api

页面同时提供 CLI 与 Prompt 两种使用入口（标注为 CLI npx skills / Prompt），安装后在会话中以自然语言触发即可，例如「北京天气怎么样」。

上游仓库地址为 https://clawhub.ai/congwupiece/free-weather-api，SkillHub 页面地址为 https://www.skillhub.cn/skills/clawhub_congwupiece/free-weather-api。除安装命令外，官方资料未给出 Cursor、Codex CLI、Claude Code 的具体配置差异，此处不展开。

典型用法¶

官方 SKILL.md 的工作流分三步：查询天气数据、智能分析与建议、生成天气预警。第一步通过工具 query_weather 完成，参数为 location、days、details。调用示例：

query_weather(location="北京", days=3, details=true)

预期返回为 JSON，包含 location、query_time、current、forecast、alerts。其中 forecast 为数组，逐日给出当日与次日的 temp_high、temp_low、precipitation_prob、aqi、uv_index 等字段。

第二、三步由 Agent 推理完成。官方给出了天气状况分类（优/良/中/差，按天气、温度区间、AQI 区间划分）与出行建议规则，例如降水概率大于 70% 建议携带雨具、温差大于 10°C 建议备好外套、AQI 大于 100 建议佩戴口罩、UV 指数大于 7 建议做好防晒、风力大于 6 级避免户外活动、气温低于 0°C 注意防寒、高于 35°C 注意防暑。

产出规范要求 Agent 输出 weather_report，含 location、query_time、current_summary、forecast_summary、highlights、suggestions、alerts。报告模板分四段：实时天气、预报概况、重点提示、出行建议。官方给出的报告示例为「北京当前多云，气温15°C，体感温度13°C，西北风3-4级，湿度45%，能见度10公里」，并附未来 3 天趋势与出行建议。

适用场景与注意¶

适合的场景：在 Agent 对话中做出行、活动安排类的天气查询，尤其是需要把温度、降水概率、风力风向、空气质量一次性返回并转成自然语言报告的场景。因为不需要 API Key，接入成本低。

需要注意的几点。

1、数据来源与更新频率官方页面未展开说明，生产环境若要用于实时决策，建议自行确认数据时效。
2、城市名依赖用户输入，官方要求在质量检查清单中核对地点信息准确无误，模糊地名可能需要用户澄清。
3、预报天数上限为 7 天，超出范围的需求不适用。
4、官方 SKILL.md 的示例数据为说明性样例，不代表真实某日的天气。
5、License 为 MIT-0，Security audit 状态为 Pass，最后更新时间页面显示为 5 个月前，当前版本 v1.0.0。

结尾¶

weather 的价值在于把「查天气」从写接口、对字段、拼文案的重复劳动，收敛成一次标准工具调用加一段 Agent 推理。它不需要 API Key，返回字段固定，适合直接接进对话型 Agent 的出行与生活服务流程。官方地址：https://api.skillhub.cn/zcwl/free-weather-api。