/install hk-weather
Hong Kong Weather (v1.0.0)
Get real-time weather, warnings, and forecasts from the Hong Kong Observatory (HKO) official open data API. Zero dependencies, zero API keys.
Output Policy (Safe & ClawHub-friendly)
- Prefer script output as reply basis.
- Allow minimal formatting cleanup for readability.
- Never fabricate weather data. If API fails, show exact error.
- Keep output concise. No lengthy explanations.
Safety & Scope (for Security Scan)
- Allowed commands only:
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]
- Network scope (allowlist):
https://data.weather.gov.hk/*
- Write scope (skill-local only):
scripts/__pycache__/
- No secrets. No credentials. No config files.
Language Handling
- Chinese query →
tc: When user asks in Chinese/Cantonese, usepython3 scripts/hk_weather.py current tc - English/non-Chinese query →
en: When user asks in English, usepython3 scripts/hk_weather.py current en - Default to
tcif language is unclear (Hong Kong primary language)
Usage
Current Weather
Real-time temperature, humidity, rainfall, UV index, and conditions.
# Chinese output (default for HK)
python3 scripts/hk_weather.py current tc
# English output
python3 scripts/hk_weather.py current en
Weather Warnings
Check active warnings (typhoon, rainstorm, thunderstorm, etc.).
python3 scripts/hk_weather.py warning tc
python3 scripts/hk_weather.py warning en
9-Day Forecast
Extended forecast with temperature range, humidity, and rain probability.
python3 scripts/hk_weather.py forecast tc
python3 scripts/hk_weather.py forecast en
All-in-One
Combined current + warnings + forecast (first 3 days).
python3 scripts/hk_weather.py all tc
python3 scripts/hk_weather.py all en
Examples
"今天香港天氣點?"
python3 scripts/hk_weather.py current tc
"What's the weather in Hong Kong?"
python3 scripts/hk_weather.py current en
"有冇暴雨警告?"
python3 scripts/hk_weather.py warning tc
"Forecast for the week"
python3 scripts/hk_weather.py forecast en
"香港天氣點?有冇警告?未來幾日預報?"
python3 scripts/hk_weather.py all tc
Notes
- Data source: Hong Kong Observatory Open Data API (data.weather.gov.hk)
- No API key required
- Response time: typically 2-5 seconds
- When no warnings are active, the warning command returns "No active weather warnings" / "現時無生效天氣警告"
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hk-weather - After installation, invoke the skill by name or use
/hk-weather - Provide required inputs per the skill's parameter spec and get structured output
What is Hong Kong Weather?
Hong Kong weather information from the Hong Kong Observatory (HKO) official open data API. Use when: user asks about Hong Kong weather, temperature, rainfall... It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.
How do I install Hong Kong Weather?
Run "/install hk-weather" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hong Kong Weather free?
Yes, Hong Kong Weather is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Hong Kong Weather support?
Hong Kong Weather is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hong Kong Weather?
It is built and maintained by MIC007P (@mic007p); the current version is v1.0.0.