ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

trail-nav-telegram

Offline-capable hiking route guidance via Telegram location messages (OpenClaw). Use when building/operating an LLM agent workflow that: (1) imports a GPX/KML route, (2) answers 'am I off-route / which way should I go' with low-token fixed outputs, (3) scrapes/publicly discovers route links from 2bulu track_search, and (4) prepares trip risk checklists + gear lists for an overnight hike.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/jack4world/trail-nav-telegram
Or

Trail Nav via Telegram (low-token)

Goals

  • Use Telegram (iOS) as the UI: user sends location + short commands.
  • Keep token usage minimal: do all geometry calculations deterministically, use LLM only for optional wording.
  • Respect access controls: do not bypass logins/captchas on external sites.

Quick workflow

  1. Import route (GPX/KML) → build a compact RoutePack (simplified polyline + bbox + endpoints).
  2. Bind route to the chat (/use <routeId>).
  3. Guide: user sends location (or /g + location) → reply with 2-line output (machine line + Chinese template).

Token-saving rules (hard)

  • Never send full KML/GPX text into the LLM context.
  • Parse route once; store routeId + simplified points.
  • Output is fixed schema (see references/guide-protocol.md).
  • Cache per-chat state: activeRouteId, lastIdx.

External discovery (2bulu)

Two supported modes:

  1. Public discovery (no login)
  • Only scrape public list/search pages (e.g. /track/track_search.htm, /track/search-<keyword>.htm).
  • Store: title + url + scraped_at.
  1. Manual-login assist (optional)
  • If the user manually logs in (WeChat/QQ/etc.) in a persistent browser profile, automation may proceed within that same profile.
  • Login/captcha steps must be completed by the user. Do not bypass access controls.

Preferred alternative (often simplest): ask the user to export/send the GPX/KML file via Telegram; then operate purely on the user-provided route file.

Safety reminders

  • Provide explicit no-signal / SOS guidance. See references/safety-checklist.md.
  • Encourage “hard cutoffs” for overnight hikes (time, wind/fog, hydration).

Bundled resources

  • Scripts:
    • scripts/scrape_2bulu_tracks.js list-page scraper → JSON/CSV + screenshot
    • scripts/parse_2bulu_kml.js parse KML → stats + geojson + routepack
    • scripts/render_route_map.js render route HTML+PNG map for sharing
    • scripts/render_route_map_annotated.js render annotated map (GeoJSON + alerts) to HTML+PNG
    • scripts/guide_route.js deterministic off-route guidance from GeoJSON + current location (outputs the 2-4 line guide protocol)
    • scripts/weather_alert.js deterministic weather change alert (Open-Meteo) for day_hike/summit_camp/trail_run modes
    • scripts/outsideclaw_setup.sh one-command install/update outsideclaw repo into ~/.outsideclaw/app/outsideclaw
    • scripts/generate_openclaw_snippet.js prints an OpenClaw config snippet pointing to the installed outsideclaw skill
    • scripts/patch_openclaw_config.js patches an OpenClaw config JSON to include the installed skill path (creates .bak)
    • scripts/openclaw_oneclick_setup.sh one-click: install outsideclaw + patch config (+ optional gateway restart)
  • References:
    • references/2bulu-notes.md
    • references/guide-protocol.md
    • references/safety-checklist.md
    • references/gear-list-overnight.md
    • references/qiniangshan_alerts.json risk-based key-node alerts (used for...
Read Full Documentation on GitHub

Metadata

Author@jack4world
Stars2032
Views0
Updated2026-03-05
View Author Profile
AI Skill Finder

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 skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-jack4world-trail-nav-telegram": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

elon-x-actionbook-recap

(DEPRECATED) Use x-actionbook-recap instead. This slug is kept for backward compatibility. Collect, scroll, extract, and summarize X posts using actionbook-rs.

jack4world 2032

terrain-route-video

Generate a minimalist terrain-style animated driving route video (MP4) from a list of stops (cities/POIs) without Remotion. Uses OSRM for road-following geometry, OpenTopoMap terrain tiles for basemap, Matplotlib for frame rendering, and FFmpeg for encoding. Use when the user asks to create/export a dynamic self-driving route map video (fly-follow camera, route draw animation, labels) and wants it along roads/highways.

jack4world 2032

remotion-excalidraw-tts

Generate a narrated Remotion video from an Excalidraw (.excalidraw) diagram using text-to-speech (macOS say) and render to MP4. Use when creating explainer videos with pan/zoom + focus highlights over Excalidraw diagrams, with automated voiceover generation and Remotion CLI rendering.

jack4world 2032

yc-new-way

Apply Y Combinator’s “New Way to Build a Startup” playbook to ship fast, validate with real distribution, and iterate using data. Use when the user asks to follow “New Way”, design a 7-day startup sprint, pick a narrow wedge, build a lightweight MVP/SEO site/newsletter, set up experiments, or turn a vague idea into a testable plan with metrics, launch checklist, and weekly iteration loop.

jack4world 2032

x-actionbook-recap

Collect, scroll, extract, and summarize recent X (Twitter) posts for any handle (optionally filtered by keyword search) using the Actionbook Rust CLI (actionbook-rs) workflow (open → snapshot/accessibility tree → extract `article` text). Use when asked to analyze a handle over a time window (e.g., last 7 days), produce Chinese working notes, and publish a neutral English recap (single post or thread) from a specified account.

jack4world 2032