jisu-calendar

What This Skill Does

The jisu-calendar skill acts as a comprehensive time and almanac assistant for the OpenClaw AI agent. It integrates the robust JisuAPI calendar service, enabling the AI to retrieve detailed temporal data beyond the standard Gregorian calendar. This includes Lunar calendar details, zodiac signs (Western astrology), Chinese zodiac animals, traditional 'Huangli' (Yellow Calendar) data such as auspicious and inauspicious activities, and official Chinese statutory holiday schedules. It effectively turns your agent into an expert on time-related queries, enabling it to bridge the gap between modern scheduling and traditional cultural observances.

Installation

To install this skill, ensure your OpenClaw environment is configured correctly, then execute the following command in your terminal:

clawhub install openclaw/skills/skills/jisuapi/jisu-calendar

After installation, you must register for an API key at https://www.jisuapi.com/api/calendar/ and set it in your environment variables. Use export JISU_API_KEY="your_api_key" for Linux/macOS or $env:JISU_API_KEY="your_api_key" for Windows PowerShell to enable authentication for the API calls.

Use Cases

This skill is ideal for users who need to manage schedules with cultural nuances or need quick lookups for dates. It is perfect for personal assistants managing personal planning (e.g., checking for lucky days to hold events), corporate administrative tasks (e.g., tracking statutory holiday adjustments), or cultural research contexts where understanding the lunar cycle and zodiac influence is required. The skill handles conversion between solar and lunar dates, making it an essential utility for anyone navigating the Chinese calendar system.

Example Prompts

1. "Check the lunar calendar for October 22, 2015. What are the auspicious activities for that day?"
2. "What is the holiday schedule for the upcoming Chinese New Year?"
3. "Tell me the zodiac sign and the Chinese zodiac animal for someone born on May 15, 1995."

Tips & Limitations

• Data Accuracy: The tool relies entirely on the JisuAPI external service. Ensure your network connectivity is stable and your API key remains valid.
• Formatting: When making manual API calls, ensure your dates strictly follow the YYYY-MM-DD format to avoid parsing errors.
• Usage Limits: Check your JisuAPI account dashboard for monthly request limits to avoid service interruptions during high-usage periods.
• Scope: This skill focuses specifically on Chinese cultural data and international calendar conversions; it does not manage personal calendar events (like meetings) in Google or Outlook calendars.