navclaw

What This Skill Does

NavClaw (导航助手) is an intelligent traffic navigation AI agent designed to outperform standard map applications. By leveraging the Amap (Gaode) Web Service API, it performs a five-stage planning process—ranging from broad route discovery to iterative optimization—to identify the most efficient driving paths, especially during heavy traffic. Unlike standard navigation apps, NavClaw explores unconventional detours and provides a comprehensive, multi-platform approach to travel planning. It generates detailed comparison tables, provides quick-access navigation links for iOS and Android, and supports direct notification integration via Mattermost, or standard text output for other platforms via OpenClaw.

Installation

1. Ensure you have Python 3.8+ installed.
2. Install the necessary dependency: pip install requests.
3. Install the skill into your OpenClaw environment: clawhub install openclaw/skills/skills/ai4mse/navclaw.
4. Create your configuration: Copy config_example.py to config.py.
5. Obtain an Amap (Gaode) Web Service API Key from https://lbs.amap.com/ and paste it into the API_KEY field in config.py.
6. (Optional) Configure Mattermost credentials (MM_BASEURL, MM_BOT_TOKEN, MM_CHANNEL_ID) in config.py to enable direct file attachments and rich messaging.

Use Cases

• Daily Commuting: Quickly calculate the optimal route to work or home while automatically avoiding reported congestion.
• Road Trip Planning: Use deep-iteration modes (MAX_ITER = 1) to analyze dozens of potential routes, ensuring you choose the fastest path even under complex traffic conditions.
• Smart Mobility: Integrate navigation results directly into team communication platforms like Mattermost for shared travel planning with colleagues or family.

Example Prompts

• "从公司到静安嘉里中心导航，帮我看看现在怎么走最快"
• "导航从虹桥机场到浦东新区，采用深度避堵模式"
• "我要回家，帮我规划最优路线"

Tips & Limitations

• Efficiency: Short trips typically resolve in ~6 seconds, while long-distance, high-traffic routes may take up to 30 seconds due to extensive API calls.
• Testing: Start with MAX_ITER = 0 to verify your API Key configuration before proceeding to intensive search modes.
• Connectivity: The skill requires an active internet connection to communicate with the Gaode API.
• Platform Support: While it natively supports Mattermost, you can use the --no-send flag for any other chat platform; OpenClaw will read the stdout output and relay the instructions directly to you, ensuring you never lose your navigation links.