Access real-time New Zealand state highway traffic conditions, road closures, and live camera feeds via the Waka Kotahi NZTA API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install nzta-traffic
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 nzta-traffic 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 NZTA Traffic?
The NZTA Traffic skill provides a direct interface for AI agents and developers to query the Waka Kotahi NZTA Traffic and Travel REST API. It allows users to monitor state highways across New Zealand's 14 regions without requiring an API key. By integrating this into Openclaw Skills, you can automate road safety checks, monitor incidents, and visualize traffic through live camera metadata.
This skill is particularly useful for developers building logistics tools or regional information bots that need current data on roadworks, accidents, and travel delays. It handles the complexity of region IDs and journey mappings, making it easy to fetch status updates for specific routes like SH1.
NZTA Traffic Use Cases
- Monitoring road closures and major delays on SH1 and other major state highways.
- Checking live traffic cameras near major cities like Wellington or Auckland for visual verification.
- Automating travel alerts and notifications for regional commutes or logistics planning.
- Researching current roadworks impact across New Zealand regions for infrastructure reporting.
How NZTA Traffic Works
- The user provides a region name, highway ID, or coordinate bounding box to the script.
- The skill sends a request to the Waka Kotahi REST API endpoint using the appropriate parameters.
- The API returns real-time data regarding traffic events, incidents, or camera feeds.
- The skill processes the response, categorizing events by impact levels such as Closed or Major delays.
- Real-time data is output as a human-readable summary or raw JSON for further automation.
NZTA Traffic Setup
To start using this skill within your Openclaw Skills environment, ensure the script is executable and call it via the CLI.
# List all available regions and their IDs
scripts/nzta-traffic.sh --list-regions
# Check traffic events for a specific region
scripts/nzta-traffic.sh --region Wellington
NZTA Traffic Data Schema & Taxonomy
The skill interacts with the NZTA API to provide structured data regarding road incidents and infrastructure. Below is the primary metadata taxonomy:
| Field | Description |
|---|---|
| regionId | Numerical ID of the New Zealand region (1-14) |
| impact | Severity level: Closed, Major delays, Minor delays, Caution, or Watch |
| eventDescription | Detailed text description of the road incident or roadwork |
| cameras | Metadata for live traffic imagery including location and URL |
| geometry | Geographic coordinates for mapping events when requested |
NZTA Traffic Advanced Features
- Bounding box (bbox) queries for targeted geographic traffic monitoring within specific coordinates.
- Automatic highway journey ID discovery via the --list-journeys flag to isolate specific road stretches.
- Multi-format output support with a --json flag for seamless integration into larger Openclaw Skills data pipelines.
- Geometry zoom level controls to optimize data payload for different mapping requirements.
SKILL.md
Loading
Related Openclaw Skills
Moltbook Authentic Engagement
A sophisticated engagement protocol for AI agents on Moltbook that prioritizes genuine voice and quality interactions over automated growth hacking.
Commit Analyzer
A diagnostic tool that analyzes git commit patterns to evaluate the operational health and productivity of autonomous AI agents.
AgentFolio
A centralized registry and verification platform for discovering and listing autonomous AI agents.
Megasquirt ECU Tuner
A specialized tool for tuning and calibrating Megasquirt engine management systems via TunerStudio and automated MSQ file analysis.
Browser Automation v2
Enterprise-grade browser automation for OpenClaw featuring robust resource management, tab cleanup, and smart waiting mechanisms.
agent-browser
A headless browser automation CLI designed for AI agents to navigate, interact with, and extract data from websites seamlessly.
Featured*
