تيليجرام

الحالة: جاهز للإنتاج للرسائل الخاصة للبوت + المجموعات عبر grammY. الاقتراع الطويل هو الوضع الافتراضي؛ وضع webhook اختياري.

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

الخطوة 1: إنشاء الرمز المميز للبوت في BotFather

افتح تيليجرام وتحدث مع @BotFather (تأكد من أن المعرف هو بالضبط @BotFather).شغل /newbot، اتبع التعليمات، واحفظ الرمز المميز.

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

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

البديل البيئي: TELEGRAM_BOT_TOKEN=... (الحساب الافتراضي فقط). تيليجرام لا يستخدم openclaw channels login telegram؛ قم بتكوين الرمز المميز في config/env، ثم ابدأ البوابة.

الخطوة 3: ابدأ البوابة ووافق على أول رسالة خاصة

openclaw gateway
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

رموز الاقتران تنتهي صلاحيتها بعد ساعة واحدة.

الخطوة 4: أضف البوت إلى مجموعة

أضف البوت إلى مجموعتك، ثم عيّن channels.telegram.groups و groupPolicy لتتوافق مع نموذج الوصول الخاص بك.

ℹ️ ترتيب حل الرمز المميز يراعي الحساب. عمليًا، قيم التكوين تفوق البديل البيئي، و TELEGRAM_BOT_TOKEN ينطبق فقط على الحساب الافتراضي.

إعدادات جانب تيليجرام

التحكم في الوصول والتفعيل

curl "https://api.telegram.org/bot<bot_token>/getUpdates"

سلوك التشغيل

• تيليجرام مملوك من قبل عملية البوابة.
• التوجيه حتمي: الردود الواردة من تيليجرام تعود إلى تيليجرام (النموذج لا يختار القنوات).
• الرسائل الواردة تُطبع إلى ظرف القناة المشترك مع بيانات الرد والعناصر النائبة للوسائط.
• جلسات المجموعات معزولة حسب معرف المجموعة. مواضيع المنتدى تضيف :topic:<threadId> للحفاظ على عزل المواضيع.
• رسائل الرسائل الخاصة يمكن أن تحمل message_thread_id؛ OpenClaw يوجهها بمفاتيح جلسة تراعي الخيط ويحفظ معرف الخيط للردود.
• الاقتراع الطويل يستخدم مشغل grammY مع تسلسل لكل محادثة/خيط. إجمالي تزامن مصرف المشغل يستخدم agents.defaults.maxConcurrent.
• واجهة برمجة تطبيقات بوت تيليجرام لا تدعم إيصالات القراءة (sendReadReceipts لا ينطبق).

مرجع الميزات

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

المزيد من المساعدة: استكشاف أخطاء القنوات وإصلاحها.

مؤشرات مرجع تكوين تيليجرام

المرجع الأساسي:

• channels.telegram.enabled: تفعيل/تعطيل بدء تشغيل القناة.
• channels.telegram.botToken: الرمز المميز للبوت (BotFather).
• channels.telegram.tokenFile: قراءة الرمز المميز من مسار الملف.
• channels.telegram.dmPolicy: pairing | allowlist | open | disabled (الافتراضي: pairing).
• channels.telegram.allowFrom: قائمة السماح للرسائل الخاصة (معرفات مستخدم تيليجرام الرقمية). allowlist تتطلب معرف مرسل واحد على الأقل. open تتطلب "*". openclaw doctor --fix يمكنه حل إدخالات @username القديمة إلى معرفات ويمكنه استرداد إدخالات قائمة السماح من ملفات مخزن الاقتران في تدفقات هجرة قائمة السماح.
• channels.telegram.actions.poll: تفعيل أو تعطيل إنشاء استطلاعات تيليجرام (الافتراضي: مفعل؛ لا يزال يتطلب sendMessage).
• channels.telegram.defaultTo: هدف تيليجرام الافتراضي المستخدم بواسطة CLI --deliver عندما لا يتم توفير --reply-to صريح.
• channels.telegram.groupPolicy: open | allowlist | disabled (الافتراضي: allowlist).
• channels.telegram.groupAllowFrom: قائمة السماح لمرسلي المجموعة (معرفات مستخدم تيليجرام الرقمية). openclaw doctor --fix يمكنه حل إدخالات @username القديمة إلى معرفات. الإدخالات غير الرقمية يتم تجاهلها في وقت المصادقة. مصادقة المجموعة لا تستخدم الاحتياطي لمخزن الاقتران للرسائل الخاصة (2026.2.25+).
• أولوية الحسابات المتعددة:
  • عند تكوين معرفين حسابين أو أكثر، عيّن channels.telegram.defaultAccount (أو أدرج channels.telegram.accounts.default) لجعل التوجيه الافتراضي صريحًا.
  • إذا لم يتم تعيين أي منهما، يتراجع OpenClaw إلى أول معرف حساب مطب