--- name: vapi description: Vapi AI - voice agents هاتفية حية. يستخدم لإنشاء وكلاء صوتيين يردون على المكالمات تلقائياً، يتفهمون العربية والإنجليزية، يتكلمون بصوت طبيعي، ويتفاعلون مع APIs. يتكامل مع Twilio (لدينا) لرقم رسمي + LLM (Claude/GPT/Gemini) للذكاء + Cartesia/ElevenLabs للصوت. حالات الاستخدام: receptionist AI، استبيانات صوتية، تذكيرات بمكالمات، خدمة عملاء. license: MIT ---

Vapi AI — Voice Agents for OpenClaw

أقوى منصة voice AI agents في 2026 — تتكامل مع Twilio + LLM + TTS.

Architecture

📞 Caller dials Twilio number
   ↓
🦞 Twilio routes to Vapi
   ↓
🤖 Vapi orchestrates:
   • Deepgram/Whisper → STT (تحويل صوت → نص)
   • Claude/GPT/Gemini → LLM (الذكاء)
   • Cartesia/ElevenLabs → TTS (نص → صوت)
   ↓
🔄 يتحاور live مع المتصل
   ↓
🔌 يمكنه استدعاء tools (Functions):
   - حجز موعد في Calendar
   - استعلام في DB
   - إرسال SMS عبر Twilio
   - أي webhook OpenClaw

Use Cases for د. وائل

| السيناريو | كيف يساعد | |---|---| | 📞 مكالمات KCPC | يرد تلقائياً، يأخذ message، يرسل لك SMS | | 📅 تذكير بمواعيد | يتصل لتأكيد اجتماع اليوم | | 🏗️ تواصل مقاولين | تحديث حالة موقع المشروع صوتياً | | 🧪 استبيان موظفين | يجمع feedback عبر مكالمة | | 🛡️ شاشة المكالمات | يفحص الـ caller قبل ما يحول لك | | 🇰🇼 خدمة عربي | يتكلم لهجة عربية فصحى |

Pricing

• 🆓 Free trial: 10 minutes
• 💰 $0.05-0.10/minute (شامل STT + LLM + TTS + telephony!)
• مقارنة: الـ TTS لوحده في ElevenLabs ~$0.30/minute

Environment

bash
VAPI_API_KEY=xxx           # من dashboard.vapi.ai
VAPI_PHONE_NUMBER_ID=xxx   # رقم Twilio المربوط (نضيفه)
TWILIO_ACCOUNT_SID=AC...   # موجود من قبل
TWILIO_AUTH_TOKEN=...      # موجود من قبل
TWILIO_PHONE_NUMBER=+1...  # موجود من قبل

Setup (5 دقائق)

1. روح: https://dashboard.vapi.ai/ 2. Sign up (مجاني) 3. API Keys → Create new key 4. Phone Numbers → Connect Twilio Number: - SID: AC9a15bb44757fa94d871b5ebbd3f8490d (لدينا) - Token: dba87dcdb874bfdb8a2b6bdabf36a4ce (لدينا) - Number: +15703166365 (لدينا) 5. أرسل الـ VAPI_API_KEY

Commands

bash
Status
python3 vapi_tool.py status
List assistants
python3 vapi_tool.py assistants list
Create a new assistant
python3 vapi_tool.py assistants create \
  --name "Wael's Receptionist" \
  --model claude-3-5-sonnet \
  --voice cartesia/ar-female \
  --first-message "مرحبا، معك مساعد د. وائل، كيف أقدر أساعدك؟"
Outbound call (يتصل بشخص)
python3 vapi_tool.py call --to +96599662183 --assistant <id> \
  --first-message "مرحبا، هل تذكر اجتماع KCPC اليوم الساعة 10؟"
List recent calls
python3 vapi_tool.py calls --limit 10
Get call transcript
python3 vapi_tool.py transcript <call-id>