Trail Nav via Telegram (low-token)

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.

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.

2. 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 map annotations + alert triggering)
  • references/route-alerts.md alerts schema + how to apply to any route
  • references/share-bundles.md share route bundles between outsideclaw agents
  • references/outsideclaw-integration.md install outsideclaw repo + generate OpenClaw config snippet
  • references/openclaw-oneclick.md one-click OpenClaw integration (install + patch + optional restart)