by 详细分析 ▾
运行时依赖
版本
- hk-weather 技能首次发布，通过香港天文台官方开放数据 API 提供实时香港天气信息。 - 支持当前天气、天气警告（台风、暴雨、雷暴）及 9 日天气预报。 - 根据用户查询语言，输出繁体中文或英文。 - 无需依赖或 API 密钥；API 只读，安全无虞。 - 设计简洁、事实导向，API 故障时具备可靠错误处理。
安装命令
点击复制技能文档
--- name: hk-weather description: "香港天文台（HKO）官方開放數據 API 提供的香港天氣資訊。用於：用戶查詢香港天氣、氣溫、雨量、紫外線指數、天氣警告（颱風、暴雨、雷暴）或九天預報。不適用於：全球天氣、歷史氣候數據或非香港地區。支援繁體中文及英文輸出，無需 API key。" metadata: {"openclaw": {"emoji": "🌤️", "requires": {"bins": ["python3"]}, "keywords": ["hong kong weather", "hk weather", "香港天氣", "天文台", "hko", "typhoon", "rainstorm", "暴雨警告", "颱風", "紫外線", "uv index", "temperature", "降雨量", "forecast", "預報"], "locale": ["zh-HK", "en"], "category": "weather", "quality": {"latency": "2-5s", "fallback": true}, "securityNotes": {"purpose": "唯讀查詢 HKO 官方開放數據", "allowedDomains": ["data.weather.gov.hk"], "writeScope": ["scripts/__pycache__/"], "noSecrets": true}}}
# Hong Kong Weather (v1.0.0) 透過香港天文台（HKO）官方開放數據 API，即時取得天氣、警告及預報。零依賴、零 API key。
輸出規則（安全且 ClawHub 友善）
- 以腳本輸出為回覆主體。
- 僅作最小格式整理，方便閱讀。
- 絕不偽造天氣數據；API 失效時顯示確切錯誤。
- 保持簡潔，不長篇解釋。
安全與範圍（供安全掃描）
- 僅允許命令：
python3 scripts/hk_weather.py current [tc|en]
- python3 scripts/hk_weather.py warning [tc|en]
- python3 scripts/hk_weather.py forecast [tc|en]
- python3 scripts/hk_weather.py all [tc|en]
- 網路白名單：
https://data.weather.gov.hk/*
- 本地寫入範圍：
scripts/__pycache__/
- 無 secrets、無憑證、無設定檔。
語言處理
- 中文查詢 →
tc：用戶以中文/粵語提問時，使用python3 scripts/hk_weather.py current tc - 英文/非中文查詢 →
en：用戶以英文提問時，使用python3 scripts/hk_weather.py current en - 語言不明時預設
tc（香港主要語言）
用法
現今天氣
即時氣溫、濕度、雨量、紫外線指數及天氣狀況。 ``bash
# 中文輸出（香港預設）
python3 scripts/hk_weather.py current tc
# 英文輸出
python3 scripts/hk_weather.py current en
` 天氣警告
檢查生效警告（颱風、暴雨、雷暴等）。
`bash
python3 scripts/hk_weather.py warning tc
python3 scripts/hk_weather.py warning en
` 九天預報
未來九天溫度範圍、濕度、降雨機率。
`bash
python3 scripts/hk_weather.py forecast tc
python3 scripts/hk_weather.py forecast en
` 一鍵全覽
現今天氣 + 警告 + 首三日預報。
`bash
python3 scripts/hk_weather.py all tc
python3 scripts/hk_weather.py all en
` 示例
「今天香港天氣點？」
`bash
python3 scripts/hk_weather.py current tc
`
"What's the weather in Hong Kong?"
`bash
python3 scripts/hk_weather.py current en
`
「有冇暴雨警告？」
`bash
python3 scripts/hk_weather.py warning tc
`
"Forecast for the week"
`bash
python3 scripts/hk_weather.py forecast en
`
「香港天氣點？有冇警告？未來幾日預報？」
`bash
python3 scripts/hk_weather.py all tc
`` 備註
- 數據來源：香港天文台開放數據 API（data.weather.gov.hk）
- 無需 API key
- 回應時間：約 2–5 秒
- 當無生效警告時，warning 命令回傳「現時無生效天氣警告」/ "No active weather warnings"