بلا API، فقط رمز QR

تربط قناة WhatsApp تطبيق وولفيش بحسابك على WhatsApp عبر بروتوكول الويب. لا حاجة لواجهة برمجية رسمية، ولا لحساب أعمال — فقط امسح رمز QR وسيكون مساعدك الذكي الشخصي متاحًا في WhatsApp.

الإعداد

الخطوة 1: التفعيل
الخطوة 2: مسح رمز QR
الخطوة 3: تم الاتصال

في وولفيش، افتح الإعدادات > WhatsApp وفعّل القناة. سيظهر رمز QR.

يتصل وولفيش كجهاز مرتبط باستخدام بروتوكول WhatsApp متعدد الأجهزة. لا يحتاج هاتفك أن يبقى متصلًا بالإنترنت بعد الربط الأولي.

مسار الاتصال

QR displayed → Phone scans → Multi-device auth → Session keys stored → Persistent connection

تُخزّن مفاتيح الجلسة محليًا في مساحة العمل. طالما لم تفصل الجهاز من إعدادات WhatsApp، يستمر الاتصال بشكل دائم.

الأوامر

نفس أوامر الشرطة المائلة المتاحة في Telegram تعمل في WhatsApp:

الأمر	الإجراء
`/stop`	إيقاف المهمة الجارية في هذه الدردشة. وما زال المصطفّ ينطلق بعدها.
`/cancel`	إسقاط كل رسالة تنتظر في الطابور. أما المهمة الجارية فتُترك وشأنها.
`/new`	بدء محادثة جديدة
`/resume`	اختيار أي محادثة لمتابعتها — قائمة مرقّمة بكل المحادثات، من كل القنوات، الأحدث أولاً (رُدّ بـ `next` للصفحة التالية)
`/delete`	اختيار محادثة لحذفها، من القائمة المرقّمة نفسها
`/current`	عرض المحادثة النشطة
`/status`	تقرير النظام (النموذج، استخدام الذاكرة، وقت التشغيل)
`/mode`	تبديل وضع المحادثة: `/mode single` أو `/mode workflow`
`/model`	عرض النماذج السحابية المتصلة — رُدّ برقم أو اكتب جزءاً من الاسم للتصفية
`/project`	عرض مشاريعك قائمةً مرقّمة — رُدّ برقم لتبدأ محادثة داخل أحدها؛ و`/project close` يغادر المشروع الحالي
`/local`	التبديل إلى النموذج المحلي (Ollama)
`/cloud`	التبديل إلى النموذج السحابي (Claude/OpenAI)

أرسل أي أمر كرسالة WhatsApp عادية — لا حاجة لتنسيق خاص.

آلية الموافقة

عندما تُصنّف الـ amygdala استدعاء أداة، يستخدم WhatsApp رسائل نصية لأن الأزرار المضمّنة غير متوفرة:

[Approval Required]

Wolffish wants to execute:
  shell_exec: npm install express

Reply "approve" to proceed or "deny" to abort.

يتوقف الدور حتى ترد. الردود لا تتأثر بحالة الأحرف — approve وApprove وAPPROVE وyes وy جميعها تعمل.

بخلاف أزرار Telegram المضمّنة، موافقات WhatsApp هي رسائل نصية عادية. تتعرّف القناة على كلمات الموافقة أو الرفض فقط عندما يكون هناك طلب موافقة معلّق.

إعادة الاتصال

إذا انقطع اتصال WebSocket (تغيير الشبكة، سكون/استيقاظ، إعادة تشغيل الخادم)، يعيد وولفيش الاتصال تلقائيًا مع تأخير تصاعدي:

المحاولة	التأخير
1	ثانيتان
2	4 ثوانٍ
3	8 ثوانٍ
4	16 ثانية
5-12	30 ثانية (الحد الأقصى)

بعد 12 محاولة فاشلة، يتوقف وولفيش عن المحاولة ويُعلّم القناة كمنفصلة. يمكنك إعادة الاتصال يدويًا من الإعدادات أو الانتظار حتى إعادة تشغيل التطبيق التالية.

عمليًا، تنجح إعادة الاتصال من المحاولة الأولى أو الثانية لمشاكل الشبكة العابرة. تسلسل المحاولات الكامل (12 محاولة) لا يُستنفد إلا إذا أُلغيت الجلسة من هاتفك.

معالجة الرسائل القديمة

