A unified map aggregation tool that enables AI agents to search for locations and nearby points of interest using Amap, Baidu, and Tencent Maps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install map-search
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 map-search 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 Map Search Skill?
The Map Search Skill is a specialized tool designed to provide AI agents with robust geographic intelligence within the Chinese ecosystem. By integrating the three major map providers—Amap (Gaode), Baidu, and Tencent—this skill offers a reliable way to query Point of Interest (POI) data, addresses, and geographic coordinates. It is an essential component for Openclaw Skills users who require high-accuracy location data for logistics, travel planning, or local service discovery.
This skill provides a fallback mechanism and priority-based logic, ensuring that if one map service is unavailable or lacks data, the agent can seamlessly retrieve information from an alternative provider. It handles the complexities of different API structures, presenting a unified output that is easy for AI models to parse and utilize in broader workflows.
Map Search Skill Use Cases
- Searching for businesses, restaurants, or landmarks within specific cities or regions.
- Finding essential services like hotels or coffee shops near the user's current IP-based location.
- Verifying addresses and coordinates across multiple map providers for data validation.
- Automating location-based research tasks within an AI-driven workspace.
How Map Search Skill Works
- The skill loads API keys and provider priorities from a local JSON configuration file or system environment variables.
- When a search is triggered, the skill identifies whether it is a regional keyword search or a radius-based nearby search.
- It executes concurrent or sequential requests to the configured map APIs (Amap, Baidu, Tencent) based on the user's defined priority.
- For nearby searches, the skill can automatically determine the origin point using IP-based geolocation if specific coordinates are not provided.
- The raw JSON responses from the map providers are filtered and normalized into a consistent format containing names, addresses, and location data.
- The aggregated results are returned to the AI agent or displayed in the CLI for immediate use.
Map Search Skill Setup
To use this Map Search Skill, ensure you have Python 3 installed and follow these steps:
# Install the required Python library
pip install requests
# Configure your API keys in the config file
mkdir -p ~/.config/openclaw/
cat <<EOF > ~/.config/openclaw/map_config.json
{
"amap": { "api_key": "YOUR_AMAP_KEY" },
"baidu": { "api_key": "YOUR_BAIDU_KEY" },
"tencent": { "api_key": "YOUR_TENCENT_KEY" },
"priority": ["amap", "tencent", "baidu"]
}
EOF
# Alternatively, set environment variables
export AMAP_API_KEY="YOUR_AMAP_KEY"
export BAIDU_MAP_API_KEY="YOUR_BAIDU_KEY"
export TENCENT_MAP_API_KEY="YOUR_TENCENT_KEY"
Map Search Skill Data Schema & Taxonomy
The skill organizes results by provider and follows a structured taxonomy for every POI found. Openclaw Skills users can expect the following data structure:
| Attribute | Description |
|---|---|
| Source | The map provider (e.g., Amap, Baidu, Tencent) |
| Name | The formal name of the location or business |
| Address | The full formatted physical address |
| Location | Latitude and Longitude coordinates |
| Distance | Real-world distance from the search origin (Nearby mode only) |
Map Search Skill Advanced Features
- Nearby Search Mode: Use the
--nearbyflag to find locations within a customizable radius (defaulting to 2000 meters). - IP Geolocation: Automatically resolves the user's current latitude and longitude using Amap's IP positioning when coordinates are omitted.
- Priority Ordering: Configure the
priorityarray in the JSON settings to define which map provider should be queried first. - Coordinate Support: Manually specify latitude and longitude for precise searches in specific geographic areas using
--latand--lngflags.
SKILL.md
Loading
Related Openclaw Skills
Logistics Tracking
A professional MCP-based logistics tracker supporting 3100+ global carriers with both API and headless browser fallback modes.
Chinese E-commerce Product Search
A zero-config AI agent skill for searching, comparing, and retrieving product details across 8 major Chinese e-commerce platforms.
QuorumAI
A multi-model AI synthesis tool that aggregates responses from four major LLMs to provide a single, arbitrated best answer.
vydra
A unified API for AI-powered image generation, video creation, and voice synthesis across multiple leading models.
1Password CLI Skill
Securely manage, inject, and run secrets using the 1Password CLI within managed terminal environments.
Feishu Task Integration
A high-performance skill for syncing local tasks with Feishu Tasks via smart natural language processing.
Featured*
