flightAI: AI Flight Booking Assistant for Openclaw

An AI-driven assistant for searching domestic flights, managing cabin bookings, and handling ticket endorsements or refunds via Python-based automation.

gaogao605
v1.0.0
Mar 30, 2026
0
256
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install flight-deals

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install flight-deals 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 flightAI: AI Flight Booking Assistant?

flightAI is a sophisticated technical skill designed for AI agents to interact with domestic flight services. Part of the broader library of Openclaw Skills, it provides a structured interface for searching flight schedules, comparing seat prices across different cabins, and executing transaction-heavy tasks such as booking and payment link generation.

The skill is built to prioritize security and efficiency, using Python 3 scripts to facilitate HTTP POST requests. It handles the entire lifecycle of air travel management, from initial city-to-city discovery to post-purchase ticket modifications like endorsements and cancellations, ensuring that developers can build robust travel assistants with minimal overhead.

flightAI: AI Flight Booking Assistant Use Cases

  • Searching for domestic flight lists by departure city, arrival city, and date.
  • Retrieving detailed cabin pricing and seat availability for specific flight numbers.
  • Creating official flight orders with passenger PII (Personal Identifiable Information).
  • Estimating refund fees and submitting refund applications.
  • Searching and applying for flight endorsements when travel plans change.

How flightAI: AI Flight Booking Assistant Works

  1. Authentication: The user initiates a session by verifying their phone number via a script, which saves a persistent API key to a local configuration file.
  2. Discovery: The agent executes search scripts to fetch real-time flight data, which is displayed to the user in a structured table format.
  3. Selection and Caching: Once a flight is chosen, the agent retrieves seat details and caches the metadata in a temporary JSON file to ensure data consistency during the booking phase.
  4. Transaction: For bookings or changes, the agent collects necessary passenger details and transmits them securely to the flight service to generate an order ID and payment link.
  5. Management: Users can query order details or initiate cancellations and refunds through specialized scripts that track the order lifecycle.

flightAI: AI Flight Booking Assistant Setup

To use this skill within the Openclaw Skills framework, you must have Python 3 installed. Follow these steps to authenticate:

# Send a verification code to your phone
python3 scripts/auth.py send <your_phone_number>

# Verify the code to obtain and save your API key
python3 scripts/auth.py verify <your_phone_number> <verification_code>

# Check the current authentication status
python3 scripts/auth.py status

flightAI: AI Flight Booking Assistant Data Schema & Taxonomy

The flightAI skill manages data across several key files and formats to maintain state during a flight search and booking session:

Data Object File Location Description
API Key ~/.fbt_auth.json Stores the persistent authentication token for all API requests.
Booking Cache /tmp/flight_seat_items.json Caches available seat and cabin metadata for the current search.
Endorsement Cache /tmp/endorse_seat_items.json Stores seat data specific to flight change/endorsement workflows.
Passenger PII In-memory / POST Passenger names, IDs, and phone numbers are handled strictly for order creation and are not logged.

flightAI: AI Flight Booking Assistant Advanced Features

  • Contextual parameter awareness: The agent avoids asking redundant questions if departure, arrival, or date information is already present in the conversation history.
  • Integrated PII Security: Strict adherence to data privacy by ensuring sensitive passenger information is only used for transaction execution.
  • Multi-stage Refund Logic: Mandatory user confirmation of estimated refund fees before any refund application is submitted.
  • Endorsement Search: Specialized lookup for alternative flights that specifically support ticket changes from an existing order.
  • Standardized Output: All flight and cabin data is rendered in high-fidelity tables using plaintext code blocks for maximum readability.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*