كيفية ربط HappyCapy بتيليجرام: تشغيل وكيل ذكاء اصطناعي كامل في أي محادثة
وكيل HappyCapy الخاص بك — بكل أدواته ومهاراته وقدراته — متاح مباشرة من تيليجرام.
معظم بوتات تليجرام تجيب على الأسئلة فقط. جسر تليجرام الخاص بـ HappyCapy يشغّل claude --print — كل رسالة ترسلها تُشغّل جلسة Claude Code كاملة مع صلاحية الوصول إلى Bash، وعمليات الملفات، والبحث على الويب، وتوليد الصور، وأكثر من 300,000 Skill. اطلب منه استخلاص بيانات موقع ويب، أو كتابة سكربت بايثون وتنفيذه، أو توليد فيديو. سيفعل ذلك. هذا ليس روبوت محادثة. هذا وكيل يصادف أنه يعيش في محادثتك على تليجرام.
لماذا يختلف هذا عن بوت تليجرام العادي
بناء بوت تليجرام هو مشروع نهاية أسبوع. تسجّل عبر BotFather، تحصل على رمز (token)، تستدعي واجهة برمجة تطبيقات Telegram Bot API، تمرّر الرسائل الواردة إلى واجهة برمجية لنموذج لغوي (LLM API)، وتُعيد الرد. النتيجة هي آلة إكمال تلقائي متطورة. ليس لديها نظام ملفات. لا يمكنها تشغيل الكود. لا يمكنها تشغيل سير عمل (workflows). لا يمكنها فعل أي شيء لا تستطيع واجهة برمجية للنموذج اللغوي فعله في استجابة واحدة عديمة الحالة (stateless).
بنية HappyCapy مختلفة في كل طبقة. تعمل HappyCapy كصندوق رمل (sandbox) لينكس يعمل دائمًا على Fly.io — بصلاحيات جذر (root)، وPython 3.11، وNode.js v24، وتخزين ملفات دائم. عندما تصل رسالتك على تليجرام، يستدعي الجسر claude --print مع رسالتك كمُدخل. هذا الاستدعاء يتمتع بصلاحية وصول كاملة للأدوات: تنفيذ Bash، قراءة/كتابة الملفات، البحث على الويب، توليد الصور، توليد الفيديو، ومكتبة الـ Skills الكاملة التي تضم أكثر من 300,000 Skill. يمكن للوكيل فتح shell جديد، تشغيل سكربت، قراءة الناتج، وإرساله إليك — كل ذلك في نفس دورة المحادثة.
الفجوة العملية بين هذين النهجين ليست تدريجية. بوت تليجرام عادي يمكنه أن يخبرك بحالة الطقس. بوت تليجرام الخاص بـ HappyCapy يمكنه كتابة كود لجلب بيانات الطقس من ثلاث واجهات برمجية، مقارنتها، رسم مخطط بياني، حفظه كملف PNG، وإرساله إليك كصورة — في رسالة واحدة، دون أن تترك تليجرام.
| الميزة | بوت تليجرام عادي | بوت تليجرام HappyCapy |
|---|---|---|
| الإجابة على الأسئلة | نعم | نعم |
| تشغيل أوامر Bash | لا | نعم |
| كتابة الكود وتنفيذه | لا | نعم |
| الوصول إلى ملفات دائمة | لا | نعم |
| توليد صور بالذكاء الاصطناعي | لا (يحتاج تكاملًا منفصلًا) | نعم، بشكل أصلي |
| توليد الفيديو | لا | نعم |
| استخلاص بيانات الويب (Web scraping) | لا | نعم |
| الوصول إلى أكثر من 300,000 Skill | لا | نعم |
| يعمل على مدار الساعة دون الحاجة لجهازك | لا | نعم (Fly.io يعمل دائمًا) |
| سجل محادثة خاص بكل مستخدم | محدود | كامل ودائم |
ما يمكنك فعله بالفعل
قائمة القدرات ليست نظرية. هذه أشياء يقوم بها المستخدمون اليوم:
- طلب من البوت استخلاص بيانات موقع ويب وإعادتها كبيانات منظمة في جدول أو JSON
- جعله يكتب سكربت بايثون، ينفّذه داخل الصندوق الرملي، ويُعيد الـ stdout — دون الحاجة إلى IDE
- توليد صورة بالذكاء الاصطناعي من موجّه (prompt) واستلامها مباشرة في محادثة تليجرام
- تشغيل أي من أكثر من 300,000 Skill الخاصة بـ HappyCapy أثناء المحادثة — توليد ملفات PDF، إنشاء جداول بيانات، شرائح PPTX، تركيب صوتي
- البحث في الويب، قراءة مصادر متعددة، وإعادة ملخص مُركّب مع الاستشهادات
- إنشاء وحفظ ملفات في تخزين دائم، ثم استرجاعها أو تحديثها في رسائل لاحقة
- تشغيل مهام مجدولة: يمكن للوكيل تشغيل سكربت كل صباح وإرسال الناتج إليك كرسالة
- مراقبة رابط أو نقطة نهاية API وتنبيهك عند حدوث تغيير
- معالجة المستندات المرفوعة — لصق رابط ملف CSV، والحصول على تحليل بالمقابل
- ربط سير عمل متعدد الخطوات كان سيتطلب بدلًا من ذلك التبديل بين خمس أدوات مختلفة
المزايا
- يعمل دائمًا، دون الحاجة إلى حاسوب محمول. يعمل الصندوق الرملي على بنية تحتية Fly.io. يمكنك مراسلة البوت من هاتفك في الساعة الثانية صباحًا وسيقوم بتنفيذ الكود على خادم لا تحتاج إلى لمسه أبدًا.
- واجهة واحدة لكل شيء. بدلًا من فتح Claude، ثم محرر كود، ثم متصفح، ثم أداة صور — رسالة واحدة على تليجرام تُشغّل كل ذلك.
- السياق يبقى محفوظًا. يتم تخزين سجل المحادثة لكل مستخدم. يمكنك الرجوع إلى شيء طلبته منذ ثلاثة أيام دون إعادة شرح السياق.
- صلاحيات جذر (root) كاملة في الصندوق الرملي. يمكن للوكيل تثبيت الحزم، كتابة الملفات، وتشغيل أي أمر Unix. لا قيود قد يفرضها روبوت محادثة استهلاكي.
- أكثر من 300,000 Skill متاحة فورًا. أي سير عمل تم تجهيزه كـ Skill في HappyCapy يبتعد عنك جملة واحدة فقط.
- قابل للمشاركة. أعطِ اسم مستخدم البوت لزميل أو عميل. يمكن لمستخدمين متعددين التفاعل في وقت واحد، وكل منهم له سجل محادثة معزول.
- باقة مجانية متاحة. جسر تليجرام نفسه لا يضيف أي تكلفة فوق باقة HappyCapy الحالية لديك.
حالات استخدام حقيقية
المطوّر المستقل الذي ترك حاسوبه المحمول في المكتب. دفعت commit، اكتشفت خللًا في سجلات النشر (deploy logs)، وأنت في طريقك للخروج بالفعل. من هاتفك تراسل البوت: "اسحب آخر سجلات النشر من الخادم وأخبرني بما تشير إليه المشكلة في السطر 847." بعد ثلاثين ثانية لديك الجواب. تراسل مجددًا: "اكتب تصحيحًا (patch) وافتح PR." تم. دون فتح أي حاسوب محمول.
صاحب المشروع الصغير الذي يراقب المقاييس يوميًا. بدلًا من تسجيل الدخول إلى خمس لوحات معلومات كل صباح، يقوم البوت بتشغيل ملخص مجدول. كل الساعة 8 صباحًا: يسحب بيانات الإيرادات من Stripe، عدد الزوار من واجهة تحليلات، ومستويات المخزون من Shopify. يُنسّق الملخص ويرسله كرسالة تليجرام قبل انتهاء أول كوب قهوة. استغرق الإعداد محادثة واحدة مع البوت لتهيئته.
الباحث الذي يحتاج إلى استخراج بيانات سريع. تقرأ ورقة بحثية وتريد مقارنة مجموعة بيانات مع ثلاثة مصادر أخرى. التبديل إلى متصفح، والانتقال إلى كل مصدر، وتنزيل ملفات CSV، وإجراء مقارنة يستغرق 20 دقيقة. مراسلة البوت بالروابط ووصف ما تحتاجه يستغرق دقيقتين. يقوم البوت بالاستخلاص، والتحليل، والمقارنة، ويُعيد جدولًا.
الوالد الذي أنشأ مساعدًا للواجبات المنزلية. الأطفال لديهم حساب تليجرام بالفعل. تمت إضافة بوت HappyCapy إلى مجموعة العائلة. يمكنه شرح المسائل الرياضية خطوة بخطوة، توليد رسوم بيانية، كتابة أسئلة تدريبية، والتحقق من الإجابات — دون إعلانات، دون إنشاء حساب، ودون حلقة التشتيت الخاصة بروبوت محادثة استهلاكي. يحتفظ الوالد برمز المشرف (admin token)؛ ويحصل الأطفال على أداة مُركّزة.
كيفية الإعداد
الإعداد يستغرق أقل من خمس دقائق إذا كان لديك حساب HappyCapy. تبدأ العملية عبر BotFather الخاص بتليجرام: راسل @BotFather، شغّل /newbot، اختر اسمًا، واستلم رمز بوت (bot token) — سلسلة تبدو مثل 7384920156:AAF.... هذا الرمز هو كل ما تحتاجه HappyCapy لمعرفة إلى أين توجّه المحادثات.
داخل HappyCapy، تتولى Skill تليجرام باقي العملية. شغّل الـ Skill، ألصق رمز البوت عند الطلب، ويصبح الجسر نشطًا. يبدأ الـ Skill حلقة استطلاع (polling loop) داخل الصندوق الرملي تستمع إلى رسائل تليجرام الواردة وتوجّهها عبر claude --print مع صلاحية وصول كاملة للأدوات. يتم تخزين سجل المحادثة لكل معرّف مستخدم في تليجرام، بحيث يحصل كل شخص يراسل بوتك على جلسة دائمة خاصة به.
الـ Skill الكامل مع سكربتات الإعداد، وتوثيق متغيرات البيئة، وخيارات التهيئة لتحديد معدل الطلبات (rate limiting) وقوائم المستخدمين المسموح لهم (allowlists) متوفر على github.com/ndpvt-web/happycapy-telegram. إذا كنت تريد فهمًا أعمق لسبب اختلاف بنية وكيل HappyCapy عن إعداد روبوت محادثة نموذجي قبل أن تبدأ، فإن AI Agent vs Chatbot يغطّي هذا الفرق بالتفصيل. وإذا كنت تفكّر في تشغيل بنيتك التحتية الدائمة للذكاء الاصطناعي بنفسك بدلًا من الاعتماد على Fly.io، فمن المفيد قراءة Mac Mini as AI Server 2026 أولًا.
الأسئلة الشائعة
هل يعمل البوت على مدار الساعة أم فقط عندما يكون حاسوبي قيد التشغيل؟ يعمل على مدار الساعة. يعيش الصندوق الرملي على بنية تحتية Fly.io، لا على جهازك المحلي. بعد نشر Skill تليجرام، يبقى نشطًا دون أن يكون حاسوبك قيد التشغيل أو حتى متصلًا بالإنترنت.
هل يمكن للبوت الوصول إلى ملفاتي وأدواتي في HappyCapy؟ نعم. يعمل البوت داخل صندوقك الرملي في HappyCapy، وهذا يعني أن لديه وصولًا إلى كل ما في تلك البيئة: الملفات التي خزّنتها، والـ Skills التي ثبّتها، ومتغيرات البيئة التي ضبطتها، وأي تكاملات وصلتها. إنه وكيلك، متاح عبر واجهة مختلفة.
هل هذا مجاني للاستخدام؟ Skill جسر تليجرام نفسه مجاني. تكاليفك تُحدَّد بناءً على باقة HappyCapy الخاصة بك، والتي تغطي حوسبة الصندوق الرملي واستخدام نموذج الذكاء الاصطناعي. لا توجد رسوم إضافية لطبقة تكامل تليجرام.
كيف يعمل سجل المحادثة الخاص بكل مستخدم؟ كل معرّف مستخدم في تليجرام يحصل على خيط محادثة (conversation thread) خاص به مخزّن في الصندوق الرملي. عندما يرسل المستخدم أ رسالة، يُحمّل البوت سجل المستخدم أ ويُضيف الدورة الجديدة. رسائل المستخدم ب معزولة تمامًا. السجل دائم عبر الجلسات — محادثة أجريتها منذ أسبوع لا تزال متاحة في السياق ما لم تمسحها صراحةً.
هل يمكنني تقييد من يستطيع استخدام البوت؟ نعم. يدعم الـ Skill تهيئة قائمة السماح (allowlist). يمكنك تحديد قائمة من معرّفات المستخدمين أو أسماء المستخدمين في تليجرام المسموح لهم بالتفاعل مع البوت. الرسائل من المستخدمين غير الموجودين في القائمة يتم تجاهلها بصمت أو يُعاد لها رسالة رفض مخصصة — الاختيار لك.
ماذا يحدث إذا فرض تليجرام حدًا لمعدل الطلبات (rate limit) على بوتي؟ يتعامل الـ Skill مع تحديد معدل الطلبات باستخدام تراجع تصاعدي (exponential backoff). إذا أعاد تليجرام استجابة 429، يتوقف الجسر مؤقتًا، ينتظر فترة إعادة المحاولة المطلوبة، ثم يستأنف تلقائيًا. لن تفقد أي رسائل. من الناحية العملية، لا يتم تفعيل حدود معدل الطلبات إلا تحت حمل متزامن ثقيل، وهو أمر قابل للتهيئة في إعدادات الـ Skill.
هل يمكن لأشخاص متعددين استخدام البوت في وقت واحد؟ نعم. تعالج حلقة الاستطلاع الرسائل بشكل غير متزامن (asynchronously)، وكل جلسة مستخدم مستقلة. لا توجد قائمة انتظار تحجب مستخدمًا واحدًا بينما يتم خدمة مستخدم آخر. تحت حمل مرتفع جدًا، يمكنك توسيع نطاق مثيل الصندوق الرملي على Fly.io للتعامل مع جلسات متزامنة أكثر — توثيق الـ Skill يغطي هذه التهيئة.
أفكار أخيرة
تكامل تليجرام ليس ميزة لغرض الميزة نفسها — فهو يزيل آخر نقطة احتكاك بينك وبين وكيل ذكاء اصطناعي كامل القدرة. صندوقك الرملي في HappyCapy يشغّل الكود، يولّد الوسائط، ويدير أكثر من 300,000 Skill بالفعل. جسر تليجرام يعني أنك تصل إلى كل ذلك من أي مكان تكون فيه بالفعل، دون أي تبديل للسياق. سواء كان ذلك مفيدًا في الساعة الثانية صباحًا عندما تُصحّح خللًا عن بُعد، أو مفيدًا كل صباح عندما تريد إحاطة منظمة قبل أن تفتح حاسوبك المحمول — إنه الوكيل نفسه، متاح الآن في كل جيب.
