كيف تربط OpenClaw بـ Telegram

الجواب المختصر. أنشئ بوتًا عبر @BotFather في Telegram (/newbot) وانسخ رمزه. أعطِ الرمز لـ OpenClaw، ثم اسمح لمعرّف مستخدم Telegram الرقمي الخاص بك وحده بمراسلته. على جهازك الخاص يعني ذلك openclaw channels add --channel telegram --token <token> إضافة إلى dmPolicy: "allowlist" مع معرّفك في allowFrom. أما على PlayNHost فتلصق الرمز ومعرّفك في صفحة الوكيل، ثم تعيد التشغيل.

روجع في 6 نوفمبر 2026، وهو صحيح لإصدار OpenClaw 2026.11.1.

يعتمد هذا الدليل على وثائق Telegram في OpenClaw وعلى لوحة PlayNHost كما تعمل اليوم. Telegram مدمج في OpenClaw: لا توجد إضافة لتثبيتها.

الخطوة 1: أنشئ البوت وانسخ رمزه

1. في Telegram، افتح محادثة مع @BotFather. تأكد أن الاسم هو @BotFather بالضبط.
2. أرسل /newbot، واختر اسمًا ظاهرًا، ثم اسم مستخدم ينتهي بـ bot.
3. يرد BotFather بالرمز، وشكله مثل 123456789:AAH.... أبقِه سريًا: كل من يملكه يستطيع التحكم ببوتك.

لدى BotFather أيضًا تطبيق ويب (t.me/BotFather?startapp) يفعل الشيء نفسه بالأزرار.

استخدم بوتًا لا يشغّله شيء آخر. إذا كان OpenClaw أقدم على حاسوبك المحمول، أو أي برنامج آخر، ما زال يستخدم الرمز نفسه، فأوقفه أولًا أو أنشئ بوتًا جديدًا.

الخطوة 2: اعثر على معرّف مستخدم Telegram الخاص بك

تطلب القائمة المسموحة في OpenClaw معرّف المستخدم الرقمي، وليس @اسم المستخدم ولا رقم هاتفك ولا معرّف البوت. الطرق التي تذكرها وثائق OpenClaw:

• من البوت نفسه (بلا طرف ثالث). بينما البوت في وضع pairing، أرسل له أي رسالة. يتضمن رد الاقتران العبارة "Your Telegram user id". هذه هي الطريقة التي نقترحها على PlayNHost، انظر أدناه.
• من سجل OpenClaw. شغّل openclaw logs --follow، وراسل البوت، واقرأ senderUserId في سجل telegram pairing request.
• من واجهة Telegram API نفسها. راسل البوت، ثم افتح https://api.telegram.org/bot<bot_token>/getUpdates واقرأ message.from.id.
• بوت من طرف ثالث مثل @userinfobot أو @getidsbot. تصف وثائق OpenClaw هذا بأنه أقل خصوصية.

الخطوة 3 على PlayNHost: الصق الرمز ومعرّفك

تحتاج أيضًا إلى مفتاح مزود ذكاء اصطناعي في الصفحة نفسها. بدونه يتوقف Start برسالة: "Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token." (وكيلك غير مُعدّ بعد: يحتاج إلى مفتاح API من مزود ذكاء اصطناعي واحد ورمز بوت Telegram أو Discord.)

