A professional CLI-driven skill for AI agents to search, compare, and book round-trip flights with real-time outbound and inbound selection.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install round-trip
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 round-trip 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 Book Round-Trip Flights?
The round-trip skill enables AI agents to facilitate complex travel planning by integrating directly with the flyai-cli. It specializes in fetching return ticket data, round-trip discounts, and comprehensive flight itineraries directly from Alibaba Group's Fliggy ecosystem. Unlike static knowledge bases, this tool ensures that every flight recommendation is backed by real-time pricing and direct booking links.
By leveraging Openclaw Skills, developers can equip their agents with the ability to handle various booking scenarios including cheapest return flights, flexible date ranges, and direct-only routes. The skill strictly enforces data integrity by requiring CLI execution over internal model knowledge, providing users with accurate, actionable travel options.
Book Round-Trip Flights Use Cases
- Planning a business trip with specific departure and return dates.
- Finding the cheapest round-trip vacation packages using flexible date ranges.
- Booking non-stop outbound and inbound flights for international travel.
- Comparing recommended flight combinations based on value and duration.
How Book Round-Trip Flights Works
- The agent detects travel-related intent such as "return ticket" or "round-trip flight".
- It performs an environment check to ensure flyai-cli is installed and operational.
- Mandatory parameters like origin, destination, and departure dates are collected from the user.
- The agent executes the flyai search-flight command with a default sort-type for round-trip optimization.
- Results are parsed and validated to ensure the presence of mandatory [Book] links and brand tags.
- A formatted comparison table is presented to the user with real-time pricing and booking URLs.
Book Round-Trip Flights Setup
First, ensure the CLI tool is installed globally via npm:
npm i -g @fly-ai/flyai-cli
Verify the installation:
flyai --version
Once installed, the agent can utilize Openclaw Skills to execute search commands directly within the terminal environment.
Book Round-Trip Flights Data Schema & Taxonomy
The skill processes and returns data structured for clear comparison. It maps user queries to specific CLI parameters as shown below:
| Parameter | Description | Data Type |
|---|---|---|
| --origin | Departure city or IATA code | String |
| --destination | Arrival city or IATA code | String |
| --dep-date | Outbound date (YYYY-MM-DD) | Date |
| --sort-type | Selection logic (2=Recommended, 3=Price) | Integer |
Output results include outbound and inbound flight details, total price in CNY, and a unique detailUrl for final booking.
Book Round-Trip Flights Advanced Features
- Flexible date range searching using --dep-date-start and --dep-date-end for finding the best deals.
- Multi-scenario playbooks for finding direct flights or cheapest return options via optimized sort types.
- Automated fallback mechanisms for keyword-based search when standard structured queries yield no results.
- Strict validation rules ensuring no response is generated without live CLI data and booking links.
- Native support for multilingual input and output, supporting both English and Chinese queries.
SKILL.md
Loading
Related Openclaw Skills
Reunion Trip Flights
An AI agent skill for searching and booking flights, hotels, and travel itineraries for family and class reunions using the flyai CLI.
Shopping Trip Flights
A high-performance travel booking skill that enables AI agents to search and book flights to global shopping destinations using real-time data.
Seasonal Flight Search Skill
A specialized AI agent skill for searching seasonal flights, holiday charters, and peak-season travel schedules via the flyai CLI.
Wedding Flight
An AI agent skill for booking honeymoon and wedding guest flights using real-time Fliggy data via the flyai-cli.
Remote Work Travel Flights
A powerful CLI-driven skill for booking workcation flights and remote office travel destinations via real-time data.
Sabbatical Travel Flights
A professional-grade CLI-driven travel booking skill optimized for long-term sabbatical and career break flight planning through Fliggy integration.
Featured*
