feishu-attendance

What This Skill Does

The Feishu Attendance skill is a robust management tool designed to automate the oversight of employee attendance within the Feishu (Lark) ecosystem. By interfacing directly with the Feishu platform, this skill autonomously tracks punch-in and punch-out events, identifying anomalies such as late arrivals, early departures, and unexcused absences. It is engineered with business logic that understands the nuance of modern work schedules by integrating with the timor.tech API to cross-reference dates against public holidays and weekends, ensuring that employees are only evaluated on actual workdays. The skill employs a secure, caching-heavy architecture that stores user lists and holiday data for 24 hours, optimizing performance while minimizing API consumption. When an issue is detected, it generates high-fidelity, interactive Feishu cards for administrators, providing an immediate overview of team status without manual intervention.

Installation

To integrate this skill into your OpenClaw environment, ensure you have the necessary Feishu app permissions enabled, specifically attendance:report:readonly, contact:user.employee:readonly, and im:message:send_as_bot. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/autogame-17/feishu-attendance

Once installed, ensure your environment variables (such as Feishu app credentials and bot tokens) are correctly configured to allow the skill to authenticate and interact with your workspace.

Use Cases

• Automated Daily Reporting: HR managers can receive a daily, structured report of team attendance punctuality at the end of each workday.
• Holiday Compliance: Automatically pause attendance checks during public holidays to prevent false-positive notifications.
• Performance Auditing: Use the --date flag to generate retrospective reports for monthly or weekly performance reviews.
• Safe Operational Testing: Use the --dry-run flag to audit your configuration without alerting employees or sending real notifications.

Example Prompts

1. "OpenClaw, check the attendance for today and send a summary to the HR channel."
2. "Run the feishu-attendance check for last Friday to verify attendance records."
3. "Start a dry run of the attendance check to see which employees would be flagged for late arrival today."

Tips & Limitations

• Caching: The skill uses a 24-hour cache for user lists. If you hire or offboard someone, expect up to one day for the skill to recognize the roster change.
• API Dependencies: The accuracy of the holiday-aware feature relies on timor.tech. If this external service is down, the skill defaults to 'Safe Mode' to avoid sending notifications.
• Permissions: Always ensure the bot has 'read' access to attendance reports and 'write' access to messages, or it will fail to report data to your admin channel.
• Dry Runs: Always perform a --dry-run when first configuring the skill to ensure your holiday settings are properly calibrated to your region.