ncloud-maps

What This Skill Does

The ncloud-maps skill is a specialized navigation assistant for OpenClaw that integrates directly with the Naver Cloud Maps ecosystem. It allows users to query real-time driving data, including travel time, total distance, anticipated toll fares, taxi costs, and estimated fuel consumption. The standout feature is its 'Smart Routing' mechanism, which automatically selects between the Directions5 and Directions15 APIs depending on the complexity of your request. By analyzing the number of waypoints provided, the skill ensures you are always using the most cost-effective and appropriate API for your trip. This eliminates the need for manual configuration when dealing with simple point-to-point journeys versus complex multi-stop routes.

Installation

To get started, first register your application in the Naver Cloud Console to obtain your Client ID and Client Secret. Ensure the 'Maps Directions15' API is explicitly enabled for your project. Once you have your credentials, set them as environment variables in your operating system or within a local .env file using the keys NCLOUD_API_KEY_ID and NCLOUD_API_KEY. Finally, navigate to your skill workspace directory (~/.openclaw/workspace/skills/ncloud-maps) and execute npm install to resolve all necessary dependencies. You can install the skill package directly via the terminal by running: clawhub install openclaw/skills/skills/beomsu317/ncloud-maps.

Use Cases

This skill is ideal for logistics management, travel planning, and automated reporting. Users can calculate fuel efficiency for commercial routes or determine the optimal path for a delivery driver with multiple stops. Because the skill integrates seamlessly with geocoding tools like goplaces or naver-local-search, it is perfect for users who need to convert human-readable addresses into precise navigation routes without leaving the OpenClaw environment. It is particularly useful for developers building location-aware agent workflows.

Example Prompts

1. "Calculate the driving route, expected taxi fare, and travel time from Gangnam Station to Incheon International Airport."
2. "Find the shortest path for a delivery trip starting at 126.9633,37.5524 and stopping at three locations: 127.0165,37.4889, 127.05,37.50, and 127.10,37.55."
3. "How much will the tolls cost and how long will it take to drive from my office at 127.0049,37.4947 to the city hall?"

Tips & Limitations

The ncloud-maps skill requires precise geographic coordinates. If you input addresses directly, ensure you are running a geocoding pre-step using a compatible skill like naver-local-search to convert those addresses into the required 'longitude,latitude' format. Note that while the tool handles automatic API switching, you are still bound by the quota limits of your Naver Cloud subscription. Always monitor your API usage in the Naver Cloud Dashboard to avoid service interruptions. For complex routes, ensure your waypoint order is logical to avoid inefficient navigation paths.