إعداد Telegram في OpenClaw

بوت Telegram هو أسرع قناة يمكن تشغيلها، لأن الإعداد كله رمز مميز واحد من BotFather وأمر واحد يخزنه. إليك الإعداد السريع خطوة بخطوة، وقواعد أولوية الرموز المميزة، والإعدادات الموجودة من جهة Telegram لا في ملف الإعداد، واختيار وسيلة النقل بين الاستطلاع الطويل وwebhook.

الإعداد السريع

• ينتهي كلا مساري BotFather برمز مميز تلصقه في OpenClaw: مسار الدردشة، حيث تتحدث إلى حساب BotFather، وتتأكد من أن المعرف مطابق تمامًا، وتشغل أمر إنشاء بوت جديد وتحفظ الرمز المميز، أو مسار الويب في تطبيق BotFather على الويب، الذي يعمل في كل عملاء Telegram ويتيح لك إنشاء البوت عبر واجهة ونسخ رمزه المميز.
• أسرع طريقة لتهيئته هي الأمر channels add مع قناة Telegram والرمز المميز، وهو يكتب الرمز المميز في ملف الإعداد نيابة عنك؛ أما التحرير اليدوي فيعني قسم Telegram تكون فيه القناة مفعلة، مع رمز البوت، وسياسة pairing للرسائل المباشرة، وإدخال مجموعة بحرف البدل يشترط الإشارة إلى البوت، ومتغير البيئة الخاص برمز البوت ليس سوى بديل احتياطي للحساب الافتراضي فقط، لأن الحسابات المسماة يجب أن تستخدم مفتاح الرمز المميز أو ملف رمز مميز.
• مع إعادة التحميل الفورية الافتراضية يطبق gateway العامل إعداد القناة الجديد، ويتحقق فحص حالة القنوات من أن Telegram جاهز؛ وإذا كان gateway متوقفًا فشغله كخدمة مدارة أو في الطرفية، وأي تغيير في بيئة الخدمة يحتاج إلى إعادة تشغيل كي يحمل.
• إرسال أي رسالة إلى البوت ينشئ طلب الإقران الذي يعرضه الأمر pairing list ويقبله الأمر approve، مع رموز تنتهي صلاحيتها بعد ساعة واحدة؛ ثم تحتاج إضافة البوت إلى مجموعة إلى معرف المستخدم الرقمي الخاص بك لقوائم السماح، وإلى معرف دردشة المجموعة كمفتاح تحت خريطة groups، وتقرؤه من السجلات أو من بوت يكشف المعرفات من الرسائل المعاد توجيهها أو من تحديثات Bot API، وتؤكده بالأمر whoami بعد السماح بالمجموعة، ومعرفات المجموعات الفائقة السالبة توضع تحت groups، ولا توضع أبدًا في قائمة مرسلي المجموعة.

لا يستخدم Telegram الأمر openclaw channels login telegram.

الرموز المميزة وجهة Telegram

تحديد الرمز المميز يراعي الحساب: ملف الرمز المميز يتقدم على مفتاح رمز البوت، ومفتاح رمز البوت يتقدم على البيئة، وملف الإعداد يغلب دائمًا متغير البيئة، الذي لا يعتمد إلا للحساب الافتراضي، وبعد بدء تشغيل ناجح يخزن OpenClaw هوية البوت مؤقتًا لمدة تصل إلى 24 ساعة كي تتخطى عمليات إعادة التشغيل استدعاء getMe إضافيًا، ويؤدي تغيير الرمز المميز أو إزالته إلى مسح تلك الذاكرة المؤقتة. ومن جهة Telegram، تكون البوتات افتراضيًا في وضع الخصوصية، الذي يحد من رسائل المجموعة التي تتلقاها؛ ولرؤية كل رسائل المجموعة إما أن تعطل وضع الخصوصية بأمر ضبط الخصوصية أو تجعل البوت مشرفًا في المجموعة، وبعد تبديل وضع الخصوصية تزيل البوت وتعيد إضافته في كل مجموعة ليطبق Telegram التغيير. ويتم التحكم في صفة المشرف من إعدادات المجموعة، والبوتات المشرفة تتلقى كل رسائل المجموعة، وهذا يناسب السلوك الدائم في المجموعات. ومفاتيح BotFather المفيدة هي إعداد الانضمام إلى المجموعات الذي يسمح بإضافة البوت إلى المجموعات أو يمنعها، وإعداد الخصوصية الخاص برؤية رسائل المجموعات، وكلاهما متاح أيضًا في تطبيق BotFather على الويب.

