Gaode Map (AMap) Integration for Openclaw

A specialized skill for AI agents to perform real-time location searches and multi-modal route planning via the Gaode Map (AMap) API.

beelkic
v1.0.0
Mar 18, 2026
0
912
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gaodemapskill-bak

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gaodemapskill-bak 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 Gaode Map (AMap) Integration?

The Gaode Map Skill is a technical bridge that connects AI agents to the robust geospatial data provided by AMap. By leveraging this tool, developers can empower their agents to interpret geographic intent and return actionable location data or navigation paths. This integration is a cornerstone for applications requiring local commerce discovery, logistics optimization, or travel assistance within the ecosystem of Openclaw Skills.

Built with a focus on simplicity, the skill wraps complex API requests into a streamlined CLI interface. It handles geocoding and routing logic, allowing the AI to interact with physical world coordinates and addresses through high-level Python commands.

Gaode Map (AMap) Integration Use Cases

  • Automating point-of-interest discovery for travel planning agents.
  • Calculating travel times and distances for logistics and delivery automation.
  • Enhancing virtual assistants with local business search capabilities in specific cities.
  • Generating multi-modal navigation instructions (driving, walking, cycling, transit) for user queries.

How Gaode Map (AMap) Integration Works

  1. The AI agent receives a natural language prompt involving a location or a journey.
  2. The agent identifies the need for geospatial data and invokes the amap_tool.py script.
  3. The skill checks for the AMAP_API_KEY environment variable to authenticate with Gaode Map servers.
  4. Parameters such as keywords, city, origin, and destination are passed to the AMap Web Service API.
  5. The skill processes the JSON response from AMap and returns structured location or route data back to the agent.

Gaode Map (AMap) Integration Setup

To deploy this skill within your Openclaw Skills environment, ensure you have an active AMap API Key and Python installed.

# Export your API Key
export AMAP_API_KEY="your_amap_api_key_here"

# Basic search test
python amap_tool.py search --keywords "restaurant" --city "Beijing"

# Route planning test
python amap_tool.py route --origin "Shanghai Tower" --destination "The Bund" --mode "walking"

Gaode Map (AMap) Integration Data Schema & Taxonomy

The skill manages data through direct API interaction and returns structured outputs that the AI agent parses. Below is the primary parameter taxonomy:

Parameter Type Description
keywords String Search query for POIs (e.g., coffee, hospitals).
city String Optional city filter for search and geocoding.
origin/destination String Start and end points (supports addresses or "lon,lat").
mode String Transport method: driving, walking, bicycling, or transit.

Gaode Map (AMap) Integration Advanced Features

  • Multi-modal transport support including public transit and cycling paths.
  • Intelligent geocoding that converts semantic addresses into precise longitude/latitude coordinates.
  • City-specific filtering to increase search accuracy and reduce latency.
  • Seamless integration with existing Openclaw Skills workflows via standard environment variables.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*