feishu-calendar-manager

What This Skill Does

The feishu-calendar-manager skill is a zero-configuration tool designed to streamline the management of your Feishu (Lark) calendar events. It automates the retrieval of necessary credentials and calendar IDs, allowing you to seamlessly create, delete, and query calendar events directly from your command line. This skill leverages the Feishu Calendar v4 API and is built for efficiency, automatically discovering your user ID and primary calendar ID. It also implements smart caching for credentials and configurations, keeping them fresh for 24 hours to reduce API calls and improve performance.

Key features include automatic credential loading from ~/.openclaw/openclaw.json, automatic discovery of user_id and calendar_id, support for creating events with details like title, start/end times, description, and location, the ability to delete existing events by their ID, and the capability to list events within a specified date range.

Installation

To install the feishu-calendar-manager skill, use the following command:

clawhub install openclaw/skills/skills/sunnull/feishu-calendar-manager

For the skill to function correctly, you need to configure your Feishu application credentials. The skill automatically looks for these credentials in the following order:

1. Environment variables (if set).
2. ~/.openclaw/openclaw.json (Recommended).
3. ~/openclaw/.secrets.env.
4. ~/.secrets.env.

If you haven't configured your Feishu application, follow these steps:

1. Create a Feishu App: Visit the Feishu Open Platform and create a new application to obtain your App ID and App Secret.

2. Add Permissions: In your application's management page, add the following permissions:

   • calendar:calendar (Read and write calendar)
   • calendar:calendar:readonly (Read calendar)
   • contact:user.base:readonly (Automatically get user ID)
   • contact:user.employee_id:readonly (Read employee directory).

3. Configure openclaw.json: Edit or create the ~/.openclaw/openclaw.json file with your Feishu credentials:

   {
     "channels": {
       "feishu": {
         "accounts": {
           "default": {
             "appId": "YOUR_APP_ID",
             "appSecret": "YOUR_APP_SECRET",
             "enabled": true
           }
         }
       }
     }
   }
   

Once configured, the skill operates with zero additional setup.

Use Cases

The feishu-calendar-manager skill is ideal for users who want to efficiently manage their Feishu calendar from the command line without complex setup. It's particularly useful for:

• Automating event creation: Quickly add new meetings, reminders, or appointments directly via commands.
• Quickly checking schedules: View upcoming events for the day or a specific period.
• Managing events: Easily delete events that are no longer needed.
• Developers and power users: Integrate calendar management into scripts or workflows.
• Users with multiple Feishu accounts: The skill supports configurations for multiple accounts, prioritizing the default account.

Example Prompts

1. "Schedule a team sync for tomorrow from 10 AM to 11 AM and add a note about discussing project X."
2. "What meetings do I have next Monday?"
3. "Delete the event with ID cl99xxxxxx."

Tips & Limitations

• Zero Configuration: The skill's primary advantage is its zero-configuration setup when Feishu credentials are provided in ~/.openclaw/openclaw.json. Ensure this file is correctly formatted.
• Timezone: The default timezone is Asia/Shanghai. You can specify a different timezone using the --timezone parameter when creating events if needed.
• Event ID: When deleting an event, make sure you have the correct event-id. You can obtain this ID when creating an event or by listing events if the API provides it.
• Caching: The skill caches credentials and configurations for 24 hours. If you update your Feishu app credentials, you might need to wait for the cache to expire or restart your OpenClaw instance for changes to take effect immediately.
• Error Handling: The skill includes an intelligent error retry mechanism, but complex network issues or API rate limits might still cause failures. Check the output for specific error messages.
• Multiple Accounts: While the skill supports multiple Feishu accounts, ensure they are correctly defined in your openclaw.json and that the default account is properly enabled. The skill prioritizes the default account.