Flightmapify
by @rudy2steiner
Find cheapest flights and create interactive flight route maps with real-time flight search.
clawhub install flightmapifyπ About This Skill
name: flightmapify version: 1.4.6 description: Find cheapest flights and create interactive flight route maps with real-time flight search. author: rudy2steiner license: MIT tags: [flights, maps, routing, flyai, travel, interactive]
FlightMapify Skill
Overview
FlightMapify creates interactive flight route maps that allow users to search for flights between cities and visualize flight paths on an interactive map. Unlike TravelMapify which focuses on ground travel routes, FlightMapify is specifically designed for air travel planning.Features
Usage
Environment Setup
FlightMapify is an OpenClaw skill that supports optional user-configurable FlyAI API Key.Configuration Options:
1. User-provided API Key (Recommended - avoids rate limiting) Get your API key from: https://flyai.open.fliggy.com/console
export FLYAI_API_KEY=your_api_key_here
2. FlyAI Built-in API Key (Default)
- If FLYAI_API_KEY is not configured, FlyAI will use its built-in default API key
- Built-in key may have rate limits for frequent requests
- No configuration required for basic usage
Environment Variables:
FLYAI_API_KEY: Your FlyAI API key for flight search (optional, recommended to avoid rate limits)FLYAI_API_TOKEN: Alternative API token variable (optional)FLYAI_TOKEN: Another API token variable for compatibility (optional)Note: FLYAI_API_KEY is optional. If not set, FlyAI will use its built-in default API key, but this may be subject to rate limiting for frequent requests.
Generate Flight Map
# Generate a flight map between two cities
flightmapify --origin "εδΊ¬" --destination "δΈζ΅·" --date "2026-04-22" --output flight-beijing-shanghai.html
Parameters
--origin: Departure city (required)--destination: Arrival city (required) --date: Travel date in YYYY-MM-DD format (required)--output: Output HTML file name (required)--port: HTTP server port (default: 9000)Integration
FlightMapify integrates with the existing FlyAI skill for real-time flight search and booking capabilities. It uses Amap for map visualization and provides a clean, focused interface for flight planning.API Keys
AMAP_API_KEY environment variable to use your own keyLocal Server Architecture
Technical Details
Server Architecture
Flight Data
Environment Variables
FLYAI_API_KEY: Your FlyAI API key for flight search (optional, recommended to avoid rate limits)FLYAI_API_TOKEN: Alternative API token variable (optional)FLYAI_TOKEN: Another API token variable for compatibility (optional)Note: FLYAI_API_KEY is optional. If not set, FlyAI will use its built-in default API key, but this may be subject to rate limiting for frequent requests. Setting your own API key is recommended for production use or high-volume requests.
Changelog
Version 1.4.0 (2026-04-16)
Version 1.3.0 (2026-04-16)
Version 1.2.0 (2026-04-16)
Version 1.1.0
Examples
# Basic flight map
flightmapify --origin "εδΊ¬" --destination "ιΏε
θ" --date "2026-04-22" --output beijing-aksu-flight.htmlWith custom port
flightmapify --origin "δΈζ΅·" --destination "δΉι²ζ¨ι½" --date "2026-05-01" --output shanghai-urumqi-flight.html --port 8080
Troubleshooting Common Problems
π΄ "No flights found" or Empty Results
Possible Causes:
Solutions: 1. Get your own FlyAI API key from https://flyai.open.fliggy.com/console
export FLYAI_API_KEY=your_api_key_here
2. Try closer dates (within 3-6 months)
3. Test with major city pairs first (Beijing-Shanghai, Guangzhou-Shenzhen)π΄ 404 File Not Found Error
Cause: HTML file generated in wrong directory
Solution:
AGENTS.md or SOUL.mdπ΄ Character Encoding Issues (δΉ±η )
Symptoms: Chinese cities show as garbled text like "ιΏε θ―"
Cause: URL parameter double-decoding
Solution:
π΄ Flight Search Server Won't Start
Symptoms: "Failed to start flight search server on port XXXX"
Causes & Solutions:
1. Port already in use: Server automatically finds next available port
2. Missing dependencies: Ensure flyai CLI is installed
npm install -g @openclaw/flyai
3. Permission issues: Run with appropriate permissionsπ΄ API Key Configuration Issues
Problem: Still getting rate limits after setting API key
Solutions: 1. Verify key is set correctly:
echo $FLYAI_API_KEY
2. Check FlyAI config file:
cat ~/.flyai/config.json
3. Use environment variable method (more reliable):
export FLYAI_API_KEY=sk_your_actual_key
flightmapify --origin "εδΊ¬" --destination "δΈζ΅·" --date "2026-04-25" --output test.html
π΄ Map Not Loading or JavaScript Errors
Causes:
Solutions: 1. Amap key is built-in - no user configuration needed 2. Open HTML file via HTTP server (not file:// protocol) 3. Check browser console for specific error messages
π‘ Performance Issues with Many Flights
Symptoms: Slow loading with routes having many connecting options
Solutions:
π§ Debugging Tips
1. Check server logs:
# Look for Python server output in your terminal
2. Test FlyAI CLI directly:
flyai search-flight --origin "εδΊ¬" --destination "δΈζ΅·" --dep-date "2026-04-25"
3. Verify file locations:
ls -la ~/.openclaw/workspace/*.html
4. Check port availability:
lsof -i :9000 # Replace with your port
π When to Contact Support
Contact the skill maintainer if:
Include in your report:
openclaw --version)π‘ Examples
# Basic flight map
flightmapify --origin "εδΊ¬" --destination "ιΏε
θ" --date "2026-04-22" --output beijing-aksu-flight.htmlWith custom port
flightmapify --origin "δΈζ΅·" --destination "δΉι²ζ¨ι½" --date "2026-05-01" --output shanghai-urumqi-flight.html --port 8080