amap

What This Skill Does

The amap skill provides OpenClaw AI agents with comprehensive geographical and weather-related capabilities by integrating the Amap (高德地图) Web Service API. It acts as an bridge, allowing users to perform complex geospatial operations such as finding specific locations, calculating travel routes, retrieving real-time weather, and performing coordinate conversions (geocoding). By leveraging this skill, your agent can understand spatial queries, provide logistics assistance, and deliver location-based insights with high precision using official mapping data.

Installation

To integrate this skill, ensure you have the OpenClaw CLI tool installed. Run the following command in your terminal: clawhub install openclaw/skills/skills/dboy233/amap

After installation, you must configure your API credentials. Obtain a Web Service API Key from the Amap Developer Portal and set it as an environment variable to allow the agent to authorize requests: export AMAP_KEY="your_api_key_here"

Use Cases

This skill is ideal for any scenario involving real-world location data. Use it for personal assistants helping with trip planning, logistical coordination for business automation, checking environmental conditions for specific cities, or data enrichment tasks where you need to translate street addresses into map coordinates (or vice versa). It bridges the gap between natural language requests and structured geospatial datasets.

Example Prompts

1. "What is the weather like in Shanghai right now, and what is the forecast for tomorrow?"
2. "Find the nearest coffee shop to 101 Huaihai Road, Shanghai, and tell me how to drive there."
3. "Convert the address 'Beijing National Stadium' into its precise latitude and longitude coordinates."

Tips & Limitations

• Pre-requisites: Many functions, such as weather and routing, depend on 'adcode' or precise coordinates. If the agent struggles, have it use the District or Geocoding functions first.
• Rate Limiting: Amap has specific quota limits on free tiers. Monitor your usage in the Amap Console to avoid service disruption.
• Security: Never hardcode your AMAP_KEY directly in scripts; always use environment variables.
• Data Accuracy: Always verify critical navigation data, as map services may occasionally experience delays or discrepancies in rapidly developing areas.