jetlag-planner

What This Skill Does

The jetlag-planner is a specialized OpenClaw agent skill designed to proactively manage your circadian rhythm during travel. It integrates directly with your Google Calendar to identify upcoming flight itineraries. Once a flight is detected, the agent analyzes the timezone shift and generates a personalized, step-by-step adjustment schedule. These adjustments are then automatically written back to your calendar as distinct events, helping you prepare your body for time zone transitions before you even reach the airport. The planner intelligently handles various trip durations and timezone differences, ensuring you only receive adjustment plans for significant journeys that would typically cause jetlag.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/chadholdorf/openclaw-jetlag

After installation, you must ensure your Google OAuth credentials are correctly configured. Navigate to the ~/openclaw-jetlag/ directory to manage your .env file and perform the initial authorization. If the planner fails to execute, verify that your credentials remain valid and that your Google account has the necessary calendar permissions enabled.

Use Cases

This skill is perfect for frequent business travelers, international digital nomads, or vacationers who want to minimize the physical impact of long-haul travel. Instead of manually calculating when to shift your sleep, light exposure, or caffeine intake, the agent automates the entire planning process. It is particularly useful for users who rely on Google Calendar as their central source of truth for travel itinerary management.

Example Prompts

1. "Check my flights to see if I need a jetlag adjustment plan for next week."
2. "Run the jetlag planner, I have a flight to Tokyo on Friday."
3. "Am I ready for my upcoming flight? Run the adjustment planner."

Tips & Limitations

The jetlag-planner looks specifically at flights within the next 90 days. If your flight is not visible in your linked Google Calendar—for example, if the confirmation email was sent to a different account or was not auto-parsed into your calendar—the agent will not be able to detect it. Please ensure your travel confirmation emails are properly synced to your calendar for optimal functionality. If you encounter errors, always run the manual node execution command provided in the setup steps to debug potential environment issues.