Whatsapp Telegram Calendar Alert

What This Skill Does

The Whatsapp Telegram Calendar Alert skill is a powerful automation tool designed to bridge the gap between your personal messaging and calendar management. It acts as an intelligent middleware, monitoring your WhatsApp messages for specific intent-based keywords such as 'meeting', 'rendez-vous', or 'urgent'. When the OpenClaw agent detects an appointment, it proactively alerts you via Telegram, offering a seamless interactive prompt to confirm whether the event should be added to your Google Calendar. By leveraging the WAHA (WhatsApp HTTP API) Docker container, the skill captures incoming messages, processes them through a local storage mechanism, and provides a structured workflow for personal productivity.

Installation

To begin, ensure you have Docker and Node.js installed on your system. Navigate to your terminal and execute the command clawhub install openclaw/skills/skills/vincent-labarthe/whatsapp-telegram-calendar-alert. Upon installation, run the provided ./setup.sh script. During the initialization process, you will be prompted to enter your Telegram Chat ID, which allows the agent to send you notifications. Finally, follow the instructions to scan the QR code displayed in your terminal using your WhatsApp mobile app to authenticate the session. Ensure the gog CLI is configured for Google Calendar integration if you intend to automate event creation.

Use Cases

This skill is ideal for busy professionals and students who frequently receive scheduling information via WhatsApp. It is particularly useful for tracking medical appointments, business meetings, or time-sensitive collaborative sessions that would otherwise get buried in a crowded chat history. By consolidating scattered requests into a single, actionable calendar event, you reduce the mental load of manual scheduling.

Example Prompts

1. "Check my WhatsApp and see if there are any new appointments that need to be added to my calendar."
2. "Did I receive any urgent messages in the last hour?"
3. "Show me the last 5 messages parsed by the WhatsApp store."

Tips & Limitations

The skill processes messages in 60-second intervals via a cron job. If you notice a delay in alerts, verify that the wa-whatsapp-store.plist agent is actively running. For privacy, all message logs are stored locally in ~/.openclaw/workspace/.whatsapp-messages/. Be aware that the accuracy of event parsing depends on the specific keywords identified in your messages. If the agent fails to detect a meeting, ensure the keywords match the supported list, such as 'reunion' or 'appointment'. If you experience connectivity issues with WhatsApp, regenerate the QR code using the provided curl command to re-sync your session without losing your current configuration files.