Gaode Map (AMap) Skill for Openclaw

A professional AI agent tool for integrating Gaode Map (AMap) services for real-time location discovery and multi-modal route planning.

beelkic
v1.0.0
Mar 18, 2026
0
929
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install gaodemapskill-conflict

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-conflict 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) Skill?

The Gaode Map skill is a powerful extension designed for Openclaw Skills that enables AI agents to interact directly with the AMap (Gaode) API. This integration allows agents to perform complex geographic tasks such as searching for points of interest (POIs) and calculating optimal routes between coordinates or addresses. By leveraging this skill, developers can provide their agents with high-fidelity mapping data specifically optimized for the Chinese mainland, bridging the gap between natural language requests and actionable spatial intelligence.

Whether you are building a personal assistant or a logistics automation tool, this skill provides a standardized way to fetch location data and navigation instructions. It fits seamlessly into the Openclaw Skills ecosystem, utilizing simple environment-based configuration and a clean Python-based interface for reliable performance.

Gaode Map (AMap) Skill Use Cases

  • Automating the discovery of local amenities like restaurants, gas stations, or hospitals based on user keywords.
  • Generating detailed route plans for various transportation modes including driving, walking, and cycling.
  • Calculating public transit routes within specific cities to assist with travel itinerary creation.
  • Geocoding natural language addresses into precise longitudinal and latitudinal coordinates for backend processing.

How Gaode Map (AMap) Skill Works

  1. The AI agent identifies a location-based intent from the user input.
  2. The Openclaw Skills runner executes the amap_tool.py script with the necessary search or route parameters.
  3. The script authenticates with the Gaode Open Platform using the AMAP_API_KEY environment variable.
  4. The tool sends a request to the AMap Web Service API (Search or Direction endpoints).
  5. The returned JSON data is processed and presented back to the agent to fulfill the user's request.

Gaode Map (AMap) Skill Setup

To get started with this skill, you must first obtain an API Key from the Gaode Map Open Platform. Once you have your key, configure your environment and run the tool using the following steps:

# Set your AMap API Key
export AMAP_API_KEY="your_api_key_here"

# Perform a place search
python amap_tool.py search --keywords "coffee" --city "Beijing"

# Plan a driving route
python amap_tool.py route --origin "Shanghai Tower" --destination "The Bund" --mode "driving"

Gaode Map (AMap) Skill Data Schema & Taxonomy

The Gaode Map skill organizes geographic data through specific parameters to ensure high accuracy in the Openclaw Skills environment:

Parameter Description Required
keywords The query string for POI searches (e.g., 'ATM') Yes (Search)
city The target city for limiting search results or transit planning Optional
origin The starting point as an address or 'lon,lat' string Yes (Route)
destination The end point as an address or 'lon,lat' string Yes (Route)
mode Travel method: driving, walking, bicycling, or transit Optional

Gaode Map (AMap) Skill Advanced Features

  • Support for multi-modal navigation including public transit, driving, cycling, and walking.
  • Dynamic geocoding support allowing users to provide either friendly names or raw coordinates.
  • Seamless integration with other Openclaw Skills to trigger location-based workflows.
  • Error handling for API rate limits and invalid location queries to ensure agent stability.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*