إطلاق قوة Telegram مع وضع المواضيع في OpenClaw

OpenClaw هو إطار عمل للوكلاء بالذكاء الاصطناعي مفتوح المصدر يمكنه أتمتة المهام عبر منصات المراسلة مثل Slack وDiscord وWhatsApp وTelegram. ومن أهم أسباب انتشار OpenClaw أنه يحوّل النماذج اللغوية الكبيرة إلى الوكلاء — برامج يمكنها العمل لساعات أو أيام، وتنفيذ سلاسل معقدة من الإجراءات، والحفاظ على السياق عبر قنوات متعددة. وTelegram، بما يوفره من Bot API غني ودعم للمناقشات المتسلسلة، مكمّل طبيعي لذلك. غير أن إعداد OpenClaw على Telegram والاستفادة من وضع المواضيع ليس واضحًا لكثير من المستخدمين الجدد. يقدّم هذا المقال برنامجًا تعليميًا خطوة بخطوة لربط مساعدك بـ Telegram، ويشرح كيف يعمل وضع المواضيع من الداخل، ويعرض حالات استخدام واقعية، وينتهي بنصائح وإرشادات لاستكشاف الأخطاء وإصلاحها. كل المعلومات في هذا الدليل مأخوذة من توثيق OpenClaw الرسمي ومن تجربة المجتمع.

لماذا Telegram؟

يحظى Telegram بشعبية لأنه يدعم الروبوتات ومحادثات المجموعات والقنوات الخاصة والمواضيع على نمط المنتديات. وتوفّر المنصة حدًا سخيًا لطول الرسالة (4096 حرفًا)، ورفع الوسائط، وإيموجي التفاعلات، ولوحات المفاتيح المضمّنة. وخلافًا لبعض منصات المراسلة، فإن Bot API الخاص بـ Telegram مجاني ومستقر وموثّق جيدًا. وتدعم طبقة البوابة في OpenClaw Telegram دعمًا من الدرجة الأولى؛ والتكامل جاهز للإنتاج للرسائل المباشرة للروبوتات وللمجموعات، ويعمل عبر الاستقصاء الطويل أو Webhooks. بعبارة أخرى، بعد الإعداد الصحيح سيرسل مساعدك الرسائل ويستقبلها بموثوقية دون الحاجة إلى كتابة أي كود مخصص.

إعداد OpenClaw مع Telegram

1. أنشئ روبوتك واسترجع رمز API

افتح Telegram وابدأ محادثة مع @BotFather الروبوت الرسمي. شغّل /newbot، واختر اسمًا واسم مستخدم، وانسخ الرمز الذي يعيده. ستلصق هذا الرمز في إعدادات OpenClaw. تُدار روبوتات Telegram بالكامل عبر BotFather؛ ويمكنك أيضًا استخدام /setprivacy و /setjoingroups لتبديل سلوك المجموعات لاحقًا.

2. إعداد OpenClaw

افتح ملف openclaw.json الإعدادات (الموجود عادةً في ~/.openclaw) وأضف قسمًا telegram ضمن مفتاح channels :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

الـ botToken يحمل الرمز الذي استلمته من BotFather. و dmPolicy يتحكم في كيفية رد مساعدك على الرسائل المباشرة: pairing (الافتراضي) يعني أن الروبوت سيجيب فقط على الرسائل المباشرة من المستخدمين الذين توافق عليهم؛ مفتوح يتيح للجميع؛ allowlist يقيّد الوصول بقائمة محددة من معرّفات المستخدمين؛ و disabled يعطّل دعم الرسائل المباشرة. علامة requireMention مهمة للمجموعات: عندما تُضبط على true، لا يستجيب البوت إلا عند ذكر اسم المستخدم الخاص به، ما يمنعه من الرد على كل رسالة في محادثة جماعية مزدحمة.

3. ابدأ البوابة واقرن حسابك

بعد حفظ الإعدادات، شغّل openclaw gateway لتشغيل بوابة المراسلة. بعد ذلك ستحتاج إلى اعتماد حسابك على Telegram عبر إنشاء رمز اقتران واعتماده. في طرفية منفصلة، شغّل openclaw pairing list telegram لعرض الطلبات المعلّقة، ثم اعتمد معرّف المستخدم الخاص بك باستخدام openclaw pairing approve telegram <CODE>. تنتهي صلاحية الرموز بعد ساعة واحدة، لذا أكمل هذه الخطوة بسرعة. بعد الاقتران، ستُوجَّه الرسائل من حسابك على Telegram إلى وكيل OpenClaw الخاص بك.

