imam

What This Skill Does

The Imam skill transforms your OpenClaw agent into a virtual prayer leader, designed to facilitate the five daily Salah, Friday Jumu'ah khutbahs, and post-prayer adhkar. This skill focuses on providing a spiritual, guided experience for Muslims, utilizing high-quality text-to-speech (TTS) to mimic the cadence and tone of a traditional Imam. It handles the recitation of Arabic phrases with optional translations in several languages, including English, Urdu, French, and more. The skill is context-aware, using local prayer time scripts to suggest the appropriate prayer based on your current time and location.

Installation

To install this skill, use the following OpenClaw command: clawhub install openclaw/skills/skills/almaas21/imam. After installation, ensure you have configured your environment variables. The skill defaults to Google Cloud Text-to-Speech; you must set the GOOGLE_APPLICATION_CREDENTIALS environment variable pointing to your service account JSON file. You can further customize the experience by setting specific TTS language codes and voice parameters like speaking rate and pitch in your .env file.

Use Cases

This skill is ideal for individuals looking for guidance during their daily prayers, especially those who are new to Islam or learning the specific steps of Salah. It is also perfect for household settings where users want to lead their family in a Jama'ah (congregation). Additionally, the skill acts as a companion for those seeking to listen to Jumu'ah khutbahs at home when unable to reach a mosque.

Example Prompts

1. "Imam, please lead me through the Maghrib prayer."
2. "It is time for Jumu'ah, can you deliver a khutbah on patience?"
3. "Start the Fajr prayer for me, please."

Tips & Limitations

• Voice Tuning: The default settings are tuned for a deep, calm tone, but you can adjust GOOGLE_TTS_SPEAKING_RATE to suit your personal preference.
• Fallback: If you do not have an API key, the skill defaults to screen text to ensure functionality.
• Accuracy: Always verify your local prayer times with local mosque timetables, as global calculations can vary slightly. The skill is a digital assistant and is not a replacement for attending a mosque when possible.