A comprehensive location intelligence tool that integrates Gaode Map APIs for POI searching, route planning, and real-time weather analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install amap-search-skill
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 amap-search-skill 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 amap-search?
amap-search is a robust location services skill designed to empower AI agents with the full suite of Gaode Map Web Service APIs. By integrating this skill, developers can provide their agents with the ability to perform complex spatial tasks such as geocoding addresses, discovering points of interest, and calculating multi-modal travel routes.
As part of the expanding ecosystem of Openclaw Skills, amap-search bridges the gap between digital reasoning and physical location intelligence. It provides high-accuracy data for the Chinese mainland, making it an essential tool for developers building localized AI assistants, logistics bots, or travel planning agents. The skill supports structured JSON outputs, ensuring seamless integration into larger automated workflows.
amap-search Use Cases
- Locating users or businesses via IP positioning and high-precision geocoding.
- Planning multi-modal travel routes including driving, walking, and public transit.
- Retrieving real-time weather conditions and multi-day forecasts for automated reporting.
- Conducting local business discovery (POI) with calculated real-world driving distances.
- Monitoring traffic congestion on specific roads to optimize delivery or travel schedules.
How amap-search Works
- The AI agent or user invokes a specific command such as poi, route, or weather with required parameters.
- The skill validates the request and authenticates using a pre-configured Gaode Map Web Service API Key.
- A request is dispatched to the Gaode Map cloud infrastructure to retrieve spatial, routing, or meteorological data.
- The raw API response is parsed and formatted into human-readable text or structured data.
- The results are returned to the agent, enabling it to complete tasks within the Openclaw Skills framework.
amap-search Setup
To get started, you must first obtain an API Key from the Gaode Open Platform (https://lbs.amap.com) under the Web Service category.
Configure your environment using the following commands:
# Set your API Key as an environment variable
export AMAP_API_KEY="your_api_key_here"
# Alternatively, pass it directly via the CLI
python3 gaode_map.py weather --key your_api_key_here --city Beijing
amap-search Data Schema & Taxonomy
The amap-search skill organizes geographic and environmental data into clear, actionable structures. All commands support a --json flag for standardized output.
| Data Type | Key Metadata Fields | Coordinate Format |
|---|---|---|
| POI | Name, Address, Phone, Distance | Longitude, Latitude |
| Routing | Distance (meters), Duration (seconds), Navigation Steps | Longitude, Latitude |
| Weather | Temperature, Humidity, Wind Power, Forecast Array | N/A |
| Traffic | Status (Congested/Smooth), Road Description | N/A |
amap-search Advanced Features
- Multi-modal routing logic supporting transit, driving, and walking modes.
- Real-time traffic monitoring for specific road segments or city-wide grids.
- Structured JSON output mode for deep integration with other Openclaw Skills.
- Automated distance calculation between search results and the user's origin point.
- Intelligent input tips for search auto-completion and suggestion workflows.
SKILL.md
Loading
Related Openclaw Skills
Claw Self Improving Plus
A conservative learning pipeline that transforms AI agent mistakes, discoveries, and decisions into structured, human-approved memory improvements.
Travel Customizer
An intelligent travel assistant that collects customer requirements through natural dialogue and automates data entry into Feishu tables.
Video Toolbox Reference
An offline, high-speed reference tool for mastering Video Toolbox concepts, implementation patterns, and development best practices.
Product Query Helper
An automated e-commerce assistant that translates search queries, scrapes CoDropshipping product data, and organizes results into structured tables.
Apple Search Ads (ASA) Specialist
An interactive AI strategist designed to help developers build, diagnose, and scale high-performance Apple Search Ads campaigns.
MD2WeChat Skill
A professional tool for converting Markdown documents into perfectly styled WeChat Official Account articles with automated media handling.
Featured*
