trail-nav-telegram
by jack4world
Coding Agents & IDEsBrief
Offline-capable hiking route guidance via Telegram location messages (OpenClaw)
Description
What This Skill Does
Hiking route guidance agent that operates through Telegram. Users send location messages to get real-time off-route detection and directional guidance from imported GPX/KML routes. Also handles route discovery on 2bulu, weather alerts via Open-Meteo, and overnight trip safety and gear checklists.
All route geometry is calculated deterministically, so LLM calls are minimal, making frequent location checks during a hike cheap to run.
When to Use It
- Checking if you've drifted off a trail mid-hike
- Getting direction guidance by sending your GPS location in Telegram
- Finding public hiking tracks on 2bulu without logging in
- Generating a gear list before an overnight hike
- Receiving weather change alerts during a summit or trail run
Example Workflow
User sends a GPX file via Telegram, then sends their current location
- 1
Parse GPX file and build a simplified RoutePack with bbox and endpoints
- 2
Bind the route to the chat session with a routeId
- 3
Receive the user's Telegram location message
- 4
Run deterministic off-route distance calculation against the stored polyline
- 5
Return a 2-line guide protocol response with bearing and distance to route
Two-line reply showing whether the user is on-route and the direction to return to the trail
Requirements
- Telegram Bot token from BotFather
Installation
clawhub install jack4world/trail-nav-telegramRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.