前言¶

在對話式 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。