A sophisticated tool for cross-provider map workflows including geocoding, routing, and spatial data normalization.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install maps
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 maps 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 Maps?
The Maps skill for Openclaw Skills provides a unified interface for handling complex spatial tasks across multiple platforms. It allows AI agents to intelligently switch between providers like Google Maps, Apple Maps, and OpenStreetMap based on cost, privacy, and task requirements. By abstracting the differences between various map APIs, this skill ensures consistent results for place searches, coordinate normalization, and route planning while avoiding common pitfalls like coordinate swapping or avoidable quota burn.
This skill is essential for users who need to bridge the gap between machine-readable spatial data and user-friendly map interfaces. It manages the logic required to decide whether a task needs a structured API response for calculations or a simple browser link for visualization, making it a cornerstone for location-aware automation within the ecosystem of Openclaw Skills.
Maps Use Cases
- Performing forward and reverse geocoding across multiple providers to verify address accuracy.
- Generating shareable map links or opening routes directly in native applications like Apple Maps on macOS.
- Calculating precise travel time estimates and driving distances using professional routing engines.
- Managing automated provider fallbacks to maintain accuracy when API limits or privacy constraints are met.
- Standardizing spatial data from disparate sources into a canonical decimal format.
How Maps Works
- The agent identifies the specific mapping task, such as a place search or route request, and checks the local provider matrix.
- It selects the optimal provider based on task-specific rules, prioritizing Apple for macOS launches and Google for high-density place data.
- Local memory files in the maps directory are consulted for recurring places and context to reduce search ambiguity.
- Spatial data is normalized to standard decimal latitude and longitude to ensure compatibility across different provider schemas.
- The action is executed as either a structured data request via API or a generated map link for user preview.
- The run log is updated to refine future provider selection and document any coordinate drift or failures.
Maps Setup
To get started with the Maps skill in your Openclaw Skills environment, initialize the local directory structure and set up your provider preferences:
mkdir -p ~/maps/
# Use the clawhub CLI to install and sync the skill
clawhub install maps
After installation, ensure you have configured your desired API keys for paid providers like Google Maps or Mapbox if you require live data beyond basic OpenStreetMap or link generation features.
Maps Data Schema & Taxonomy
The Maps skill organizes its state and preferences within the ~/maps/ directory to ensure local persistence and privacy:
| File | Purpose |
|---|---|
memory.md |
Stores activation rules, provider defaults, and specific privacy boundaries. |
provider-notes.md |
Tracks known provider quirks, quota limits, and verified technical workarounds. |
recurring-places.md |
Stores user-approved recurring origins, destinations, and frequently used contexts. |
run-log.md |
Maintains a record of failures, ambiguous matches, and applied fixes for optimization. |
Maps Advanced Features
- Advanced provider fallback logic that automatically switches to OpenStreetMap when premium quotas are reached.
- Automatic coordinate normalization to 6 decimal places to prevent rooftop and curbside result drift.
- Context-aware disambiguation that appends city, region, or postal code metadata to vague searches.
- Full integration with other Openclaw Skills like travel, apple-maps, and car-rental for end-to-end trip planning.
- Pre-execution previews for high-impact actions like opening routes or sharing sensitive location links.
SKILL.md
Loading
Related Openclaw Skills
Product Image Upscaler
Enhance the clarity and resolution of ecommerce product images to make them commercially viable for listings, PDPs, and digital ads.
Audio to Text Caption
A high-efficiency transcription and captioning workflow designed for creators and e-commerce teams.
TikTok Affiliate ROI Calculator
A high-performance financial modeling tool designed to estimate TikTok affiliate campaign profitability and risk before launch.
My IP Checker
A streamlined utility for identifying public and local network IP addresses via simple shell commands.
Word
A macOS-specific skill for AI agents to control live Microsoft Word applications, handling selections, comments, and review states via osascript.
Forguncy Web Operator
A specialized tool for programmatically interacting with and extracting data from SpreadJS tables within Forguncy web applications.
Featured*
