dingtalk-calendar

What This Skill Does

The dingtalk-calendar skill is a specialized OpenClaw agent capability designed to manage DingTalk enterprise calendar operations seamlessly. It provides a robust interface to handle the full lifecycle of calendar events, including CRUD operations on the user's primary calendar. Beyond simple scheduling, this skill empowers users to manage complex meeting requirements, such as checking room availability, booking meeting rooms, generating digital sign-in/out links, and setting recurrence rules for repeating appointments. By leveraging DingTalk's OAPI, the agent ensures that all calendar interactions are synchronized with the organizational workspace, maintaining consistency across team schedules and resource management.

Installation

To integrate this skill, use the following OpenClaw command: clawhub install openclaw/skills/skills/breath57/dingtalk-calendar-only-curl. After installation, ensure the scripts/dt_helper.sh utility is correctly configured. You must provide your DINGTALK_APP_KEY, DINGTALK_APP_SECRET, and DINGTALK_MY_USER_ID. The agent will automatically map these credentials to the required unionId format necessary for API interactions. Keep your credentials secure and follow the CLI prompts to initialize the local configuration in ~/.dingtalk-skills/config.

Use Cases

• Efficient Scheduling: Quickly create, update, or cancel meetings with specific participants or recurring intervals.
• Resource Management: Automatically query available meeting rooms and assign them to existing calendar events based on room status and time windows.
• Meeting Attendance: Generate secure sign-in and sign-out links for attendees to ensure accurate meeting participation tracking.
• Workflow Synchronization: Check colleague availability or personal busy/free status to optimize team collaboration and prevent double-booking.

Example Prompts

• "帮我查一下下周三下午2点到4点空闲的会议室，如果有的话，定一个‘项目启动会’。”
• "查看下我的日程，如果有标记为‘周会’的循环日程，把它下周的时间挪到周四。”
• "为今天下午的部门会议生成一个签到链接，并发送到群里。”

Tips & Limitations

• Time Precision: Always use UTC ISO8601 strings with millisecond precision (e.g., 2026-03-24T07:02:48.000Z) to avoid API validation errors.
• Identity Management: Remember that API routes require unionId. Use the --to-unionid helper function if you only have a userId.
• Primary Calendar: Always use primary as the calendarId for individual operations.
• Permission: Ensure your application has Calendar.Calendar.Write scopes enabled in the DingTalk developer console to execute modification tasks.