4. أضف البوت إلى المجموعات والمواضيع

للسماح لمساعدك بالمشاركة في المحادثات الجماعية أو مواضيع المنتدى، أضفه إلى مجموعات Telegram المطلوبة، ثم حدّث channels.telegram.groups الإعدادات. على سبيل المثال:

"channels": {
  "telegram": {
    "groups": {
      "-100123456789": { "requireMention": true },
      "*": { "requireMention": false }
    },
    "groupPolicy": "allowlist"
  }
}

هنا، * يمثّل هذا المُدخل خيارًا شاملًا لأي مجموعة؛ requireMention: true يضمن ألا يزعج المساعد القناة برسائل كثيرة. يمكنك أيضًا ضبط groupPolicy إلى مفتوح للسماح للبوت بالانضمام تلقائيًا إلى أي مجموعة تدعوه، أو disabled لحظر استخدام المجموعات كليًا. بعد ضبط المجموعات، أعد تشغيل البوابة وأضف البوت مجددًا إلى كل مجموعة إذا غيّرت إعدادات الخصوصية.

فهم وضع المواضيع

أطلق Telegram مواضيع المنتدى في 2022، ما سمح للمجموعات الكبيرة بتقسيم المحادثات إلى سلاسل منفصلة. ويستفيد OpenClaw من هذه الميزة عبر إضافة :topic:<threadId> إلى مفاتيح الجلسات الداخلية الخاصة به. يعني ذلك أن لكل موضوع سياق محادثة خاصًا به؛ فالرسائل المرسلة في سلسلة لا تتسرّب إلى أخرى. وينتج عن هذا التصميم سلوكان مهمان:

1. عزل المواضيع: عندما يتلقى المساعد رسالة تحمل message_thread_id، يستخدم مفتاح جلسة مثل telegram:<chatId>:topic:<threadId>. وتُرسل الردود إلى السلسلة نفسها. بهذه الطريقة يحافظ الوكيل على السياق في المناقشات الطويلة متعددة الفروع.
2. الموضوع العام مقابل الموضوع المحدد: يتعامل Telegram مع معرّف السلسلة 1 باعتباره موضوع «العام» الافتراضي. عند إرسال رسائل إلى السلسلة 1، ينبغي أن تحذف message_thread_id في استدعاء API؛ وإلا يرفضه Telegram. ويتولى OpenClaw ذلك تلقائيًا عند إرسال الردود.

لا يقتصر وضع المواضيع على المجموعات الفائقة ذات المنتديات. في المحادثات الخاصة (الرسائل المباشرة)، يرفق Telegram أحيانًا message_thread_id بالردود على رسائل أقدم. يحتفظ OpenClaw بهذا المعرّف ويستخدم مفاتيح جلسات تراعي السلاسل، لذا يبقى سجل محادثتك منظمًا حتى في الرسائل المباشرة.

إعداد وضع الرد

افتراضيًا، يضبط OpenClaw channels.telegram.replyToMode إلى إيقاف، وهو ما يعطّل تسلسل الردود الضمني. إذا كنت تفضّل أن يرد المساعد مباشرة على الرسالة المُطلِقة، فاضبط replyToMode إلى الأول أو جميع. يمكنك أيضًا تضمين وسوم صريحة مثل [[reply_to_current]] أو [[reply_to:<messageId>]] في رد الوكيل. توجّه هذه الوسوم البوابة لتسلسل الرد وفقًا لذلك.

البث ومؤشرات الكتابة

يدعم OpenClaw بث الردود الجزئية على Telegram. مع ضبط channels.telegram.streaming على partial أو progress، ترسل البوابة رسالة مؤقتة وتعدّلها أثناء توليد النموذج للنص. هذا يوفّر تجربة استخدام أفضل في الردود الطويلة. يمكنك حتى تفعيل إخراج الاستدلال في الوقت الفعلي عبر /reasoning stream أمر أثناء المحادثة. تُرسل مؤشرات الكتابة تلقائيًا، بما في ذلك داخل السلاسل؛ لكن بالنسبة إلى معرّف السلسلة 1 (الموضوع العام) يتجاهل Telegram message_thread_id في إجراء الكتابة.

التفاعلات والملصقات والأوامر المضمّنة

تدعم واجهة Bot API في Telegram تفاعلات الرسائل والملصقات والأزرار المضمّنة. يتيح OpenClaw هذه الميزات عبر نظام الإجراءات:

