A lightweight bash-based integration to fetch live traffic travel times, delays, and ETAs via the TomTom Routing API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tomtom-traffic-commute
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tomtom-traffic-commute 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 TomTom Traffic Commute?
The TomTom Traffic Commute skill is a lightweight integration engineered to retrieve real-time route, travel time, and transit delay insights directly from the TomTom Routing API. Designed as part of the expanding ecosystem of Openclaw Skills, this tool allows developers and AI agents to programmatically query route details, evaluate congestion levels, and estimate ETAs without heavy overhead or dependencies.
By leveraging raw latitude and longitude coordinates, this utility simplifies the parsing of complex route payloads, rendering key details like live traffic delay, total distance, and arrival time. Whether utilized as a standalone script or incorporated into autonomous workflows, it provides predictable, accurate, and rapid transit intelligence.
TomTom Traffic Commute Use Cases
- Daily Commute Optimization: Programmatically check your morning route status to decide whether to leave early or take an alternative route.
- Automated Dispatching: Enable AI agents using Openclaw Skills to analyze dispatch routes and alert operations if delays exceed defined thresholds.
- Scheduled Email Notifications: Combine transit data with messaging tools to receive scheduled, customized commuting status emails every weekday morning.
How TomTom Traffic Commute Works
- Input Parameters: The script accepts origin and destination coordinates in latitude/longitude decimal degrees, along with an optional departure timestamp.
- API Request: A secure HTTP request is constructed targeting the TomTom Routing API v1
/calculateRouteendpoint, authenticated via your API key. - Traffic Calculation: The API processes route options using the fastest route type with live traffic data enabled.
- Data Formatting: The script extracts essential metrics from the API payload (e.g., delay time, affected distance, total distance) and outputs a clean, parseable JSON object.
TomTom Traffic Commute Setup
To leverage this tool within your suite of Openclaw Skills, configure your environment and run the following commands:
1. Acquire API Key
Sign up for a free developer account at developer.tomtom.com to receive your API key, which includes 2,500 free transactions per day.
2. Configure Environment Variables
Export your key to ensure the script has access to the API:
export TOMTOM_API_KEY="your_tomtom_api_key_here"
3. Execution
Execute the shell script by passing the origin coordinates, destination coordinates, and optional ISO-8601 departure time:
bash scripts/tomtom-traffic.sh "51.5081,-0.0753" "50.8213,-0.1325"
TomTom Traffic Commute Data Schema & Taxonomy
The script generates a standardized JSON payload summarizing the calculated commute profile:
| Property | Type | Description |
|---|---|---|
distance_km |
Float | The total route distance in kilometers. |
travel_time_min |
Integer | The travel duration in minutes, adjusted for real-time traffic. |
traffic_delay_min |
Integer | Calculated delays caused by current traffic congestion in minutes. |
traffic_affected_km |
Float | The length of the route portion negatively impacted by traffic. |
departure_time |
String | ISO-8601 formatted departure time. |
arrival_time |
String | ISO-8601 formatted estimated arrival time. |
summary |
String | A brief readable text summary of the route metrics. |
Sample JSON Output
{
"distance_km": 84.2,
"travel_time_min": 63,
"traffic_delay_min": 1,
"traffic_affected_km": 1.1,
"departure_time": "2026-06-05T10:43:27+01:00",
"arrival_time": "2026-06-05T11:46:50+01:00",
"summary": "84.2 km, 63 min (delay: 1 min)"
}
TomTom Traffic Commute Advanced Features
- Departure Scheduling: Predict traffic patterns by specifying future ISO-8601 formatted departure timestamps to understand historical congestion variables.
- AgentMail Workflow Integration: Seamlessly pipe outputs to an automated email flow for periodic, hands-free inbox updates using custom cron jobs.
- Zero-Dependency Core: Operates purely on curl and native bash shell utilities, making it highly portable across continuous integration pipelines and lightweight runtime containers.
SKILL.md
Loading
Related Openclaw Skills
Into Thin Air - Mount Everest Disaster AI Guide
An AI-powered analytical guide to Jon Krakauer's Into Thin Air, dissecting risk management, human error, and survival principles from the 1996 Mount Everest tragedy.
Incidents in the Life of a Slave Girl AI Agent Skill
An advanced context-injection and intent-routing skill that equips AI agents with deep historical, structural, and thematic knowledge of Harriet Jacobs' seminal slave narrative.
Jurgen Klopp Biography AI Agent Skill
An AI-powered knowledge agent skill detailing Elmar Neveling's definitive biography of Jurgen Klopp to extract tactics, leadership models, and sports management philosophies.
QWeather
A highly precise weather inquiry skill utilizing the QWeather API to query real-time, hourly, and daily forecasts, as well as air quality metrics and alerts for cities across China.
Influence Is Your Superpower (Zoe Chance)
An interactive AI agent skill based on Yale Professor Zoe Chance's groundbreaking book, designed to help you master ethical persuasion, charisma, and creative negotiation.
Traffic Standards Knowledge Base
An AI-powered knowledge base skill that retrieves, queries, and formats official Chinese traffic and smart transportation standards (GB, JT, GA) for technical proposals.
Featured*
