feishu-calendar-tool

What This Skill Does

The feishu-calendar-tool is a powerful automation utility for OpenClaw that enables seamless integration with Feishu (Lark) calendars. Designed for zero-configuration, it automatically retrieves credentials from your system's OpenClaw configuration file to manage your professional schedule. Users can create, delete, and list events without manually handling complex API tokens or IDs, as the agent leverages built-in discovery logic to identify your user_id and primary calendar_id automatically. It acts as an intelligent layer between your terminal and the Feishu API, handling token refresh, timezone alignment (Asia/Shanghai), and error handling on your behalf.

Installation

Installation is streamlined through the OpenClaw ecosystem. Simply execute the following command in your terminal: clawhub install openclaw/skills/skills/sunnull/feishu-calendar-tool Once installed, if you have already configured your Feishu application credentials within ~/.openclaw/openclaw.json, the tool is immediately ready for use. If you are a first-time user, navigate to the Feishu Open Platform, create an app, grant the necessary calendar and contact reading permissions, and add your App ID and Secret to your configuration file.

Use Cases

This skill is perfect for developers and project managers who want to automate their meeting workflows. You can create recurring project syncs, list upcoming project deadlines directly in your terminal, or delete rescheduled meetings without switching contexts to the Feishu GUI. It is also an excellent tool for script-based scheduling, allowing you to trigger event creation from other automated CI/CD pipelines or cron jobs.

Example Prompts

1. "Create a team sync meeting for tomorrow at 2:00 PM to 3:00 PM with the title 'Weekly Engineering Sync'."
2. "List all my scheduled events for the next 7 days to see if I am free for a lunch meeting."
3. "Delete the meeting with event ID 'evt_12345' from my calendar as it has been cancelled."

Tips & Limitations

• Tips: Always verify your setup using node bin/test-credentials.mjs before executing high-volume actions. The tool intelligently caches authentication data for 24 hours to ensure high performance and low latency.
• Limitations: The skill is primarily optimized for the Asia/Shanghai timezone. Ensure your system clock is accurate. It focuses on the primary calendar; if you manage multiple secondary calendars, you may need to specify IDs manually. The tool is strictly a read/write interface and will never modify your core configuration files.