✈️ ClawFlight Skill

AI-first flight search that finds flights with Starlink internet. Built for business travelers and digital nomads who need to work on long-haul flights.

What It Does

• 🔍 Search flights between any airports
• 🛜 Filter Starlink — only shows flights with Starlink-equipped airlines
• ⭐ Rank by priority — WiFi quality, price, duration, or jet lag friendliness
• 🔗 Affiliate links — direct booking links (Kiwi.com + Skyscanner)
• 📊 Rate flights — submit WiFi quality ratings (speed, reliability, ease)
• ⏰ Post-flight nudge — save flights, get prompted 6h after landing

Setup

# Install dependencies
cd ~/clawd/projects/clawflight/skill
npm install

# Get a FREE Amadeus API key (no credit card required):
# 1. Go to https://developers.amadeus.com/self-service
# 2. Register → Create App → copy Client ID + Secret
# 3. Set environment variables:

export AMADEUS_CLIENT_ID="your_client_id"
export AMADEUS_CLIENT_SECRET="your_client_secret"

# Optional: use production data (requires moving to production in Amadeus portal)
export AMADEUS_ENV=production

The WiFi ratings database is maintained by ClawFlight — you only need to provide your own Amadeus key for live flight data. No other API key required.

Commands

Find a flight

clawflight search --from BKK --to LHR --date 2026-03-14 --priority wifi

Options:

• --from, -f — Origin IATA code (e.g., BKK, LHR, SFO)
• --to, -t — Destination IATA code
• --date, -d — Departure date (YYYY-MM-DD)
• --priority, -p — Sort by: wifi (default), cheap, fast, jetlag
• --adults, -a — Number of passengers (default: 1)
• --json — Output machine-readable JSON

List Starlink airlines

clawflight airlines

Shows all airlines in the database with WiFi scores and fleet coverage.

Save a flight (for post-flight rating)

clawflight save --flight UA123 --arrival 2026-03-15T14:30:00Z

Saves flight info. A cron job will nudge you 6 hours after arrival to rate the WiFi.

Rate a flight

clawflight rate --airline UA --speed 5 --reliability 4 --ease 5

Submit WiFi quality ratings to build the community database.

Examples

"Find me a flight from NYC to London next week with good WiFi"

clawflight search --from JFK --to LHR --date 2026-03-10 --priority wifi

Output:

🛫 ClawFlight Results

✈️ #1 — United Airlines (Starlink ⭐ 4.7)
   Mar 10 | 7h05 | $540 | New York → London
   Book: https://www.kiwi.com/deep?affilid=clawflight&booking_token=...

✈️ #2 — Air France (Starlink ⭐ 4.3)
   Mar 10 | 7h25 | $485 | New York → Paris → London
   Book: https://www.kiwi.com/deep?...

"Show me the cheapest option"

clawflight search --from SFO --to NRT --date 2026-04-01 --priority cheap

"I want to minimize jet lag"

clawflight search --from LAX --to SYD --date 2026-05-15 --priority jetlag

Airline Database

The skill uses a curated list of Starlink-equipped airlines stored in data/airlines.json. Current carriers:

Note: Fleet coverage is approximate. Airlines swap aircraft. Not guaranteed on every flight.

Integration with OpenClaw

This skill can be called from within OpenClaw conversations:

User: I need a flight from Bangkok to London next month
Agent (uses clawflight): Let me find Starlink flights for you...

Files

skill/
├── package.json       # Dependencies (axios, commander)
├── clawflight.js      # Main CLI script
└── SKILL.md          # This file

data/
├── airlines.json      # Starlink airline database
├── saved-flights.json # User-saved flights
└── ratings.json      # Community WiFi ratings

Getting an API Key

1. Go to https://tequila.kiwi.com
2. Sign up (free tier available)
3. Get your API key
4. Set: export KIWI_API_KEY="your_key"

Affiliate Program

• Kiwi.com: 5% commission on bookings
• Affiliate ID: clawflight
• Links auto-tagged with your ID

Maintenance

• Airline data: Updated weekly (Samantha cron)
• Community ratings: User-submitted via rate command
• Database location: ~/clawd/projects/clawflight/data/

Built with 🐙 by Samantha & Antoine

V1.0 — Feb 2026