--- name: twilio description: Twilio integration للـ SMS و Voice calls و WhatsApp. يُستخدم لإرسال SMS عالمي + مكالمات صوتية تلقائية + تنبيهات لرقمك من رقم رسمي. يدعم Verify (OTP), Lookups (الرقم صالح؟), TwiML للمكالمات، WhatsApp Business via Twilio (لاحقاً), Conversations API. التكلفة: SMS ~$0.04/رسالة دولية، Voice ~$0.013/دقيقة، رقم US $1.15/شهر. license: MIT ---
Twilio — SMS + Voice + WhatsApp for OpenClaw
تكامل كامل مع Twilio لإرسال:
- 📱 SMS لأي رقم في العالم
- ☎️ مكالمات صوتية تلقائية (TTS أو ملف صوتي)
- 🔢 OTP للتحقق
- 🔍 Lookups (هل الرقم صالح؟ Operator؟)
- 💬 WhatsApp via Twilio (Phase 2+)
When to Use
- ⚠️ تنبيهات حرجة تحتاج تصل لجوال د. وائل فوراً
- 📞 اتصال تلقائي بمقاول (مع TTS رسالة)
- 🔐 OTP للـ authentication
- 📲 إشعارات مشاريع (تذكيرات مواعيد، تأخيرات)
- 🌐 تواصل عالمي بدون WhatsApp
Environment Variables
bash
TWILIO_ACCOUNT_SID=AC... # Account SID من Console
TWILIO_AUTH_TOKEN=... # Auth Token من Console
TWILIO_PHONE_NUMBER=+1... # رقم Twilio المشترى
TWILIO_DEFAULT_TO=+965... # رقم د. وائل الكويتي (افتراضي)
Commands
twilio sms <to> "<message>"
إرسال SMS لرقم محدد.bash
python3 twilio_tool.py sms +96599662183 "تذكير: اجتماع KCPC الساعة 10"
twilio voice <to> "<text-to-speak>" [--lang ar-XA]
مكالمة صوتية مع TTS (afin).bash
python3 twilio_tool.py voice +96599662183 "تنبيه عاجل من نظام OpenClaw" --lang ar-XA
twilio lookup <number>
فحص الرقم — صالح؟ بلد؟ operator؟ landline/mobile؟twilio verify <number> / twilio verify-check <number> <code>
OTP via SMS (يحتاج تفعيل Verify service في Console).twilio balance
رصيد Twilio.twilio history [--limit 10]
سجل الرسائل المرسلة.Cost (Approximate)
| Action | Cost | |---|---| | SMS to Kuwait | ~$0.04 | | SMS to USA | ~$0.0075 | | Voice call to Kuwait | ~$0.34/min | | Voice call to USA | ~$0.013/min | | US phone number | $1.15/month | | WhatsApp message | $0.005 + WhatsApp fee |
Test Limits (Trial Account)
- ✅ ~$15.50 free credit
- ⚠️ يمكن إرسال SMS لأرقام مُتحقّق منها فقط (verified caller IDs)
- ⚠️ كل رسالة تحوي "Sent from your Twilio trial account" prefix
- ⚠️ بعد الترقية: لا قيود
Quick Start
bash
بعد ضبط env vars
cd /data/.openclaw/workspace/skills/twilioاختبار الاتصال
python3 twilio_tool.py balanceأول SMS
python3 twilio_tool.py sms +96599662183 "مرحبا د. وائل من OpenClaw 🦾"