تخيّل أنك تتصل برقم واتساب، ويرد عليك مساعد ذكاء اصطناعي بصوت طبيعي، تتحدث معه وتسأله عن مواعيدك ومهامك، وتطلب منه تنفيذ بعض الأعمال أثناء المكالمة.
والأجمل أن المساعد نفسه يستطيع الاتصال بك عندما يكون هناك تنبيه مهم أو مهمة تحتاج إلى قرار منك.
هذه هي فكرة مشروع Hermes WhatsApp Voice، وهي إضافة مفتوحة المصدر تتيح ربط مساعد Hermes Agent بمكالمات واتساب الصوتية باستخدام تقنية Gemini Live من Google.
في هذا المقال سنتعرف على طريقة عمل المشروع، ومتطلبات تشغيله، وكيفية تثبيته يدوياً أو باستخدام Skill جاهز، بالإضافة إلى أهم المشكلات التي قد تواجهك.
ما هو Hermes Agent؟
Hermes Agent هو مشروع مساعد ذكاء اصطناعي من شركة Nous Research، مصمم للعمل مع الأدوات والملفات والتطبيقات وتنفيذ مهام متعددة، بحسب الصلاحيات والإعدادات التي تمنحها له.
يمكن تشغيله على الكمبيوتر وربطه بخدمات مختلفة، والاستفادة منه في أتمتة الأعمال وتنظيم المهام.
الموقع الرسمي: https://hermes-agent.nousresearch.com/
المشروع على GitHub: https://github.com/ashwanthbalakrishnan5/hermes-whatsapp-voice/blob/e472a47dda4e9986ca44f0ad62cb1b71c893bec0/README.mdhermes-agent
ما هي إضافة Hermes WhatsApp Voice؟
هي إضافة طوّرها Ashwanth Balakrishnan، وتسمح بالتحدث مع Hermes عن طريق مكالمات واتساب الصوتية.
بدلاً من كتابة رسالة وانتظار الرد، يمكنك الاتصال برقم البوت والتحدث مع المساعد مباشرة.
من أبرز وظائفها:
- استقبال المكالمات الصوتية من الرقم الشخصي المصرح له.
- التحدث مع المستخدم باستخدام Gemini Live.
- إرسال طلبات إلى Hermes لتنفيذ مهام أثناء المكالمة.
- إجراء مكالمات صادرة إلى صاحب المساعد عند وجود تنبيه أو مهمة.
- إرسال ملخص نصي على واتساب بعد انتهاء المكالمة.
مثلاً، يمكنك أن تقول للمساعد:
“راجع مواعيدي غداً، وأخبرني إذا عندي اجتماع مهم.”
أو:
“إذا ظهر تنبيه عاجل أثناء عملي، اتصل بي وأخبرني بالتفاصيل.”
تنفيذ هذه المهام يتطلب ربط Hermes بالأدوات المناسبة ومنحه الصلاحيات اللازمة.
رابط الإضافة على GitHub:
كيف تعمل مكالمات الذكاء الاصطناعي على واتساب؟
تعتمد المنظومة على ثلاثة مكونات رئيسية.
الأول: WhatsApp Voice
يستقبل اتصال واتساب من المستخدم وينقل الصوت بين التطبيق والمساعد. يعتمد المشروع على مكتبة whatsapp-rust للتعامل مع الاتصال.
الثاني: Google Gemini Live
يعالج صوت المستخدم ويتعرف على الكلام ويولّد استجابة صوتية يمكن سماعها خلال المكالمة، بدلاً من الاعتماد فقط على تحويل الصوت إلى نص ثم قراءته.
الثالث: Hermes Agent
عندما يحتاج المستخدم إلى تنفيذ مهمة، يستطيع النظام إرسال الطلب إلى Hermes عن طريق أداة ask_hermes، بشرط تفعيل خادم API وإعداد الصلاحيات المطلوبة.
مسار الاتصال باختصار:
المستخدم ← مكالمة واتساب ← Hermes WhatsApp Voice ← Gemini Live ← Hermes Agent عند الحاجة.
ما الذي تحتاجه لتشغيل المشروع؟
قبل البدء، جهّز المتطلبات التالية:
- جهاز يعمل بنظام macOS أو Linux.
- نسخة Hermes Agent بإصدار 0.21.5 أو أحدث.
- رقم واتساب شخصي للاتصال بالمساعد.
- رقم واتساب ثانٍ مخصص للبوت.
- مفتاح Gemini API صالح من Google AI Studio.
- اتصال مستقر بالإنترنت.
لا تحتاج إلى تثبيت Rust أو Cargo عند استخدام النسخة التنفيذية الجاهزة المتوافقة مع جهازك. تحتاج هذه الأدوات فقط إذا أردت بناء التطبيق من الكود المصدري أو تعديله.
كذلك لا يحتاج هذا المشروع إلى إعداد حساب WhatsApp Business Cloud API بالطريقة المعتادة، لأنه يستخدم ربط جهاز واتساب، لكنه يعتمد على بروتوكول غير رسمي.
الطريقة الأولى: تثبيت الإضافة يدوياً
الخطوة الأولى: تثبيت Hermes Agent
إذا لم يكن Hermes مثبتاً، ابدأ من الموقع الرسمي:
اتبع تعليمات التثبيت المناسبة لجهازك، وتأكد من أن أمر hermes يعمل داخل Terminal.
الخطوة الثانية: تثبيت إضافة WhatsApp Voice
افتح Terminal ونفّذ:
hermes plugins install ashwanthbalakrishnan5/hermes-whatsapp-voice --enableيقوم الأمر بتثبيت الإضافة وتفعيلها داخل Hermes.
بعد نجاح التثبيت، انتقل إلى إعداد رقم المالك.
الخطوة الثالثة: تسجيل رقم واتساب الشخصي
نفّذ:
hermes config set plugins.entries.hermes-whatsapp-voice.settings.owner_number +491234567890استبدل الرقم الموجود في المثال برقمك الحقيقي باستخدام رمز الدولة.
هذا هو الرقم المسموح له بالاتصال بالمساعد، وهو الرقم الذي يمكن للمساعد الاتصال به عند الحاجة.
انتبه إلى الفرق بين الرقمين:
رقم المالك: الرقم الذي تتصل منه.
رقم البوت: الرقم الثاني الذي يستقبل المكالمات.
الخطوة الرابعة: ربط حساب واتساب الثاني
نفّذ:
hermes whatsapp-voice pairسيظهر رمز QR لربط واتساب.
افتح واتساب على هاتف الرقم الثاني، ثم انتقل إلى:
الإعدادات ← الأجهزة المرتبطة ← ربط جهاز.
امسح رمز QR وانتظر تأكيد الربط.
يمكن أيضاً استخدام رمز اقتران بدلاً من QR باستخدام الخيار --phone مع رقم البوت، إذا كانت الطريقة مدعومة في إعدادك.
مهم: نجاح الربط لا يعني بالضرورة أن المكالمات الصوتية تعمل. ما زلنا بحاجة إلى إعداد Gemini واختبار الخدمة.
الخطوة الخامسة: إعداد Gemini Live
افتح Google AI Studio:
أنشئ مفتاح Gemini API ضمن مشروعك.
بعدها افتح ملف إعدادات Hermes:
nano ~/.hermes/.envأضف المفتاح:
GEMINI_API_KEY=YOUR_API_KEYاستبدل YOUR_API_KEY بالمفتاح الحقيقي.
احفظ الملف في محرر nano بالضغط على:
Control + O ثم Enter ثم Control + X.
تنبيه مهم جداً: الإضافة تعطي الأولوية لمتغير GOOGLE_API_KEY إذا كان موجوداً، ثم تستخدم GEMINI_API_KEY. لذلك تأكد من عدم وجود مفتاح قديم أو متعارض داخل الإعدادات أو بيئة التشغيل.
كذلك فإن تسجيل الدخول إلى Google بطريقة OAuth وحده لا يكفي لتشغيل Gemini Live في هذه الإضافة؛ تحتاج إلى مفتاح API صالح.
الخطوة السادسة: تفعيل Hermes API Server
إذا أردت أن ينفّذ المساعد مهام Hermes أثناء المكالمة، أضف الإعدادين التاليين إلى ملف ~/.hermes/.env:
API_SERVER_ENABLED=true
API_SERVER_KEY=YOUR_LONG_RANDOM_SECRETيجب استبدال النص الأخير بمفتاح سري طويل وعشوائي.
أعد تشغيل Hermes Gateway بعد تعديل الإعدادات.
يمكن إجراء محادثة صوتية دون ربط تنفيذ المهام، لكن بعض الوظائف، ومنها ask_hermes، تحتاج إلى خادم API مُفعّل.
الخطوة السابعة: تشغيل خدمة المكالمات
نفّذ:
hermes whatsapp-voice serveيبدأ هذا الأمر تشغيل الخدمة داخل Terminal.
اترك النافذة مفتوحة أثناء التجربة.
بعد ظهور رسالة الاتصال بواتساب، اتصل من رقمك الشخصي على رقم البوت.
إذا اكتملت الإعدادات ونجح اتصال Gemini Live، يفترض أن يبدأ المساعد بالمحادثة الصوتية.
الطريقة الثانية: التثبيت باستخدام Skill جاهز
هذه الطريقة مناسبة للأشخاص الذين لا يريدون التعامل مع جميع خطوات الإعداد يدوياً.
المطوّر أضاف ملف Skill مخصصاً يساعد وكلاء البرمجة مثل Hermes أو غيره على تنفيذ عملية التثبيت والإعداد.
رابط ملف Skill المباشر:
هذا الـSkill عبارة عن تعليمات تشغيل منظمة للوكيل الذكي، وليس برنامجاً مستقلاً تضغط عليه لتثبيته.
بعد تثبيت الإضافة، يمكن لـHermes الاستفادة منه باسم:
hermes-whatsapp-voice:setupويمكنك أيضاً فتح مستودع GitHub داخل وكيل برمجي مثل Codex، ثم مطالبته بقراءة ملف Skill وتنفيذ الخطوات.
برومبت جاهز للتثبيت باستخدام Codex
انسخ النص التالي إلى Codex بعد منحه الوصول إلى المشروع:
You are a macOS and Hermes Agent setup specialist.
Install and configure Hermes WhatsApp Voice
using the official setup skill:
https://github.com/ashwanthbalakrishnan5/hermes-whatsapp-voice/blob/e472a47dda4e9986ca44f0ad62cb1b71c893bec0/skills/setup/SKILL.md
Tasks:
1. Inspect the current Hermes installation.
2. Follow the official setup skill.
3. Install and enable the plugin.
4. Configure the authorized owner phone number.
5. Guide me through WhatsApp pairing.
6. Configure Gemini Live using a valid local API key.
7. Detect conflicting environment variables.
8. Enable the Hermes API server if needed.
9. Run safe diagnostic tests.
10. Start the voice service.
11. Report what is working and what still needs testing.
Never display, upload, or log API keys,
WhatsApp credentials, or session secrets.
Do not bypass caller authentication.
Do not remove existing WhatsApp sessions
without explicit permission.
Ask for approval before sensitive changes.سيتمكن وكيل البرمجة من تنفيذ الخطوات التي تسمح بها صلاحياته، وقد يحتاج إلى تدخلك لمسح QR أو إدخال مفتاح API أو إجراء مكالمة اختبار.
كيف تجعل المساعد يتحدث بالعربية؟
تتيح الإضافة تخصيص الصوت والنموذج وتعليمات المساعد من إعدادات WhatsApp Voice داخل Hermes Dashboard أو إعدادات الإضافة.
يمكن استخدام تعليمات شخصية مثل:
You are my personal AI voice assistant.
Always speak in natural Arabic.
Use a friendly and concise conversational style.
Understand Arabic dialects when possible.
Answer clearly and avoid overly long responses.
Ask for confirmation before sensitive actions.
Never claim a task is complete unless Hermes confirms it.يمكن تعديل هذه التعليمات حسب اللهجة والأسلوب المطلوب، مع الانتباه إلى أن جودة النطق ودعم اللهجات يتوقفان أيضاً على النموذج الصوتي المستخدم.
كيف تجعل Hermes يتصل بك تلقائياً؟
من الوظائف المثيرة للاهتمام في المشروع إمكانية المكالمات الصادرة.
توفر الإضافة أداة باسم:
whatsapp_call_owner
يمكن لوكيل Hermes استخدامها للاتصال برقم المالك المسجّل.
مثلاً، يمكن إعداد مهمة لمراقبة المواعيد المهمة، وإذا ظهر موعد عاجل، يتصل بك المساعد بدلاً من الاكتفاء بإرسال رسالة.
كما توفر أداة:
whatsapp_call_status
لمراجعة حالة المكالمة ومعرفة ما إذا تم الرد عليها أو رفضها أو تعذر إكمالها.
لكن هذا يتطلب بقاء الخدمة شغّالة وإعداد مهام Hermes وصلاحياتها مسبقاً.
كيف تجعل الخدمة تعمل باستمرار؟
الأمر serve مناسب للتجربة، لكنه يعمل في نافذة Terminal الحالية.
للحصول على إعداد خدمة دائمة، نفّذ:
hermes whatsapp-voice serviceيعرض الأمر تعريف خدمة مناسباً لنظام التشغيل؛ على macOS يستخدم آلية launchd، وعلى Linux يستخدم systemd.
بعد إعداد الخدمة وتفعيلها حسب التعليمات المعروضة، يمكن التحقق من حالتها باستخدام:
hermes whatsapp-voice statusهذا مفيد إذا أردت أن يبقى المساعد متاحاً دون تشغيل الأمر يدوياً في كل مرة.
أبرز المشكلات وكيفية حلها
1. المكالمة تصل لكن المساعد لا يرد
إذا ظهرت رسالة:
ignoring call ... not the ownerفهذا يعني أن الإضافة لم تتعرف على المتصل بوصفه المالك المسموح له.
تأكد أولاً من أن رقم owner_number يطابق الرقم الذي تتصل منه، مع رمز الدولة الصحيح.
قد تظهر بعض هويات واتساب بصيغة @lid بدلاً من رقم الهاتف المعتاد، وقد تتسبب مشكلات المطابقة في رفض المكالمات رغم صحة الرقم.
لا يُنصح بتعطيل فحص المالك أو السماح لجميع الأرقام لتجاوز المشكلة. الأفضل مراجعة سجلات الإضافة وتحديثها أو إصلاح المطابقة بطريقة آمنة.
2. المكالمة تتصل ثم تنقطع
إذا ظهر:
API key not validفالمشكلة غالباً أن Gemini Live لا يقبل المفتاح المستخدم.
تأكد من صلاحية المفتاح، ومن أنه يخص المشروع الصحيح، ولا توجد تعريفات قديمة لـGOOGLE_API_KEY أو GEMINI_API_KEY تتجاوز المفتاح الجديد.
بعد تعديل الإعدادات، أعد تشغيل الخدمة.
3. يظهر خطأ No Gemini API key found
معناه أن الإضافة لم تجد مفتاح Gemini في الإعدادات التي تعتمد عليها.
راجع ملف .env وإعدادات مزود Gemini داخل Hermes، وتأكد من حفظ القيم بشكل صحيح.
4. يظهر Linked لكن لا يوجد رد صوتي
ظهور Linked يعني نجاح ربط حساب واتساب كجهاز مرتبط فقط.
أما نجاح المحادثة الصوتية فيحتاج إلى اجتياز عدة مراحل أخرى: التعرف على المتصل، وقبول المكالمة، والاتصال بخدمة Gemini Live، ثم إرسال واستقبال الصوت.
لذلك افحص سجلات الخدمة قبل إعادة QR أو تثبيت البرنامج من جديد.
هل الخدمة مجانية؟
المشروع مفتوح المصدر، لكن استخدامه لا يعني بالضرورة أن جميع الخدمات مجانية.
قد يتوفر مستوى مجاني محدود لخدمة Gemini Live، بينما يُحاسَب الاستخدام المدفوع بحسب أسعار Google والنموذج المختار.
كذلك توجد اعتبارات تتعلق بخصوصية البيانات، لأن صوت المكالمة يُرسل إلى خدمة Gemini لمعالجته.
يُفضّل مراجعة الأسعار وسياسة البيانات الحالية من Google قبل الاعتماد على المشروع بشكل دائم.
هل يمكن استخدامه للرد على مكالمات العملاء؟
الإضافة الحالية مصممة أساساً للاستخدام الشخصي.
فهي تستقبل المكالمات من رقم مالك محدد وتستطيع الاتصال بهذا الرقم، ولا توفر بشكلها الافتراضي مركز اتصالات يدعم عدة عملاء.
إذا أردت إنشاء مساعد لخدمة العملاء، والرد على الاستفسارات، وإدارة المواعيد والمبيعات عبر مكالمات واتساب، فستحتاج إلى بنية مختلفة ومراجعة واجهات الاتصال الرسمية المتاحة وسياسات واتساب.
نقاط أمنية مهمة قبل الاستخدام
يعتمد المشروع على بروتوكول واتساب غير رسمي، وقد يتوقف عن العمل بعد تحديثات واتساب أو يتسبب في فرض قيود على الحساب.
لهذا السبب يُفضّل استخدام رقم ثانوي للتجارب وعدم الاعتماد عليه كرقم أعمال أساسي.
أيضاً، احفظ مفاتيح Gemini بعيداً عن الملفات العامة والصور والمستودعات المفتوحة، ولا تشارك ملفات جلسة واتساب مع الآخرين.
عند كشف مفتاح API بالخطأ، قم بإلغائه واستبداله، وراجع الاستخدام والفوترة المرتبطين به.
الخلاصة
مشروع Hermes WhatsApp Voice يقدم طريقة عملية لبناء مساعد ذكاء اصطناعي يمكن التواصل معه بمكالمة واتساب، باستخدام Gemini Live للمحادثة الصوتية وHermes Agent لتنفيذ المهام.
ويمكن البدء بطريقتين: التثبيت اليدوي باستخدام أوامر Hermes، أو الاستعانة بملف Skill الذي وفره المطور لتسهيل الإعداد باستخدام وكلاء البرمجة.
إذا كنت مهتماً بتطبيقات الذكاء الاصطناعي والوكلاء الأذكياء والأتمتة، فهذا المشروع يستحق التجربة، مع مراعاة أن تكامله مع مكالمات واتساب ما زال يعتمد على تقنية غير رسمية وقد يتطلب بعض المعالجة التقنية.
روابط المشروع:
- Hermes Agent: https://github.com/NousResearch/hermes-agent
- إضافة WhatsApp Voice: https://github.com/ashwanthbalakrishnan5/hermes-whatsapp-voice
- Skill الإعداد التلقائي: https://github.com/ashwanthbalakrishnan5/hermes-whatsapp-voice/blob/e472a47dda4e9986ca44f0ad62cb1b71c893bec0/skills/setup/SKILL.md
- Google AI Studio: https://aistudio.google.com/apikey
إعداد وكتابة: محمد عباس
متخصص في التسويق الرقمي والذكاء الاصطناعي
Instagram: @med3bbas