تُتجاهل الرسائل الأقدم من 3 ساعات افتراضيًا. هذا يمنع وولفيش من معالجة تراكم الرسائل التي وصلت أثناء عدم اتصاله — فتلك الرسائل غالبًا لم تعد تحتاج ردًا. يمكن تعديل هذا الحد في config.json:

{
  "channels": {
    "whatsapp": {
      "staleMessageThresholdMs": 10800000
    }
  }
}

اضبطه على 0 لتعطيل فلتر الرسائل القديمة ومعالجة كل شيء بغض النظر عن عمره.

الرسائل الصوتية

تُحوّل الرسائل الصوتية المرسلة في WhatsApp إلى نص عبر تقنية تحويل الكلام إلى نص (STT) في وولفيش وتُعالج كمدخل نصي عادي. يحدث التحويل محليًا قبل دخول الرسالة إلى خط معالجة الذكاء.

إرسال الملفات إلى وولفيش

أي ملف ترسله عبر WhatsApp — PDF أو مستندات (docx، xlsx، pptx) أو صور أو فيديو أو صوت أو حتى ملصقات — يُنزَّل ويُعالج تماماً كمرفقٍ أُسقط في تطبيق سطح المكتب: يدخل الدور بطاقةَ تعريف مع تعليقك، ويقرأ وولفيش محتواه عبر أدواته حين يهمّ — فيصل حتى الملف الضخم بأمان. والملفات التي تصل بلا اسمٍ أو امتدادٍ يُستنتج نوعها من الوسيط نفسه، فلا يُهمَل شيء بصمت. حدّ الرفع 1 جيجابايت، مطابقاً لحدّ التطبيق.

استقبال الملفات من وولفيش

عندما يُنتج وولفيش ملفاً لأجلك، فالتسليم فعل مقصود يقوم به الوكيل — عبر أداته send_file — ويصل كرفع WhatsApp حقيقي: الصور والصوت والفيديو كرسائل وسائط، وكل ما عداها كمستند. لا شيء يُرفَق تلقائياً: مجرد كتابة أداةٍ ملفاً على القرص لا ترسله أبداً، فلن تصلك ملفات وسيطة لم تطلبها. ويُلزم عقدُ التشغيل الوكيلَ بإرسال النتيجة عبر send_file فور اكتمال أي مهمة تُنتج ملفاً.

سجل الرسائل والاسترجاع

تُحفَظ رسائل WhatsApp الواردة في مخزنٍ متجدد (whatsapp/read-history.json) يبقى بعد إعادة التشغيل ويفهرسه الـ cortex لكل محادثة على حدة. هذا يجعلها قابلة للبحث مثل كل شيء آخر: اسأل وولفيش عن شيء راسلك به أحدهم فيجده عبر memory_search، إلى جانب محادثاته وملفاته.

تنسيق الرسائل

