تكامل Clawdbot مع Telegram

نظرة عامة على تكامل Clawdbot مع Telegram

يتيح لك تكامل Clawdbot مع Telegram توصيل مساعد الذكاء الاصطناعي الشخصي الخاص بك بـ Telegram باستخدام Bot API عبر grammY. هذا جاهز للإنتاج للرسائل الخاصة والمجموعات، مع long-polling افتراضياً ودعم webhook اختياري.

لماذا تستخدم Clawdbot مع Telegram؟

يقدم Telegram واجهات برمجة بوت قوية وميزات خصوصية. يوفر تكامل Clawdbot مع Telegram:

الإعداد السريع (للمبتدئين)

1. أنشئ بوت مع @BotFather (رابط مباشر)
2. تأكد من أن الحساب هو بالضبط @BotFather، ثم انسخ الرمز
3. اضبط الرمز عبر env (TELEGRAM_BOT_TOKEN=...) أو config (channels.telegram.botToken)
4. ابدأ البوابة
5. الوصول عبر الرسائل الخاصة هو الاقتران افتراضياً؛ وافق على رمز الاقتران عند الاتصال الأول

الحد الأدنى من التكوين:

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

إعداد Clawdbot Telegram

المتطلبات الأساسية

قبل توصيل Clawdbot بـ Telegram، تأكد من أن لديك:

• تم تثبيت Clawdbot على جهازك
• حساب Telegram
• رمز Telegram Bot من @BotFather

الخطوة 1: إنشاء بوت Telegram

أنشئ بوت من خلال BotFather في Telegram:

1. افتح Telegram وتحدث مع @BotFather (رابط مباشر)
2. تأكد من أن الحساب هو بالضبط @BotFather
3. نفّذ /newbot، ثم اتبع التعليمات (الاسم + اسم المستخدم المنتهي بـ bot)
4. انسخ الرمز واحفظه بأمان

إعدادات BotFather الاختيارية:

• /setjoingroups — السماح/منع إضافة البوت إلى المجموعات
• /setprivacy — التحكم في ما إذا كان البوت يرى جميع رسائل المجموعة

الخطوة 2: تكوين الرمز

اضبط الرمز عبر متغير البيئة أو التكوين:

متغير البيئة:

TELEGRAM_BOT_TOKEN=123:abc

ملف التكوين (~/.clawdbot/clawdbot.json):

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

إذا تم تعيين كل من env و config، فإن config له الأسبقية.

الخطوة 3: بدء البوابة

clawdbot gateway --port 18789

يبدأ Telegram عندما يتم حل الرمز (التكوين أولاً، env كبديل).

الخطوة 4: التحقق من الاتصال

تحقق من حالة Clawdbot Telegram الخاص بك:

clawdbot channels status telegram

الرمز + الخصوصية + الأذونات

إنشاء الرمز (BotFather)

• /newbot ينشئ البوت ويعيد الرمز (احتفظ به سرياً)
• إذا تسرب الرمز، قم بإلغائه/إعادة إنشائه عبر @BotFather وحدّث التكوين الخاص بك

رؤية رسائل المجموعة (وضع الخصوصية)

بوتات Telegram تكون افتراضياً في وضع الخصوصية، الذي يحد من رسائل المجموعة التي يستلمونها. الخيارات:

1. عطّل وضع الخصوصية باستخدام /setprivacy
2. أضف البوت كمسؤول مجموعة (بوتات المسؤولين تستلم جميع الرسائل)

ملاحظة: عند تبديل وضع الخصوصية، يتطلب Telegram إزالة + إعادة إضافة البوت إلى كل مجموعة لتصبح التغييرات سارية المفعول.

أذونات المجموعة (حقوق المسؤول)

يتم تعيين حالة المسؤول داخل المجموعة (واجهة Telegram). بوتات المسؤولين تستلم دائماً جميع رسائل المجموعة.

ميزات Clawdbot Telegram

كيف يعمل

