المتطلبات الأساسية
- مساحة عمل Slack تمتلك فيها صلاحيات المسؤول
- مثيل Claw (أنشئ واحداً هنا)
دليل الإعداد
إنشاء تطبيق Slack
- انتقل إلى Slack API وانقر على Create New App
- اختر From scratch
- أدخل اسماً للتطبيق (مثلاً، “AI Assistant”) وحدد مساحة العمل الخاصة بك
- انقر على Create App
تفعيل Socket Mode
- في الشريط الجانبي الأيسر، انتقل إلى Socket Mode
- قم بتبديل Enable Socket Mode إلى وضع التشغيل (ON)
- امنح الـ token اسماً (مثلاً، “claw-socket”) وانقر على Generate
- انسخ الـ App-Level Token (يبدأ بـ
xapp-) — ستحتاج إلى هذا
تكوين أذونات البوت
- انتقل إلى OAuth & Permissions في الشريط الجانبي
- ضمن Bot Token Scopes، أضف هذه النطاقات (scopes):
chat:write— إرسال الرسائلim:history— قراءة سجل الرسائل المباشرة (DM)im:read— عرض الرسائل المباشرة (DMs)im:write— بدء رسائل مباشرة (DMs)app_mentions:read— اكتشاف الإشارات (@mentions)
- انقر على Install to Workspace في الأعلى
- قم بتفويض التطبيق
- انسخ الـ Bot User OAuth Token (يبدأ بـ
xoxb-)
تفعيل الأحداث (Events)
- انتقل إلى Event Subscriptions في الشريط الجانبي
- قم بتبديل Enable Events إلى وضع التشغيل (ON)
- ضمن Subscribe to bot events، أضف:
message.im— الرسائل في الـ DMsapp_mention— الإشارات (@mentions) في القنوات
- انقر على Save Changes
التكوين في لوحة تحكم LemonData
- انتقل إلى لوحة تحكم Claw الخاصة بك
- انقر على أيقونة الإعدادات في المثيل الخاص بك
- افتح علامة تبويب IM Integrations
- قم بتوسيع قسم Slack
- قم بلصق الـ App Token (
xapp-...) والـ Bot Token (xoxb-...) - انقر على Save
التحكم في الوصول
إعدادات المجموعة
قم بتكوين الوصول إلى القنوات في علامة تبويب IM Integrations في لوحة التحكم الخاصة بك:| الإعداد | الخيارات | الوصف |
|---|---|---|
| Group Policy | مفتوح (افتراضي) / Allowlist / معطل | يتحكم في القنوات التي يستجيب فيها البوت |
| Require @mention | تشغيل / إيقاف | يستجيب البوت فقط عند الإشارة إليه (@mentioned) |
| Group IDs | قائمة بمعرفات القنوات | التقييد بقنوات محددة (فارغ = جميع القنوات) |
| Group Allowed Users | قائمة بمعرفات المستخدمين | يمكن لهؤلاء المستخدمين فقط تفعيل البوت (وضع allowlist) |
استكشاف الأخطاء وإصلاحها
البوت لا يستجيب للرسائل المباشرة (DMs)
البوت لا يستجيب للرسائل المباشرة (DMs)
- تأكد من صحة كلا الـ tokens (يبدأ App Token بـ
xapp-و Bot Token بـxoxb-) - تحقق من الاشتراك في حدث
message.im - تأكد من تثبيت التطبيق في مساحة العمل الخاصة بك
البوت لا يستجيب للإشارات (@mentions)
البوت لا يستجيب للإشارات (@mentions)
- تحقق من تكوين نطاق
app_mentions:readوحدثapp_mention - يجب دعوة البوت إلى القناة أولاً (اكتب
/invite @botname)
خطأ 'not_allowed_token_type'
خطأ 'not_allowed_token_type'
- تأكد من استخدام App-Level Token (
xapp-) في حقل App Token، وليس Bot Token - يتم وضع الـ Bot Token (
xoxb-) في حقل Bot Token