flightAI for Openclaw

A comprehensive Python-based AI assistant for domestic flight searching, seat queries, bookings, and full ticket lifecycle management.

gaogao605
v1.0.0
Mar 30, 2026
0
243
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install flight-booking

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-booking 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 sophisticated travel automation skill designed to integrate domestic flight management into AI agent workflows. By utilizing Python 3 scripts to interact with backend flight services, this skill allows users to perform complex travel tasks through simple natural language or programmatic triggers. It covers everything from initial route discovery to post-booking services like endorsements and refunds.

Built to enhance the ecosystem of Openclaw Skills, flightAI handles the heavy lifting of API authentication via SMS, temporary data caching for seat selection, and secure transmission of passenger identification. It is an essential tool for developers building travel-oriented AI agents that require reliable, real-time access to domestic aviation data.

flightAI Use Cases

  • Searching for domestic flight lists based on origin, destination, and departure dates.
  • Querying detailed cabin pricing, seat availability, and discount levels for specific flight numbers.
  • Creating official flight orders by collecting passenger names, phone numbers, and identification documents.
  • Managing existing bookings through order status checks, cancellations, or refund requests.
  • Searching for and applying flight changes (endorsements) to adapt to changing travel plans.

How flightAI Works

  1. Authentication is initiated by sending an SMS verification code to the user's mobile device via the auth script.
  2. The user verifies the code to receive a unique apiKey, which is automatically saved to ~/.fbt_auth.json for persistence across Openclaw Skills sessions.
  3. Flight searches are performed using city names and dates, returning structured lists of airlines, times, and minimum prices.
  4. Detailed cabin queries cache specific seat information in /tmp/flight_seat_items.json to ensure data integrity during the booking process.
  5. Order creation scripts transmit user-provided PII to the flight service to generate a unique order ID and payment link.
  6. Post-booking scripts allow the agent to query refund fees or search for new flight windows for endorsements based on the original order ID.

flightAI Setup

To begin using flightAI within the Openclaw Skills environment, ensure you have python3 installed and follow these steps:

  1. Request a verification code:
python3 scripts/auth.py send <your_phone_number>
  1. Verify the code to generate your API key:
python3 scripts/auth.py verify <your_phone_number> <verification_code>
  1. Confirm authentication status:
python3 scripts/auth.py status

flightAI Data Schema & Taxonomy

The skill organizes its operations through persistent configuration and temporary session caches:

File Path Purpose Data Type
~/.fbt_auth.json Stores the persistent apiKey for all flight service requests. JSON
/tmp/flight_seat_items.json Caches recent cabin and pricing data for booking selection. JSON
/tmp/endorse_seat_items.json Caches available slots and fees for flight change requests. JSON

All date-related parameters must follow the YYYY-MM-DD format for compatibility with Openclaw Skills workflows.

flightAI Advanced Features

  • Integrated SMS-based authentication for secure session management and API access.
  • Sophisticated flight endorsement engine that handles search, price calculation, and application in a multi-step workflow.
  • Automated PII handling protocols to ensure passenger data is only transmitted during secure order creation.
  • Pre-refund estimation tool that provides detailed fee breakdowns before final submission to avoid unexpected costs.
  • Support for complex domestic travel rules including baggage allowance and specific cabin refund policies.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*