• يتم تطبيع الرسائل الواردة في مظروف القناة المشترك مع سياق الرد وعناصر نائبة للوسائط
• ردود المجموعة تتطلب إشارة افتراضياً (@إشارة أصلية أو أنماط مكونة)
• الردود دائماً توجه إلى نفس دردشة Telegram
• Long-polling يستخدم grammY runner مع تسلسل لكل دردشة

بث المسودات

يمكن لـ Clawdbot بث الردود الجزئية في رسائل Telegram الخاصة باستخدام sendMessageDraft.

المتطلبات:

• وضع Threading مفعل للبوت في @BotFather (وضع موضوع المنتدى)
• فقط سلاسل الدردشة الخاصة
• channels.telegram.streamMode غير مضبوط على "off"

بث المسودات للرسائل الخاصة فقط؛ Telegram لا يدعمه في المجموعات أو القنوات.

التنسيق (Telegram HTML)

• نص Telegram الصادر يستخدم parse_mode: "HTML"
• المدخلات الشبيهة بـ Markdown يتم تحويلها إلى HTML آمن لـ Telegram
• HTML الخام من النماذج يتم تهريبه لتجنب أخطاء تحليل Telegram

الأوامر

يدعم Clawdbot Telegram أوامر مخصصة:

تكوين Clawdbot Telegram

مثال تكوين كامل

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

التحكم في الوصول (الرسائل الخاصة + المجموعات)

الوصول للرسائل الخاصة:

• dmPolicy: "pairing" — المرسلون غير المعروفين يحصلون على رمز اقتران؛ وافق باستخدام CLI
• dmPolicy: "allowlist" — الرد فقط على المستخدمين في القائمة المسموح بها
• dmPolicy: "open" — الرد على الجميع (غير موصى به)

الوصول للمجموعات:

• اضبط channels.telegram.groups بمفتاح معرف المجموعة أو "*" لجميع المجموعات
• استخدم requireMention: true للرد فقط عند الإشارة

العثور على معرف مستخدم Telegram الخاص بك

استخدم @userinfobot أو بوتات مشابهة للحصول على معرف مستخدم Telegram الرقمي الخاص بك.

تخزين بيانات اعتماد Clawdbot Telegram

يخزن Clawdbot بيانات اعتماد Telegram بأمان:

~/.clawdbot/credentials/telegram/bot_token
~/.clawdbot/credentials/telegram/session.json

تبقى بيانات Clawdbot Telegram الخاصة بك على جهازك المحلي.

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

البوت لا يستجيب

إذا لم يستجب بوت Clawdbot Telegram الخاص بك:

1. تحقق من الرمز: clawdbot channels verify telegram
2. تحقق من حالة البوت مع @BotFather
3. راجع السجلات: cat /tmp/clawdbot/telegram.log

تفعيل المجموعة

لتفعيل Clawdbot في مجموعة:

عبر التكوين (موصى به):

{
  "channels": {
    "telegram": {
      "groups": {
        "<group_id>": { "requireMention": true }
      }
    }
  }
}

عبر الأمر (مستوى الجلسة): استخدم /activate في دردشة المجموعة.

الحصول على معرف دردشة المجموعة

أعد توجيه رسالة من المجموعة إلى @userinfobot أو استخدم Telegram API.

أفضل ممارسات Clawdbot Telegram

1. استخدم وضع الاقتران: آمن افتراضياً مع رموز الاقتران
2. اضبط وضع الخصوصية: كوّن في @BotFather بناءً على احتياجاتك
3. تعامل مع حدود المعدل: نفّذ حدود معدل مناسبة
4. راقب الاستخدام: تتبع تحليلات بوت Clawdbot Telegram

الخطوات التالية

• تكامل Clawdbot مع WhatsApp - قم بتوصيل Clawdbot بـ WhatsApp
• تكامل Clawdbot مع Discord - قم بإعداد Clawdbot على Discord
• دليل إعداد Clawdbot - دليل التثبيت الكامل