• التفاعلات: الـ react يتيح الإجراء للوكيل التفاعل مع رسالة باستخدام إيموجي. يمكن ضبط إشعارات التفاعل عبر channels.telegram.reactionNotifications و reactionLevel، لتفعيل الإشعارات لرسائل البوت أو كل الرسائل أو لا شيء. لاحظ أن Telegram لا يوفّر معرّفات سلاسل للتفاعلات، لذا تُوجّه دائمًا إلى السلسلة الرئيسية.
• الملصقات: فعّل إجراءات الملصقات بضبط channels.telegram.actions.sticker: true. تُخزَّن الملصقات محليًا في ذاكرة مؤقتة؛ يمكنك البحث في الذاكرة المؤقتة باستخدام sticker-search إجراء وإرسال ملصق باستخدام sticker.
• الأزرار المضمّنة: إعداد channels.telegram.capabilities.inlineButtons لتحديد متى يُسمح بلوحات المفاتيح المضمّنة (off أو dm أو group أو all أو allowlist). بعد ذلك يمكنك إرسال رسالة بأزرار عبر تضمين buttons مصفوفة في جسم الإجراء.

حالات استخدام وضع المواضيع

يفتح وضع المواضيع إمكانات سير عمل قوية كانت ستكون مربكة أو مستحيلة في محادثة واحدة. إليك بعض السيناريوهات العملية:

1. تنسيق المشاريع المتعددة

تخيّل أنك تدير عدة مشاريع في الوقت نفسه. أنشئ مجموعة فائقة واحدة على Telegram وفعّل مواضيع المنتدى. ولكل مشروع، أنشئ موضوعًا مخصصًا (مثل، إعادة تصميم الموقع, حملة تسويقية, إصلاح الأخطاء). عندما تراسل مساعدك داخل موضوع ما، يستخدم OpenClaw تلقائيًا مفتاح جلسة فريدًا لذلك الموضوع. هذا يُبقي سياق المحادثة منفصلًا، لذا عندما تسأل عن “الموعد النهائي”، يعرف المساعد أي مشروع تقصد.

2. مواضيع جانبية خاصة في محادثات المجموعة

في محادثة عائلية أو محادثة فريق مزدحمة، قد ترغب في طرح سؤال على مساعدك دون مقاطعة النقاش الرئيسي. ردّ على رسالتك السابقة أو اذكر البوت في ردّ؛ يُرفق Telegram message_thread_id، ما يجعل OpenClaw يوجّه المحادثة إلى موضوع مرتبط بتلك الرسالة. الآن يمكنك طرح أسئلة متابعة مثل “ما قائمة مهامي؟” أو “لخّص رسائل اليوم” دون إغراق المحادثة الرئيسية.

3. المهام طويلة الأمد

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

4. جلسات العصف الذهني

يمكن أن تعمل مواضيع المنتدى كغرف للعصف الذهني. مثلًا، افتح موضوعًا باسم أفكار المدونة واستكشف أفكار المقالات مع وكيلك. سيحافظ المساعد على سياق الاقتراحات السابقة داخل الموضوع، ما يسهّل تحسين الأفكار وتوسيعها. وفي الوقت نفسه، تبقى محادثتك العامة مرتبة.

5. دعم العملاء أو الأسئلة الشائعة

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

استكشاف الأخطاء وإصلاحها ونصائح

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

حدود السجل: يخزّن OpenClaw سجلًا محدودًا لكل محادثة أو موضوع (50 رسالة افتراضيًا للمجموعات، ويُضبط عبر channels.telegram.historyLimit). ارفع هذا الحد إذا كان وكيلك يحتاج إلى سياق أكبر، لكن انتبه إلى استهلاك الذاكرة.

Webhook مقابل الاستطلاع الطويل: افتراضيًا، يستخدم OpenClaw الاستطلاع الطويل، وهو أسهل في الإعداد. وإذا أردت استخدام Webhooks (مثلًا لتقليل زمن الاستجابة)، فاضبط channels.telegram.webhookUrl و webhookSecret. راجع الوثائق لخيارات المنفذ والمضيف.

وسوم الرد الصريحة: استخدم [[reply_to_current]] أو [[reply_to:<id>]] في ردود وكيلك عندما تحتاج إلى تحكم دقيق في أهداف الرد. وهذا مفيد بشكل خاص للبوتات التي تراقب عدة مواضيع في الوقت نفسه.

إدارة الوصول: استخدم channels.telegram.allowFrom و groupPolicy لتقييد من يمكنه التحدث إلى بوتك والمجموعات التي يمكنه الانضمام إليها. وهذا يمنع الرسائل المزعجة والأوامر غير المصرّح بها.

الخاتمة

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