flights

What This Skill Does

The Flight Query skill provides real-time access to global flight information through the Amadeus API. It allows the OpenClaw AI agent to search for flight prices, schedules, and seat availability, bridging the gap between natural language requests and complex airline reservation databases. Whether you are planning a business trip or a personal vacation, this tool processes origin and destination IATA codes to fetch precise flight data. It includes built-in intelligence for over 40 Chinese cities, making it particularly powerful for users navigating travel within China, while maintaining the flexibility to fall back to the global Amadeus database for international routes.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal: clawhub install openclaw/skills/skills/kirorab/amadeus-flights After installation, you must configure your credentials by setting the environment variables AMADEUS_API_KEY and AMADEUS_API_SECRET. To switch from simulated testing data to real-time production data, set the AMADEUS_BASE_URL to https://api.amadeus.com. Ensure your system has Node.js installed to execute the internal scripts provided by the package.

Use Cases

This skill is designed for travel planning and itinerary optimization. Common use cases include:

• Determining the most cost-effective travel dates by comparing prices across a specific week.
• Finding direct flights to minimize travel time between major hubs.
• Automating business travel bookings by querying specific classes, such as business or first class, for corporate trips.
• Quick lookup of IATA airport codes using the integrated airport utility, which saves time by mapping city names directly to airport codes.

Example Prompts

1. "Find me a direct flight from Hong Kong to Shanghai on February 25th, 2026."
2. "What are the business class options for flights from Jieyang to Hangzhou on the 24th of February?"
3. "Show me the cheapest flight availability for Tokyo to Shanghai next week."

Tips & Limitations

The Amadeus API has a monthly usage limit on the free tier (2,000 calls per month), so monitor your requests if you are using this in a high-frequency automation scenario. Note that production access requires valid credentials; testing environments will provide simulated data. Always verify specific airline policies regarding baggage and cancellations directly on the official carrier websites after querying availability. Use the --json flag if you intend to pipe this data into other data-processing workflows within your agent's ecosystem.