Automatically generates deep-linked Waze navigation URLs for addresses, businesses, and calendar events with intelligent location context.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install waze
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 waze 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 Waze Navigation Skill?
The Waze Navigation Skill enables AI agents to create ready-to-use navigation links that open directly in the Waze mobile app. By leveraging public deep links and intelligent location parsing, this skill ensures users can transition from a text-based briefing or chat directly to turn-by-turn directions. It is a vital component of any travel-focused Openclaw Skills setup, focusing on accuracy and user convenience.
This skill is particularly effective because it does not require complex API keys. Instead, it utilizes Python-based URL encoding to format addresses into a schema that Waze understands, making it lightweight and highly reliable for agents managing schedules or performing local searches. It intelligently resolves vague destinations by cross-referencing user profile data to ensure the results are always local and relevant.
Waze Navigation Skill Use Cases
- Converting a text address into a clickable navigation link within a chat.
- Automatically adding directions to morning briefings when a calendar event has a location.
- Finding the nearest business or establishment (e.g., "closest pharmacy") based on the user current city.
- Resolving vague location names into full, navigable physical addresses to avoid travel errors.
How Waze Navigation Skill Works
- Identifies the user current city by scanning context files like USER.md or SOUL.md within the workspace.
- Analyzes the destination provided by the user to determine if it is a specific address or a general establishment name.
- Uses search tools to resolve vague destinations into a full address (Street, Number, Neighborhood, City, State), prioritizing proximity to the user.
- Encodes the finalized address into a Waze-compatible URL format using Python logic to ensure special characters are handled correctly.
- Presents the link as a clean Markdown hyperlink, such as [Open in Waze], for immediate use on mobile devices.
Waze Navigation Skill Setup
To integrate this into your library of Openclaw Skills, ensure your agent has access to a search tool for resolving business names and follow these steps:
- Define your primary location in your
USER.mdorSOUL.mdfile to provide necessary search context. - Use the following Python pattern to generate links within your workflows:
from urllib.parse import quote
address = "Av. Jerônimo Monteiro, 1000, Vitória, ES, Brasil"
link = f"https://waze.com/ul?q={quote(address)}&navigate=yes"
print(link)
- Configure your agent to automatically scan agenda events for location strings during briefing generation.
Waze Navigation Skill Data Schema & Taxonomy
The skill processes location data and outputs structured navigation URLs according to the following schema:
| Parameter | Description | Requirement |
|---|---|---|
q |
URL-encoded string containing the full address, state, and country. | Required |
navigate |
Boolean flag set to 'yes' to trigger immediate routing. | Required |
City Context |
Extracted from USER.md or SOUL.md to filter search results. | Required for vague queries |
Output Format |
Markdown formatted hyperlink: [Text](URL) |
Recommended |
Waze Navigation Skill Advanced Features
- Automated Briefing Integration: Scans calendar event locations and appends navigation links without specific user prompts.
- Contextual Proximity Logic: Prevents cross-country location errors by strictly filtering search results to the user registered city.
- Deep-Link Fallback: Links automatically open the Waze web interface if the mobile application is not installed on the device.
- Ambiguity Resolution: Automatically appends state and country information to search queries to ensure the correct global destination is selected.
SKILL.md
Loading
Related Openclaw Skills
Weather Query Skill
A precision tool for AI agents to query and report real-time global weather conditions, including temperature, humidity, and wind speed.
Printer (CUPS)
A comprehensive automation toolkit for managing macOS printers and CUPS queues directly through command-line interfaces.
PSD Automator Skill Command
A specialized skill command for dispatching automated Photoshop tasks through a centralized orchestration pipeline.
Gousto Recipe Skill
A high-performance CLI tool for searching and retrieving detailed Gousto recipes, including ingredients and cooking instructions.
Workplace Manager
A sophisticated workspace management system for orchestrating multi-agent workflows, isolated project memory, and seamless context switching.
Workplace Skill
A sophisticated project management framework for orchestrating multi-agent workflows, isolated memory, and seamless context switching across various codebases.
Featured*
