الدرس 02 — ربط Telegram: جعل مساعد الذكاء الاصطناعي يسكن في تطبيق المحادثة
الهدف: إعداد Telegram Bot لتتمكن من التحادث مع الذكاء الاصطناعي في أي وقت من هاتفك، مع دعم المحادثات الخاصة والمجموعات.
كيف يعمل
بعد تشغيل بوابة OpenClaw، تستمع إلى عدة "قنوات". تستقبل قناة Telegram الرسائل عبر Bot API بالاستطلاع الطويل (long polling)، ثم تُحيلها إلى وكيل الذكاء الاصطناعي للمعالجة، وتُرسل الرد إلى Telegram.
هاتفك → خوادم Telegram → Bot → بوابة OpenClaw → MiniMax → الرد
الخطوة الأولى: إنشاء Telegram Bot
-
افتح Telegram وابحث عن @BotFather
-
أرسل
/newbot، واتبع التعليمات لتعبئة الاسم واسم المستخدم -
ستحصل على Token بالتنسيق التالي:
8543054163:AAHc-yE-nfRlbGw1clvW1OwjdMZ6O_j9tWs
الخطوة الثانية: إضافة Token إلى الإعداد
عدّل ملف .env (في مجلد المشروع أو ~/.openclaw/.env):
TELEGRAM_BOT_TOKEN=توكنكأو أضفه مباشرةً في كتلة env داخل ~/.openclaw/openclaw.json:
{
"env": {
"MINIMAX_API_KEY": "${MINIMAX_API_KEY}",
"TELEGRAM_BOT_TOKEN": "توكنك"
}
}الخطوة الثالثة: تفعيل قناة Telegram
أضف إعداد القنوات في ملف openclaw.json:
{
"channels": {
"telegram": {
"enabled": true,
"token": "${TELEGRAM_BOT_TOKEN}"
}
}
}الخطوة الرابعة: إعادة تشغيل البوابة
pnpm openclaw gateway restartراجع السجلات للتأكد من اتصال قناة Telegram:
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram
# يجب أن ترى شيئاً مثل: Telegram channel connectedالخطوة الخامسة: اختبار المحادثة
-
افتح Telegram وابحث عن البوت الخاص بك
-
أرسل
/startلبدء الاقتران -
أرسل رسالة:
"كيف الطقس اليوم، ساعدني في التحليل"
يجب أن يرد البوت خلال ثوانٍ.
الاستخدام في المجموعات
-
أضف البوت إلى المجموعة وامنحه صلاحيات المشرف
-
في المجموعة، يجب @الإشارة إلى البوت لكي يستجيب (السلوك الافتراضي لمنع الإساءة):
@اسم_بوتك ساعدني في تلخيص النقاش أعلاه
أوامر الشرطة المائلة الشائعة
أرسلها مباشرةً في Telegram:
| الأمر | الوظيفة |
|---|---|
/new |
بدء محادثة جديدة (مسح السياق) |
/reset |
إعادة تعيين المحادثة الحالية |
/status |
عرض النموذج والإعداد الحاليين |
/think |
التبديل إلى وضع التفكير العميق |
/usage |
عرض استهلاك الـ token |
الأسئلة الشائعة
ماذا أفعل إذا لم يستجب البوت؟
افحص بالترتيب: ① شغّل pnpm openclaw gateway status للتأكد من تشغيل البوابة؛ ② راجع السجلات tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram للتأكد من اتصال القناة؛ ③ في المحادثة الخاصة مع البوت يجب إرسال /start أولاً لإتمام الاقتران، وإلا ستُتجاهل الرسائل.
ماذا أفعل إذا كان البوت يرد بشكل عشوائي في المجموعة؟
يستجيب OpenClaw افتراضياً فقط للرسائل التي تتضمن @الإشارة إليه، لمنع الإزعاج. إذا كان البوت يستجيب لرسائل غير مقصودة في المجموعة، تحقق من إعداد channels.telegram.replyToMode في ملف openclaw.json واضبطه على "mention".
هل يمكن لـ Telegram Bot أن يخدم عدة مستخدمين في آنٍ واحد؟
نعم. تدعم قناة Telegram في OpenClaw التزامن المتعدد للمستخدمين افتراضياً، حيث يمتلك كل مستخدم سياق محادثة مستقل. يشترك الجميع في نفس حصة مفتاح API، لذا انتبه لضبط الاستهلاك.
هل يدعم البوت إرسال الصور والملفات؟
دعم استقبال وإرسال الصور يتطلب إعداد نموذج بصري (مثل MiniMax VL-01)، راجع الدرس 07. إمكانية إرسال الملفات تعتمد على إصدار OpenClaw، يمكن التحقق منها عبر /status.
كيف أستخدم نفس البوت على عدة أجهزة؟
يُعدّ Bot Token مرة واحدة في ملف openclaw.json، وجميع الأجهزة المرتبطة بحسابك في Telegram يمكنها التحادث مع نفس البوت. تكون جلسات البوت معزولة بـ chat_id ولا تتداخل مع بعضها.