يكتب وولفيش ردود WhatsApp بأسلوب WhatsApp النصي نفسه — *عريض* و_مائل_ و~مشطوب~ وشيفرة بين علامتي backtick وقوائم - بسيطة واقتباسات > — لا ماركداون خام أبداً. وبوابة تنسيق ترفض الإرسال المخالف رفضاً صريحاً: أيّ وسوم أو كيانات HTML (فـ WhatsApp لا يفسّر شيئاً منها)، والماركداون الخام (**عريض** و__عريض__ و# عناوين وروابط [نص](رابط) و| جداول | وخطوط ---)، وخطوط الفصل المرسومة (━━━━━ وأشباهها — ففقاعة المحادثة الضيقة على الهاتف تلفّها إلى عدة أسطر مكسورة) — كلها ترتدّ إلى النموذج ليعيد كتابتها بأسلوب WhatsApp نفسه قبل أن يخرج شيء. والحواجز تُبقي النص البريء سالكاً: كل ما بين علامتي backtick أو داخل سياجات الشيفرة معفى (جدول سطر الأوامر داخل كتلة شيفرة محتوى لا زخرفة)، وx**2 وf(**kwargs) تُقرأ رياضياتٍ وشيفرةً، والشرطات السفلية وسط الكلمات تبقى مشروعة. والفحص الليّن الوحيد هو وسم اللغة على سياج الشيفرة — يُسلَّم مع ملاحظة، ولا يُحجَب أبداً. والبوابة لا يمكنها أن تُضيع رسالة أبداً: حين يكون الترميز نفسه هو المحتوى يرسله الوكيل حرفياً، وبعد رفضاتٍ متكررة للدردشة نفسها تتنحّى البوابة جانباً وتُسلَّم الرسالة كما صيغت — أسوأ الأحوال أن ترى ترميزاً خاماً، لا صمتاً أبداً. أما السرد الحيّ بين خطوات الأدوات فيُسلَّم فوراً، أسرعَ من أي بوابة، لذا يُراقَب بدل أن يُحجَب: السطر المسلَّم الحامل رموزاً خاماً يُكسِب الوكيلَ إشعارَ تنسيقٍ يصف بالضبط ما وصلك، فيمضي سائرُ الدور نظيفاً.

تقييم الردود (0–10)

الرسالة التي ليست إلا رقماً من 0 إلى 10 تُلتقَط بهدوء تقييماً منك لآخر ردّ — يُقَرُّ بها بتفاعُلِ ✍️ صغير، لا بفقّاعة محادثة أبداً. والأرقام المكتوبة بلوحة مفاتيح عربية (٠–٩ و۰–۹) تُحتسَب سواءً بسواء، والسباكة تبقى دقيقة: «3» التي تجيب بطاقةَ سؤالٍ مرقّمة أو قائمةَ /resume تظلّ تعني الخيار الثالث، والرقم الذي يفتتح محادثة جديدة مجرّدُ رسالة. وسطرٌ قصير بعد كل ردٍّ يذكّرك بأنّ الخيار موجود؛ وللأمر كله مفتاحه الخاص في الإعدادات ← المعرفة ← المراجعة الذاتيّة، وإطفاؤه يجعل القناة صامتة تماماً عن التقييم. وتقييماتك هي مرساة المراجعة الليلية.

الرسائل المصطفّة

راسِل وولفيش ودورٌ يعمل بالفعل فتُوضع رسالتك في طابور، لا تُرفض. إشعارٌ قصير يؤكّد وصولها ويخبرك بموضعها في الصفّ:

📥 Queued. It's next in line. I'll get to it as soon as the
current task finishes. Send /cancel to drop everything queued.

تنطلق كل رسالة مصطفّة في دورها الخاص لحظةَ تنتهي التي قبلها، بالترتيب الذي أرسلتها به. والملفات والرسائل الصوتية تصطفّ معها — تُنزَّل وتُفرَّغ نصّاً لحظةَ وصولها فلا يبلى شيء وهو ينتظر، ويكون الدور المصطفّ مطابقاً بايتاً ببايت لدورٍ أُرسل والدردشة خالية.

/cancel يُسقط كل ما ينتظر ويترك المهمة الجارية وشأنها. و**/stop** يوقف التشغيل ويدع الطابور يمضي.
تبديل المحادثات يُفرغ الطابور. فـ/new و/resume و/delete وتبديلُ /project أو إغلاقه، كلٌّ يُسقط الرسائل المعلّقة مع المحادثة التي كُتبت فيها، ويقول ذلك في ردّه.

نتائج المهام المفصّلة

افتراضيًا يستقبل WhatsApp تغذية نظيفة — ردود الوكيل، وأي ملفات أو رسائل صوتية يرسلها، والأخطاء. أما خطوات الأدوات الروتينية فتبقى في واجهة سطح المكتب. بدّل ذلك من الإعدادات → القنوات → WhatsApp → نتائج المهام المفصّلة:

إيقاف (الافتراضي) — رسائل الوكيل والملفات التي يرسلها والأخطاء فقط.
تشغيل — يُعاد بثّ كل استدعاء أداة وكل نتيجة وكل نشاط إلى المحادثة.

وتشغيلة وضع سير العمل تُبلغ إضافةً إلى ذلك عن تقدّم حتمي بغضّ النظر عن الوضع المفصّل — خطة مراحلها عند البدء، واكتمال كل مرحلة، وملخّصًا ختاميًا — بينما يضيف الوضع المفصّل سطر وصول لكل وكيل (اسمه ونموذجه ومدته وعدد استدعاءات أدواته).

لا يغيّر الوضع المفصّل سوى ما يُرسَل إلى WhatsApp. أما الدور كاملًا فيُحفظ في السجل والذاكرة بغضّ النظر عن الإعداد.

ربط المحادثات

كل معرّف JID في WhatsApp (معرّف رقم الهاتف) يشير إلى محادثة وولفيش نشطة واحدة في كل لحظة. عمليًا:

الرسائل التي ترسلها لنفسك (عبر “راسل نفسك” في WhatsApp) تنشئ محادثة واحدة
إذا هيّأت وولفيش للرد على جهة اتصال محددة، يحصل معرّف JID الخاص بها على محادثة منفصلة

أمر /resume يبدّل المحادثة التي تُكملها الدردشة — وقائمته تبلغ كل محادثة من كل قناة، لا محادثات WhatsApp وحدها (انظر الأوامر). وتشغيلات الأتمتة المجدولة مخفية منها افتراضياً؛ ومفتاح إخفاء الأتمتة من /resume في الإعدادات ← القنوات ← WhatsApp يعيدها. وتبقى دائماً في /delete وفي التطبيق. وحين يراسلك وولفيش من خارج السياق — أتمتة تبلّغ عن مهمة أنجزت، أو محادثة في التطبيق تترك لك ملاحظة — تعيد الدردشة توجيه نفسها إلى المحادثة المُرسِلة، فيُكمل ردُّك تلك المحادثة لا آخر ما كانت الدردشة عليه. والمحادثات ثنائية الاتجاه مع التطبيق بالكامل: ابدأ في WhatsApp وواصل الكتابة في واجهة سطح المكتب، حيث تظهر الرسائل التي تحطّ على هاتفك في مكانها، وتنجو الرسائل الصوتية من الرحلة كما هي. ويعمل /project هنا تماماً كما على Telegram: اختر مشروعاً برقمه لتبدأ محادثة جديدة داخله — مُطلَعةً على تعليمات المشروع وملفاته — ويبقى /new في المشروع الحالي، و/project close هو المخرج. الربط يعيش على المحادثة نفسها فينجو من إعادة التشغيل.

التفاصيل التقنية

تستخدم قناة WhatsApp مكتبة Baileys، وهي تنفيذ مفتوح المصدر بلغة TypeScript لبروتوكول WhatsApp Web. تتولى Baileys:

توليد رمز QR والمصادقة متعددة الأجهزة
إدارة اتصال WebSocket
تشفير/فك تشفير الرسائل (بروتوكول Signal)
تنزيل ورفع الوسائط
مؤشرات الحضور والكتابة

Baileys هي مكتبة خارجية تقوم بهندسة عكسية لبروتوكول WhatsApp Web. رغم استخدامها الواسع واستقرارها، إلا أنها غير مدعومة رسميًا من Meta. قد تتطلب تغييرات بروتوكول WhatsApp أحيانًا تحديثات للمكتبة.

ابدأ هنا

المفاهيم الأساسية

القدرات

القنوات

النماذج

التكاملات

الذاكرة والتعلم

التكوين

التشخيص

توسيع وولفيش

التطوير

قناة WhatsApp

بلا API، فقط رمز QR

الإعداد

مسار الاتصال

الأوامر

آلية الموافقة

إعادة الاتصال

معالجة الرسائل القديمة

الرسائل الصوتية

إرسال الملفات إلى وولفيش

استقبال الملفات من وولفيش

سجل الرسائل والاسترجاع

تنسيق الرسائل

تقييم الردود (0–10)

الرسائل المصطفّة

نتائج المهام المفصّلة

ربط المحادثات

التفاصيل التقنية

​بلا API، فقط رمز QR

​الإعداد

​مسار الاتصال

​الأوامر

​آلية الموافقة

​إعادة الاتصال

​معالجة الرسائل القديمة

​الرسائل الصوتية

​إرسال الملفات إلى وولفيش

​استقبال الملفات من وولفيش

​سجل الرسائل والاسترجاع

​تنسيق الرسائل

​تقييم الردود (0–10)

​الرسائل المصطفّة

​نتائج المهام المفصّلة

​ربط المحادثات

​التفاصيل التقنية

بلا API، فقط رمز QR

الإعداد

مسار الاتصال

الأوامر

آلية الموافقة

إعادة الاتصال

معالجة الرسائل القديمة

الرسائل الصوتية

إرسال الملفات إلى وولفيش

استقبال الملفات من وولفيش

سجل الرسائل والاسترجاع

تنسيق الرسائل

تقييم الردود (0–10)

الرسائل المصطفّة

نتائج المهام المفصّلة

ربط المحادثات

التفاصيل التقنية