BVG Route Planner for Openclaw

A comprehensive tool for real-time Berlin public transport routing and departure information using the BVG API.

jaysonsantos
v0.0.2
Jan 29, 2026
1
2.9k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install bvg-route

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install bvg-route using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is BVG Route Planner?

The BVG Route Planner is a specialized integration within the Openclaw Skills ecosystem designed to provide precise, real-time public transport navigation for Berlin. By interfacing with the v6.bvg.transport.rest API, this skill allows AI agents to calculate optimal travel paths across the city's extensive network of buses, trams, U-Bahn, and S-Bahn trains.

This skill is built for developers who need to empower their agents with local transit intelligence. It handles the complexities of Berlin's transport data, including the conversion of address strings into machine-readable IBNR codes and managing live delay updates. By using Openclaw Skills like this one, agents can provide users with actionable itineraries that include walking distances, platform details, and transfer instructions.

BVG Route Planner Use Cases

  • Planning journeys between specific addresses, landmarks, or coordinates in Berlin.
  • Retrieving live departure boards for specific stations to minimize wait times.
  • Scheduling trips based on a required arrival time for meetings or events.
  • Providing step-by-step navigation for travelers including walking directions to stop entrances.

How BVG Route Planner Works

  1. The skill first resolves the user's origin and destination names into validated stop IDs or address objects.
  2. It extracts 6-digit IBNR codes from the location results to ensure high-precision routing.
  3. A query is sent to the journeys endpoint with specific parameters for arrival or departure times and stopover details.
  4. The system ranks the top journey results based on travel time, number of transfers, and walking duration.
  5. Detailed legs are constructed, including line numbers, directions, and platform information where available.
  6. Refresh tokens are optionally stored to allow for real-time journey updates if delays occur.

BVG Route Planner Setup

To deploy this skill within your Openclaw Skills configuration, ensure your agent has network access to the BVG REST API. No private API key is required for the public instance, but proper header configuration is recommended.

# Example of triggering a route search through the skill interface
# Ensure all address strings are URL encoded
curl "https://v6.bvg.transport.rest/locations?query=Alexanderplatz"

BVG Route Planner Data Schema & Taxonomy

The skill organizes transit data using a structured taxonomy to ensure consistency across Openclaw Skills responses:

Attribute Description Format
stopId The 6-digit base IBNR code for a station String (e.g., 900100003)
journeyId Unique identifier for a specific trip option String
refreshToken Token used to fetch live updates for a journey String
legs Array of individual segments of a journey List of Objects
stopovers Intermediate stops along a single leg Boolean Toggle

BVG Route Planner Advanced Features

  • Intelligent IBNR formatting that automatically strips non-essential suffixes from station IDs for API compatibility.
  • Robust URL encoding handling for German umlauts and special characters in Berlin street names.
  • Real-time delay monitoring using journey refresh tokens to provide dynamic updates.
  • Multi-modal support including walking-to-entrance accuracy for complex station layouts.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*