--- name: notify description: | Send notifications via WhatsApp, email, or Discord when tasks complete or fail. Use this skill to alert the user about orchestrator results. Triggers: "notify", "send message", "alert user", "tell me when done", "send notification", "message me" metadata: clawdbot: requiredEnv: - NOTIFY_WHATSAPP_TO # or CALLMEBOT_PHONE or SENDGRID_API_KEY --- # Notification Skill Send notifications when orchestration tasks complete or fail. ## Supported Channels ### 1. WhatsApp via Twilio (Recommended) Best for immediate notifications. Requires Twilio account. **Setup:** 1. Create account at https:\/\/console.twilio.com 2. Enable WhatsApp sandbox or get approved number 3. Configure environment: ```bash TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxx TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxx TWILIO_WHATSAPP_FROM=whatsapp:+14155238886 NOTIFY_WHATSAPP_TO=whatsapp:+1XXXXXXXXXX ``` ### 2. WhatsApp via CallMeBot (Free) Free alternative, simpler setup but less reliable. **Setup:** 1. Send "I allow callmebot to send me messages" to +34 644 51 95 23 on WhatsApp 2. Get your API key from the response 3. Configure environment: ```bash CALLMEBOT_PHONE=+1XXXXXXXXXX CALLMEBOT_APIKEY=xxxxxxx ``` ### 3. Email via SendGrid For email notifications. Good for detailed reports. **Setup:** 1. Create account at https:\/\/sendgrid.com 2. Generate API key 3. Configure environment: ```bash SENDGRID_API_KEY=SG.xxxxxxxxxxxx NOTIFY_EMAIL_TO=your@email.com NOTIFY_EMAIL_FROM=clawdbot@yourdomain.com ``` ## Usage ### From Shell ```bash # Success notification .\/lib\/notify.sh success "Task description" "https:\/\/github.com\/user\/repo\/pull\/123" \/path\/to\/state.json # Failure notification .\/lib\/notify.sh failure "Task description" \/path\/to\/failure_report.md \/path\/to\/state.json # Progress notification .\/lib\/notify.sh progress "Task description" "Iteration 42\/80" \/path\/to\/state.json ``` ### From JavaScript ```javascript import { sendWhatsApp } from '.\/lib\/whatsapp.js'; import { sendEmail } from '.\/lib\/email.js'; \/\/ WhatsApp await sendWhatsApp('🦞 Task complete! PR: https:\/\/github.com\/...'); \/\/ Email await sendEmail( 'Task Complete', 'Your coding task has been completed...' ); ``` ## Message Templates ### Success Message ``` 🦞 CLAWDBOT TASK COMPLETE ✅ Task: 📁 Project: 🔀 PR: Iterations: (OpenCode) \/ (Claude) Status: Codex Approved ✓ View PR: ``` ### Failure Message ``` 🦞 CLAWDBOT TASK FAILED ❌ Task: 📁 Project: 🔀 Branch: Iterations: 80 (OpenCode) + 10 (Claude) Status: Could not resolve Codex issues Blocking Issues: - - Logs: Worktree: Manual review required. ``` ### Progress Message (Optional) ``` 🦞 CLAWDBOT PROGRESS 📁 Project: 🔄 Task: Current iteration: Status: ``` ## Configuration In `~\/.clawdbot-orchestrator.env`: ```bash # Notification preferences NOTIFY_ON_SUCCESS=true NOTIFY_ON_FAILURE=true NOTIFY_PROGRESS_INTERVAL=0 # 0 = disabled, N = every N iterations # Preferred channel (whatsapp, email) NOTIFY_PREFERRED_CHANNEL=whatsapp ``` ## Error Handling If notification fails: 1. Log the error 2. Continue execution (don't block on notification failures) 3. Print the message to stdout as fallback 4. Retry once after 5 seconds for transient failures ## Rate Limiting - WhatsApp (Twilio): 1 message\/second - WhatsApp (CallMeBot): 1 message\/25 seconds - Email (SendGrid): Based on plan limits The skill automatically respects these limits.