🦞
تكامل القنوات

ربط OpenClaw بـ Slack

أضف OpenClaw إلى مساحة عمل Slack الخاصة بك. احصل على مساعدة الذكاء الاصطناعي في القنوات أو المحادثات أو الرسائل الخاصة مع دعم أوامر السلاش.

💼 لماذا تستخدم Slack؟
  • اتصال WebSocketمراسلة فورية عبر Slack Bot API + وضع Socket
  • أوامر السلاشواجهة أمر /clawd الأصلية
  • دعم المحادثاتحافظ على تنظيم المحادثات مع سياق السجل
  • تنسيق غنيردود منسقة مع ردود الفعل والتثبيت
  • وصول مرنالرسائل الخاصة والقنوات العامة والقنوات الخاصة
المتطلبات
  • رمز بوت Slackيبدأ بـ xoxb-...
  • رمز تطبيق Slackيبدأ بـ xapp-... (لوضع Socket)
  • تطبيق Slackمع نطاقات OAuth المناسبة مكوّنة

خطوات الإعداد

1

إنشاء تطبيق Slack

اذهب إلى بوابة Slack API وأنشئ تطبيقاً جديداً:

  • • قم بزيارة api.slack.com/apps
  • • انقر على "Create New App"
  • • اختر "From scratch"
  • • سمّه (مثل: "OpenClaw") واختر مساحة عملك
2

إضافة نطاقات رمز البوت

كوّن صلاحيات OAuth للبوت الخاص بك:

  • • اذهب إلى "OAuth & Permissions" في الشريط الجانبي
  • • تحت "Bot Token Scopes"، أضف:
  • - app_mentions:read — قراءة الإشارات
  • - channels:history — عرض رسائل القناة
  • - channels:read — عرض معلومات القناة
  • - chat:write — إرسال الرسائل
  • - im:history — عرض سجل الرسائل الخاصة
  • - im:read — عرض معلومات الرسائل الخاصة
  • - im:write — بدء محادثات خاصة
  • - reactions:write — إضافة ردود الفعل
  • - users:read — عرض معلومات المستخدم
3

تفعيل وضع Socket

وضع Socket يسمح بالاتصال الفوري بدون رابط عام:

  • • اذهب إلى "Socket Mode" في الشريط الجانبي
  • • فعّل "Enable Socket Mode"
  • • أنشئ رمز مستوى التطبيق بنطاق connections:write
  • • انسخ الرمز (يبدأ بـ xapp-...)
4

تثبيت التطبيق في مساحة العمل

ثبّت التطبيق واحصل على رمز البوت:

  • • اذهب إلى "Install App" في الشريط الجانبي
  • • انقر على "Install to Workspace"
  • • وافق على الصلاحيات المطلوبة
  • • انسخ رمز OAuth لمستخدم البوت (يبدأ بـ xoxb-...)
5

تكوين OpenClaw

أضف تكوين Slack إلى ملف openclaw.json:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}
6

دعوة البوت للقنوات

أضف البوت إلى القنوات التي تريده أن يستجيب فيها:

  • • افتح القناة في Slack
  • • اكتب /invite @OpenClaw
  • • أو انقر على اسم القناة -> التكاملات -> إضافة تطبيقات
  • • أعد تشغيل OpenClaw بـ openclaw restart واختبر بالإشارة للبوت.
الميزات

دعم المحادثات

يحافظ على سياق المحادثة داخل المحادثات مع نطاق سجل قابل للتكوين.

ردود الفعل التعبيرية

يمكن للبوت إضافة ردود فعل للإقرار بالرسائل أو الإشارة للحالة.

تثبيت الرسائل

ثبّت الردود المهمة للرجوع إليها بسهولة لاحقاً.

أوامر السلاش

استخدم /clawd لاستعلامات الذكاء الاصطناعي السريعة من أي مكان.

معلومات الأعضاء

ابحث عن معلومات أعضاء مساحة العمل عند الحاجة.

دعم الرسائل الخاصة

محادثات خاصة فردية مع البوت.

التكوين المتقدم

جميع خيارات التكوين لتكامل Slack:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["U123", "U456"]
      },
      "channels": {
        "#general": {
          "allow": true,
          "requireMention": true,
          "users": ["U123"]
        }
      },
      "historyLimit": 50,
      "slashCommand": {
        "enabled": true,
        "name": "clawd"
      },
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true
      }
    }
  }
}
  • dm.enabledالسماح بالرسائل المباشرة للبوت
  • dm.policyسياسة الوصول للرسائل الخاصة ("pairing" أو "open")
  • dm.allowFromمصفوفة معرّفات المستخدمين المسموح لهم بإرسال رسائل خاصة
  • channelsكائن تكوين لكل قناة
  • requireMentionالرد فقط عند الإشارة @
  • historyLimitعدد الرسائل لتضمينها كسياق
  • slashCommandتكوين إعدادات أوامر السلاش
  • actionsتفعيل/تعطيل ردود الفعل والرسائل والتثبيت
سياسات القنوات

وضع القائمة المسموحة

الرد فقط في القنوات المكوّنة صراحة. الأفضل للبيئات المحكومة.

الوضع المفتوح

الرد في جميع القنوات التي دُعي إليها البوت. استخدم requireMention للتحكم في الردود.

كيفية الحصول على معرّفات مستخدمي Slack

من الملف الشخصي:

انقر على اسم المستخدم -> عرض الملف الشخصي -> انقر على النقاط الثلاث (...) -> نسخ معرّف العضو

من إدارة Slack:

إعدادات مساحة العمل -> إدارة الأعضاء -> تصدير قائمة الأعضاء كـ CSV

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

البوت لا يستجيب في القنوات؟

تأكد من دعوة البوت للقناة وأنه يملك النطاقات الصحيحة. تحقق إذا كان requireMention مفعّلاً.

أخطاء اتصال وضع Socket؟

تحقق من أن رمز التطبيق (xapp-...) صحيح ويملك نطاق connections:write.

أمر السلاش لا يظهر؟

اذهب إلى "Slash Commands" في إعدادات تطبيق Slack وأنشئ الأمر يدوياً، موجهاً إياه لوضع Socket.

أخطاء رفض الصلاحية؟

أعد تثبيت التطبيق في مساحة عملك بعد إضافة نطاقات جديدة. بعض تغييرات النطاق تتطلب إعادة التثبيت.

تم ربط Slack!

الآن قم بتكوين المزيد من القنوات أو عزّز البوت الخاص بك بمهارات مخصصة.