Amap Map for Openclaw

A comprehensive location intelligence skill providing POI search, route planning, and geocoding via the Amap LBS API.

klscool
v1.0.0
Mar 14, 2026
0
943
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install amap-map

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 amap-map 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 Map?

The Amap Map skill is a robust integration designed for Openclaw Skills that enables AI agents to interact with the Amap (Gaode) LBS platform. It provides high-precision location services including keyword-based search, nearby discovery, and complex route planning for various transport modes. By incorporating this skill, developers can automate tasks involving geographic data, mapping, and spatial analysis within their workflows.

Amap Map Use Cases

  • Finding local businesses, restaurants, or landmarks using keyword or nearby searches.
  • Planning navigation routes for walking, cycling, or driving between specific coordinates.
  • Converting physical addresses into longitude and latitude coordinates for data mapping.
  • Performing reverse geocoding to identify human-readable addresses from GPS coordinates.

How Amap Map Works

  1. The AI agent detects a location-based intent such as a route request or a search for nearby facilities.
  2. The Openclaw Skills framework invokes the amap.py script with the relevant command and parameters.
  3. The script sends an authenticated request to the Amap Web Service API using the provided API Key.
  4. Geographic data is retrieved and processed into a standard JSON response.
  5. The agent utilizes the structured data to provide navigation advice, search results, or coordinate details to the user.

Amap Map Setup

To use this skill, you must first obtain an API Key from the Amap LBS portal. Follow these steps:

  1. Register at lbs.amap.com and create a Web Service API Key.
  2. Update your Openclaw Skills configuration at ~/.openclaw/openclaw.json:
{
  "skills": {
    "entries": {
      "amap-map": {
        "enabled": true,
        "apiKey": "YOUR_AMAP_API_KEY"
      }
    }
  }
}
  1. Verify the installation by running the usage command:
python3 /root/.openclaw/skills/amap-map/scripts/amap.py --usage

Amap Map Data Schema & Taxonomy

The skill returns structured JSON data containing the following primary fields:

Field Description
status A string where "1" indicates success and "0" indicates failure.
info Descriptive status information or error messages.
data Specific POI details, route steps, or coordinates depending on the function.

Internal usage statistics are logged in ~/.openclaw/workspace/skills/amap-map/.usage.json to monitor API consumption.

Amap Map Advanced Features

  • Real-time usage tracking to monitor daily API quotas (default 5000 requests/day).
  • Multi-modal navigation logic supporting walking, bicycling (up to 500km), and driving routes.
  • Precise POI detail retrieval using unique identifiers for deeper business intelligence.
  • Seamless address normalization and coordinate transformation for mapping applications within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*