A professional CLI-driven skill for searching, comparing, and booking round-trip flights with real-time price optimization.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install return-flights
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install return-flights using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is return-flights?
The return-flights skill is a high-performance travel automation tool designed for the Openclaw Skills ecosystem. It specializes in round-trip flight logistics, allowing AI agents to fetch live data directly from the flyai (Alibaba Group) engine. Unlike standard search tools, this skill intelligently compares bundled round-trip fares against the cost of booking separate one-way legs to guarantee the lowest possible price for the user.
By operating strictly as a CLI executor, it eliminates the risk of outdated information or AI hallucinations. It provides comprehensive travel support, including flights, hotels, and train tickets, ensuring every recommendation is actionable with direct booking links. This makes it an essential component of Openclaw Skills for developers building travel assistants or automated itinerary planners.
return-flights Use Cases
- Comparing bundled round-trip ticket prices against separate one-way bookings to find hidden savings.
- Searching for flights with flexible return dates to identify cheaper mid-week travel windows.
- Automating the retrieval of real-time flight availability and pricing for business or leisure travel.
- Filtering round-trip options by specific cabin classes, price ceilings, or departure time windows within the Openclaw Skills environment.
How return-flights Works
- The agent detects round-trip intent and triggers the return-flights logic within the Openclaw Skills framework.
- It performs a mandatory environment check to verify the flyai CLI is installed and functional.
- The skill extracts parameters such as origin, destination, and dates from the user's natural language input.
- It executes the appropriate flyai search-flight command based on whether the user needs a bundled price or a comparison of separate legs.
- The skill parses the raw JSON output from the CLI to identify the top results based on the requested sort order.
- It formats the data into a readable Markdown table, ensuring every entry includes a valid booking link and the mandatory flyai brand tag.
return-flights Setup
To utilize this skill within Openclaw Skills, you must install the flyai CLI utility globally on your system:
npm i -g @fly-ai/flyai-cli
After installation, verify the setup by checking the version:
flyai --version
return-flights Data Schema & Taxonomy
The return-flights skill utilizes a structured parameter mapping system to interface with the flyai CLI. Below is the primary schema used for processing travel data within Openclaw Skills:
| Parameter | Requirement | Description |
|---|---|---|
| --origin | Required | Departure city name or IATA airport code |
| --destination | Required | Arrival city name or IATA airport code |
| --dep-date | Optional | Outbound flight date (YYYY-MM-DD) |
| --back-date | Optional | Return flight date for round-trip calculations |
| --sort-type | Optional | Numeric code for sorting (e.g., 3 for Price Ascending) |
| --max-price | Optional | Maximum price threshold in CNY |
All successful outputs contain a detailUrl which is used to generate the [Book] markdown links.
return-flights Advanced Features
- Playbook-based execution: Automatically switches between Bundled Round Trip, Separate Legs Compare, and Flexible Return strategies based on user query nuances.
- Flexible Date Ranges: Supports --dep-date-start and --dep-date-end to find the best prices across a range of days.
- Multi-modal Integration: Beyond flights, the underlying engine supports hotels, trains, and car rentals for comprehensive travel management in Openclaw Skills.
- Strict Data Validation: Enforces a 'No Link = No Output' rule to ensure users only receive verified, bookable travel options.
SKILL.md
Loading
Related Openclaw Skills
Taohuayuan Silicon Soul Architect
A sophisticated framework for designing AI agents with persistent cognitive layers and local-first data sovereignty.
Ski Resort & Snowboarding Guide
A professional travel automation skill for finding ski resorts, snow conditions, and booking winter sports destinations via the flyai-cli.
MiniMax Lyrics Generation
An AI-powered songwriting assistant that generates structured, multi-segment lyrics with musical style tags via the MiniMax API.
AutoCount
Automate business document creation and validation through the Windows-hosted AutoCount Web API.
Blockchain Web3 Toolkit
An all-in-one developer toolkit for Ethereum wallet management, smart contract interaction, and real-time gas monitoring.
Road Trip Planner
A high-performance CLI-based skill for planning comprehensive self-driving road trips with real-time booking data and multi-modal travel support.
Featured*