الاستطلاع الطويل أم webhook

• الاستطلاع الطويل هو الافتراضي؛ أما وضع webhook فيحتاج إلى رابط webhook وسر webhook، مع مسار اختياري قيمته الافتراضية المسار telegram-webhook، ومضيف قيمته الافتراضية عنوان loopback، ومنفذ قيمته الافتراضية 8787، ومسار شهادة لملف PEM موقع ذاتيًا في الإعدادات التي تعتمد على IP مباشر أو لا تملك نطاقًا؛ ويحجز المستمع مسار health لفحوص السلامة، لذا يجب أن يستخدم مسار webhook مسارًا مختلفًا، وأي إعداد قائم على ذلك المسار يجب أن ينتقل، ويحدث الرابط وتوجيه الخادم الوسيط العكسي، ويتحقق من تغيير المستمع عبر فحص الحالة.
• في وضع الاستطلاع الطويل يحفظ OpenClaw موضع الاستئناف بعد إيداع التحديث في طابور الاستقبال الدائم، لذا يبقى المعالج الذي فشل قابلًا لإعادة المحاولة من ذلك الطابور؛ ويرتبط المستمع المحلي افتراضيًا بعنوان loopback على المنفذ 8787، والاستقبال العام يعني وجود خادم وسيط عكسي أمامه أو مضيف بحرف البدل مضبوط عن قصد.
• يتحقق وضع webhook من ضوابط حماية الطلب، والرمز السري من Telegram، ومتن JSON، ويودع التحديث في الطابور الدائم قبل إعادة استجابة 200 فارغة، ويعلم الاعتماد الدائم الناجح بترويسة قبول التسليم التي تغفلها استجابات السلامة والتوجيه والمصادقة والتحقق وأخطاء التخزين، ليتمكن الخادم الوسيط العكسي من اشتراطها بدل استنتاج القبول من التوقيت؛ وبعد الكتابة الدائمة، تحجز التحديثات وتعالج عبر عملية تفريغ الاستقبال الأساسية بمسارات لكل دردشة ولكل موضوع، ولا تؤخر أدوار الوكيل البطيئة إقرار التسليم إلى Telegram أبدًا.

ينتمي هذا الإعداد إلى مقال القناة OpenClaw على Telegram، ويتناول مقال التحكم في الوصول إلى OpenClaw عبر Telegram ما ينبغي أن تقرره بعد ذلك بشأن من يمكنه الوصول إلى البوت.

أين تتعثر عمليات الإعداد

تكاد كل محاولة فاشلة لإعداد Telegram ترجع إلى واحد من ثلاثة أمور: رمز مميز لصق لحساب مسمى عبر متغير البيئة الذي لا يخدم إلا الحساب الافتراضي، أو معرف مجموعة وضع في قائمة المرسلين بدل خريطة groups، أو وضع خصوصية ترك مفعلًا مع إيقاف اشتراط الإشارة. يمر دليل استكشاف أخطاء Telegram وإصلاحها في OpenClaw على هذه الأعراض بالترتيب، أما الجولة الإرشادية السريعة لأول قناة فهي ربط قناتك الأولى في خمس دقائق.

على Diali

على Diali، تربط قناة Telegram من لوحة التحكم، ويولد إعداد التشغيل منها ويستبدل عند كل إصدار، لذا فإن خطوات BotFather في بداية هذا المقال هي الجزء الذي يبقى على عاتقك. تصف صفحة Telegram على Diali القناة على Diali، وتصف صفحة الأمان في Diali الحدود التي تشترك فيها كل قناة مربوطة.

• رمز مميز واحد من BotFather؛ وسطر الأوامر يكتبه لك.
• رموز الإقران تنتهي صلاحيتها بعد ساعة؛ ومعرفات المجموعات توضع تحت groups.
• الاستطلاع الطويل افتراضيًا؛ ويحتاج webhook إلى سر ومسار غير مستخدم.