hk-route
Smart public transport routing for Hong Kong with real-time bus ETAs. Queries Google Maps for transit alternatives, enriches bus legs with live arrival times, and ranks routes by effective total time.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/7ito/hkrouteHK Route — Hong Kong Transit Routing with Real-Time ETAs
What this skill does
Finds the best public transport route in Hong Kong by combining Google Maps directions with real-time bus ETAs. Routes are ranked by effective total time (real-time wait + travel duration), not just schedule data.
Required environment
| Requirement | Details |
|---|---|
GOOGLE_MAPS_API_KEY | Google Maps API key with Directions API enabled |
node >= 18 | Runtime for the bundled script |
External endpoints
This skill makes network requests to:
| Endpoint | Purpose | Credentials |
|---|---|---|
maps.googleapis.com (Google Directions API) | Transit route planning | GOOGLE_MAPS_API_KEY |
| HK government & operator APIs via hk-bus-eta (DATA.GOV.HK, KMB, CTB, etc.) | Real-time bus arrival times | None (public APIs) |
No other network calls are made. The ETA database is cached locally at ~/.cache/hk-route/etaDb.json (refreshed every 24h).
Source code
The bundled scripts/hk-route.cjs is built from readable TypeScript source at github.com/7ito/hkroute. Build command: esbuild src/index.ts --bundle --platform=node --format=cjs.
How to invoke
node /path/to/skill/scripts/hk-route.cjs \
--origin "<origin>" \
--destination "<destination>"
The
scripts/hk-route.cjsbundle is self-contained — nonpm installneeded. Justnode>= 18.
Optional flags
--departure-time "<ISO 8601 datetime>"— plan a future trip (e.g.,--departure-time "2026-03-26T08:00:00+08:00")
Input formats
- Coordinates:
"22.2822,114.1875"(lat,lng — no space after comma) - Place name:
"Causeway Bay","Hong Kong Airport","Stanley Market" - Both origin and destination accept either format.
Conversational flows
One-shot (user provides both locations)
User: "How do I get from Causeway Bay to Stanley?"
→ Run the CLI with --origin "Causeway Bay" --destination "Stanley", format the output.
Multi-turn (e.g., WhatsApp via OpenClaw)
- User sends
/hkroute - Ask: "Where are you now? Send a location pin or type your location."
- User sends a coordinate pin (e.g.,
22.2822,114.1875) or text (e.g., "Tin Hau MTR") - Ask: "Where do you want to go?"
- User sends destination as text or coordinates.
- Run the CLI, format the output.
If the user provides invalid input at any step, ask them to try again with a valid location.
Implicit activation
Activate this skill when the user asks about getting somewhere in Hong Kong by public transport, even without using /hkroute. Look for intent like "how do I get to...", "best way to...", "bus from...", etc., in a Hong Kong context.
Output format
The CLI outputs JSON to stdout. Format it for the user as follows:
WhatsApp / messaging format template
🚌 **Routes from {origin} to {destination}**
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-7ito-hkroute": {
"enabled": true,
"auto_update": true
}
}
}