flightAI for Openclaw

An AI-powered aviation assistant for searching, booking, changing, and refunding domestic flights via Python-driven automation.

ryan-zry
v1.0.0
Mar 26, 2026
1
784
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install flightai

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 flightai 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?

flightAI is a robust travel management skill designed for the Openclaw Skills ecosystem. It empowers AI agents to handle the entire lifecycle of domestic air travel, ranging from initial flight discovery and real-time seat availability checks to complex operations like ticket endorsements and refund processing. By leveraging Python3 and HTTP POST requests, it communicates directly with aviation service providers to deliver accurate pricing, detailed cabin rules, and secure booking capabilities.

Built with developer efficiency in mind, the skill includes a localized authentication flow and temporary data caching to streamline multi-step workflows. Whether you are building a personal travel concierge or an enterprise logistics bot, flightAI provides the necessary tools to navigate the complexities of flight schedules and passenger information management securely.

flightAI Use Cases

  • Searching for domestic flight lists based on departure city, destination, and date.
  • Retrieving real-time cabin pricing and seat availability for specific flight numbers.
  • Creating official flight reservations with passenger PII (Personally Identifiable Information).
  • Managing post-booking tasks such as order detail lookups and ticket cancellations.
  • Automating flight changes (endorsements) by searching for new dates and calculating price differences.
  • Estimating refund fees and submitting formal refund applications.

How flightAI Works

  1. Authentication: The user performs a one-time SMS-based verification using auth.py to generate a secure apiKey stored in ~/.fbt_auth.json.
  2. Discovery: The agent calls search_flights.py to find available routes and lowest prices based on user intent.
  3. Selection: Detailed seat and cabin information is retrieved and cached in /tmp/flight_seat_items.json for subsequent steps.
  4. Booking: Upon user confirmation, create_order.py is executed with passenger details to generate an official order ID and payment link.
  5. Management: The agent monitors order status or initiates modification/refund workflows by passing the order ID to specialized scripts.

flightAI Setup

To integrate flightAI into your Openclaw Skills environment, ensure you have Python 3 installed. Follow these steps to authenticate:

# 1. Request a verification code to your phone
python3 scripts/auth.py send <phone_number>

# 2. Verify the code and obtain your apiKey
python3 scripts/auth.py verify <phone_number> <code>

# 3. Check authentication status
python3 scripts/auth.py status

flightAI Data Schema & Taxonomy

The skill utilizes local JSON files to manage session state and metadata taxonomy:

File Path Description
~/.fbt_auth.json Stores the persistent apiKey for API authorization.
/tmp/flight_seat_items.json Caches seat details from the latest price search for order creation.
/tmp/endorse_seat_items.json Stores temporary seat data for flight change (endorsement) processes.

Standard inputs follow the YYYY-MM-DD date format and airport triple-letter codes (e.g., PEK, PVG).

flightAI Advanced Features

  • Automated context awareness: The skill identifies missing parameters in the conversation and only prompts users for required data.
  • Secure PII Handling: Direct POST transmission of passenger data to ensure sensitive info is not leaked in logs.
  • Endorsement Calculation: Advanced logic to calculate the total cost of flight changes, including change fees and price differences.
  • Real-time Status Sync: Direct integration with order detail APIs to provide up-to-the-minute payment and issuance status.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*