ÖBB Scotty Rail Planner for Openclaw

A comprehensive integration for planning Austrian rail journeys and accessing real-time transit data through the ÖBB Scotty HAFAS API.

manmal
v1.0.0
Jan 9, 2026
3
2.5k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install oebb-scotty

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 oebb-scotty 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 ÖBB Scotty Rail Planner?

This skill provides a programmatic interface to the ÖBB Scotty system, the primary travel information service for Austrian Federal Railways (ÖBB). By leveraging the HAFAS mgate API, it enables AI agents to search for stations, plan complex multi-leg journeys, and retrieve live station boards. It is a vital tool within the Openclaw Skills ecosystem for anyone requiring high-fidelity transit data across Austria's rail, bus, and tram networks.

Beyond simple trip planning, the skill handles technical nuances such as product bitmasking for different transport types—ranging from high-speed Railjet (RJX) services to local S-Bahn lines. It also provides access to the HimSearch service, which delivers real-time alerts regarding track closures, technical disruptions, and reduced seat availability.

ÖBB Scotty Rail Planner Use Cases

  • Planning a rail journey between Austrian cities with specific departure or arrival time constraints.
  • Retrieving real-time departure boards for a specific station like Wien Hbf to check for platform changes.
  • Monitoring service alerts and disruptions for specific regions or transport products.
  • Resolving station names and addresses into unique Location IDs for precise transit routing.

How ÖBB Scotty Rail Planner Works

  1. The skill uses the LocMatch method to resolve user-provided station names or addresses into unique, system-compatible Location IDs (lid).
  2. For trip planning, it constructs a TripSearch request using these IDs, along with formatted date (YYYYMMDD) and time (HHMMSS) parameters.
  3. The request applies a product filter bitmask to include or exclude specific transport modes like Nightjets, InterCity trains, or local buses.
  4. The HAFAS API returns a verbose JSON response containing journey legs, duration, and platform information.
  5. The skill maps internal product indices (prodX) to actual train names (e.g., S7 or RJX 662) to provide a human-readable summary of the travel itinerary.

ÖBB Scotty Rail Planner Setup

To utilize this skill, ensure your agent can perform POST requests to the ÖBB mgate endpoint. No external API key is required beyond the public AID provided in the configuration.

# Verify station search connectivity
curl -s -X POST "https://fahrplan.oebb.at/bin/mgate.exe" \
  -H "Content-Type: application/json" \
  -d '{"id":"1","ver":"1.67","auth":{"type":"AID","aid":"OWDL4fE4ixNiPBBm"},"client":{"id":"OEBB","type":"WEB"},"svcReqL":[{"req":{"input":{"field":"S","loc":{"name":"Salzburg Hbf","type":"S"}}},"meth":"LocMatch"}]}'

ÖBB Scotty Rail Planner Data Schema & Taxonomy

The skill organizes data using the following taxonomy:

Data Type Format/Key Description
Station ID lid A unique string identifier for locations (e.g., A=1@O=Wien Hbf...)
External ID extId Standard 7-digit station codes for Austrian transit
Date YYYYMMDD Standardized date format for all queries
Time HHMMSS 24-hour time format including seconds
Product Bitmask Integer A sum of bits representing transport types (e.g., 32 for S-Bahn)

ÖBB Scotty Rail Planner Advanced Features

  • Real-time delay tracking via dTimeR and aTimeR fields when available from the ÖBB backend.
  • Support for intermediate stop retrieval using the getPasslist parameter for detailed journey visualization.
  • High-resolution coordinate support for stations and POIs, scaled by 10^6 for precise mapping.
  • Multi-product filtering allowing users to combine or isolate specific transit categories like Night trains or Ferries.
  • Integrated error handling for common API states including NO_MATCH and PARSE errors in Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*