FlyAI for Openclaw

A comprehensive travel search and booking tool that leverages Fliggy MCP to handle flights, hotels, trains, and attractions via natural language.

yealexchen
v1.0.15
Apr 21, 2026
24
5.8k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install flyai

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 flyai 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 FlyAI?

FlyAI is a robust travel integration designed for the Openclaw Skills framework, enabling AI agents to perform real-time searches and bookings for global travel needs. By connecting to the Fliggy MCP, it provides developers and users with a unified interface for querying flights, hotels, cruises, visas, and even event tickets. It is engineered to handle complex natural language intents, making it easy to plan everything from simple weekend getaways to intricate business trips and international honeymoons.

The tool prioritizes structured data output, ensuring that search results for flights, trains, and POIs (Points of Interest) can be easily compared and processed. Whether you are looking for the cheapest airfare or a specific Marriott hotel package, FlyAI delivers real-time results with built-in support for rich media displays, including images and direct booking links.

FlyAI Use Cases

Primary Scenarios

  • Searching and comparing international and domestic flights for budget or business travel.
  • Finding and booking accommodations ranging from luxury resorts to local hostels.
  • Planning complete travel itineraries including attraction tickets, local tours, and car rentals.
  • Managing specialized travel logistics such as visa applications and airport transfers.
  • Organizing entertainment-focused trips involving concerts, sports events, and cultural shows.

How FlyAI Works

Workflow Lifecycle

  1. The user provides a natural language query related to travel (e.g., "find a hotel in Tokyo next week").
  2. The skill identifies the specific intent, such as flight_search or hotel_search, using pre-defined patterns.
  3. The flyai-cli triggers the corresponding Fliggy MCP service to fetch real-time data.
  4. The tool processes the raw data into a structured single-line JSON format for technical consumption.
  5. For end-user display, the results are formatted into Markdown, including rich text, comparison tables, and essential images.
  6. Direct booking links are generated using specific URL mapping (e.g., jumpUrl or detailUrl) to facilitate immediate action.

FlyAI Setup

Installation and Configuration

Install the CLI globally using npm to integrate this into your environment:

npm i -g @fly-ai/flyai-cli

Verify the installation by running a simple keyword search:

flyai keyword-search --query "what to do in Sanya"

Optional: Configure an API key for enhanced results and higher rate limits:

flyai config set FLYAI_API_KEY "your-key"

FlyAI Data Schema & Taxonomy

Data Organization and Metadata

FlyAI organizes travel data into specific subcommands, each returning structured JSON. Results are primarily output to stdout for piping into tools like jq.

Data Component Source Field Display Format
Hotel Images mainPic Standalone Markdown image tag
Other Images picUrl Standalone Markdown image tag
Booking Links jumpUrl / detailUrl Standalone [Click to book] link
Platform Alerts systemMessage Plain text hint at the end of output

All commands and their detailed parameter schemas are documented within individual reference files for flights, hotels, trains, and POIs.

FlyAI Advanced Features

Power-User Capabilities

  • Semantic AI Search: Move beyond keywords with ai-search to understand complex, multi-layered travel intents.
  • Marriott Group Integration: Dedicated search capabilities for Marriott hotels and exclusive hotel packages.
  • Flexible JSON Output: Designed for developers, the single-line JSON stdout allows for seamless integration into automated reporting or multi-agent workflows within Openclaw Skills.
  • Real-time Comparison: Use structured data to build automated price comparison engines for flights and hotels.
  • Contextual Date Handling: Supports dynamic date context using standard system commands for precise scheduling.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*