A comprehensive Amap (高德地图) integration for AI agents to perform intelligent route planning and detailed Point of Interest (POI) searches.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install smart-map-guide
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 smart-map-guide 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 Smart Map Guide (Amap Integration)?
The Smart Map Guide is a specialized integration designed to empower AI agents with real-time geographic intelligence via the Amap (高德地图) API. This skill enables agents to calculate precise routes for driving, walking, cycling, and public transit while providing deep search capabilities for local attractions and restaurants. By incorporating this into your Openclaw Skills library, you provide your developer environment or AI assistant with the capability to act as a sophisticated travel planner and local guide, handling complex geocoding and navigation logic automatically.
Smart Map Guide (Amap Integration) Use Cases
- Planning multi-day travel itineraries and sightseeing schedules within specific cities.
- Recommending top-rated restaurants or local landmarks based on user preferences.
- Generating detailed transit instructions and commuting routes for urban navigation.
- Automating location-based research for digital marketing or logistics analysis.
How Smart Map Guide (Amap Integration) Works
- The AI agent interprets a user's location-based request and identifies the required navigation or search parameters.
- The agent invokes the Python-based CLI tool with specific subcommands such as driving, transit, or attractions.
- The skill script authenticates with the Amap API using a pre-configured API key to fetch real-time map data.
- The script processes the raw API response, handling coordinate identification and city-code mapping.
- Structured navigation data or POI lists are returned to the agent, often in JSON format for precise content generation.
Smart Map Guide (Amap Integration) Setup
To get started with this skill, follow these installation steps:
- Obtain an API Key from the Amap LBS Open Platform.
- Configure your credentials by editing the
skills/map/scripts/config.jsonfile:
{
"amap_key": "YOUR_AMAP_API_KEY"
}
- Verify the installation by running a sample search via the terminal:
python3 skills/map/scripts/map.py search --keywords "Museum" --city "Beijing"
Smart Map Guide (Amap Integration) Data Schema & Taxonomy
The Smart Map Guide organizes its operations through a structured set of parameters and configuration files to ensure compatibility within Openclaw Skills workflows:
| Component | Type | Description |
|---|---|---|
| config.json | File | Stores the amap_key for secure API authentication. |
| origin/destination | Argument | Supports both human-readable address names and longitude/latitude coordinates. |
| city_code | Parameter | Numeric identifiers (e.g., 010 for Beijing) required for transit routing. |
| output_format | Flag | Use --json to retrieve structured data objects for programmatic use. |
Smart Map Guide (Amap Integration) Advanced Features
- Support for --show-steps to provide granular, turn-by-turn navigation instructions for complex routes.
- Intelligent address resolution that automatically switches between coordinate-based and name-based positioning.
- High-density POI search filtering, allowing for specific exclusion or inclusion of categories like fast food or scenic spots.
- Cross-city public transit planning using specific city-code identifiers for accurate multi-region travel.
SKILL.md
Loading
Related Openclaw Skills
Global Weather
A zero-config weather query tool that provides real-time global weather data and multi-day forecasts in AI-optimized formats.
Global News & AI Digest
A zero-config news aggregator that delivers global headlines and deep AI research updates directly to your agent or terminal.
Email Mail Master
A comprehensive email automation tool allowing AI agents to send, receive, and manage messages across major providers like QQ, 163, and Alibaba Mail.
Baidu AI Search
A multi-mode search skill that bridges AI agents with the Baidu ecosystem, providing web search, encyclopedia lookups, and AI-synthesized results.
Video and Image File Analysis
A professional multimodal vision skill designed for deep analysis of images, videos, and visual files using high-performance LLMs.
Bing Wallpaper Skill
A lightweight tool for AI agents to retrieve the official daily Bing homepage background through multiple output formats.
Featured*