1. افتح خادمك على panel.playnhost.com، ثم تبويب الوكيل.
2. تحت مزود الذكاء الاصطناعي، اضبط مفتاحًا واحدًا إن لم تفعل (راجع أي مفتاح مزود ذكاء اصطناعي تستخدم مع OpenClaw).
3. تحت تطبيقات الدردشة، اضغط تعيين في صف رمز بوت Telegram، والصق الرمز من BotFather، ثم اضغط حفظ. تتحقق اللوحة من شكله؛ وإذا لصقت شيئًا خاطئًا تظهر "That is not a valid telegram bot token." (هذا ليس رمز بوت Telegram صالحًا.) بعد الحفظ يعرض الصف آخر أربعة أحرف فقط، ولا يظهر الرمز مرة أخرى.
4. لا تعرف معرّفك بعد؟ اترك معرّفات مستخدمي Telegram فارغًا واضغط تشغيل. عندما يعمل الوكيل تطبع الـ Console:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   أرسل رسالة إلى بوتك في Telegram. يرد مرة واحدة برمز اقتران ومعرّف مستخدم Telegram الخاص بك (يرسل OpenClaw رمزًا مرة كل ساعة تقريبًا لكل شخص ويتجاهل الرسائل بينها). انسخ المعرّف وتجاهل الرمز: لا شيء يحتاج إلى موافقة على PlayNHost. هذه الخطوة لا تسمح لأحد بالدخول.
5. تحت من يمكنه مراسلته، اكتب معرّفك في معرّفات مستخدمي Telegram واضغط حفظ. تُكتب عدة معرّفات في سطر واحد تفصل بينها فواصل.
6. تقول الصفحة: "تُطبَّق التغييرات عند التشغيل التالي لوكيلك." اضغط إعادة التشغيل الآن. ثم تؤكد الـ Console:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. راسل بوتك. يجيب وكيلك. تُتجاهل الرسائل من أي حساب Telegram آخر.

ما الذي تضبطه PlayNHost نيابة عنك

• عند وجود معرّفات في لوحة الوكيل، تستخدم الرسائل الخاصة في Telegram dmPolicy: "allowlist" مع هذه المعرّفات بالضبط، وهذا ما توصي به وثائق OpenClaw للبوت الذي له مالك واحد. وبدون معرّف تستخدم pairing: يحصل الغرباء على رمز ويُتجاهلون، ولا يستطيع أحد الموافقة عليهم بدون سطر أوامر OpenClaw أو لوحة تحكمه، وخادم PlayNHost لا يوفر أيًّا منهما.
• تصبح المعرّفات التي تدرجها أيضًا مالكي الأوامر في OpenClaw (commands.ownerAllowFrom)، فتعمل لك الأوامر المخصصة للمالك منذ أول رسالة.
• يصل الرمز إلى OpenClaw باسم TELEGRAM_BOT_TOKEN في بيئته. أما رمز مكتوب في ملف إعدادات OpenClaw نفسه فكان سيتغلب عليه، لذلك يحذفه البدء من الملف: الرمز المستخدم هو الموجود في لوحة الوكيل.
• تبقى المجموعات مغلقة: لا يسمح OpenClaw بأي مجموعة حتى تُضاف إلى إعداداته، وأي إعداد يسمح للجميع بمحادثة الوكيل يُعاد إلى معرّفاتك عند البدء التالي.

الخطوة 3 على جهازك الخاص

1. أضف الرمز:

   openclaw channels add --channel telegram --token <bot-token>

   أو اضبط TELEGRAM_BOT_TOKEN في بيئة Gateway. الرمز الموجود في ملف الإعدادات يتغلب على متغير البيئة.
2. اسمح لنفسك فقط في ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   جزء commands يجعلك المالك للأوامر المخصصة للمالك: لا يفعل OpenClaw ذلك لقائمة مسموحة كُتبت يدويًا. وallowlist مع allowFrom فارغة تحجب كل الرسائل الخاصة ويرفضها فحص إعدادات OpenClaw.
3. أو أبقِ وضع pairing الافتراضي ووافق على نفسك بعد أول رسالة:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   تنتهي صلاحية الرموز بعد ساعة. وأول اقتران تتم الموافقة عليه يجعلك أيضًا مالك الأوامر.
4. تحقق من القناة بـ openclaw channels status --probe.

عندما لا يرد

تريد Discord أيضًا؟ راجع ربط OpenClaw بـ Discord. لم تُعدّ شيئًا بعد؟ أنشئ خادم OpenClaw.

PlayNHost غير تابعة لـ OpenClaw Foundation. OpenClaw برنامج مفتوح المصدر بترخيص MIT.