aerobase-flights

What This Skill Does

The aerobase-flights skill is a specialized travel assistant integrated into OpenClaw, designed to help travelers minimize the physical and mental toll of long-haul flights. By leveraging the Aerobase API, this skill goes beyond standard flight booking by providing advanced jetlag scoring, recovery projections, and comparative analysis based on biological impacts. It evaluates flight paths, departure/arrival times, and cabin classes to calculate how much your internal clock will be disrupted, offering specific strategies to mitigate the fatigue associated with crossing multiple time zones. Whether you are a business traveler trying to stay sharp for a meeting or a vacationer wanting to hit the ground running, this tool provides the data-driven insights needed to choose the healthiest flight itinerary.

Installation

To integrate this skill into your environment, use the OpenClaw hub command:

clawhub install openclaw/skills/skills/kurosh87/aerobase-skill

After installation, ensure your environment is authenticated by setting your Aerobase API key:

export AEROBASE_API_KEY="your_api_key_here"

You can obtain your key by visiting the Aerobase website.

Use Cases

• Corporate Travel Optimization: Analyze different flight options for international conferences to select the route that ensures the fastest recovery time.
• Vacation Planning: Use the search functionality to find flights that naturally align with your desired sleep schedule at the destination.
• Direct Comparison: Use the comparison tool to weigh the price-to-jetlag ratio of two or more potential flight paths.
• Personalized Health: Input your chronotype to receive customized strategies for shifting your circadian rhythm before and after arrival.

Example Prompts

1. "Find me the best flights from SFO to LHR on November 10th for business class, sorted by lowest jetlag impact."
2. "Compare these two flights for a trip to Tokyo: one arrives at 8 AM and the other at 4 PM. Which one is better for a night owl like me?"
3. "I am traveling from NYC to Dubai. Generate a recovery plan for me assuming I am an early bird and flying in economy."

Tips & Limitations

• Chronotype Matters: Always specify your chronotype (early_bird, night_owl, or normal) when requesting detailed scores to ensure accuracy.
• Data Limits: Note that the free tier of the API limits search results to 5 flights, while the pro tier extends this to 50.
• Contextual Factors: While this tool provides scientifically backed scoring, remember that individual recovery rates can vary. Treat the generated recovery plans as guidance rather than medical advice.
• Data Freshness: Always ensure your departure and arrival timestamps include the correct UTC offset to allow for precise timezone calculations.