​

Slack

​

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

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

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

قائمة التحقق من manifest والنطاقات

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

​

نموذج الرموز

• botToken + appToken مطلوبان لـ Socket Mode.
• يتطلب وضع HTTP كلاً من botToken + signingSecret.
• يقبل botToken وappToken وsigningSecret وuserToken سلاسل نصية صريحة أو كائنات SecretRef.
• تتجاوز الرموز في الإعداد قيم الرجوع إلى البيئة.
• ينطبق الرجوع إلى متغيرات البيئة SLACK_BOT_TOKEN / SLACK_APP_TOKEN على الحساب الافتراضي فقط.
• userToken (xoxp-...) للإعداد فقط (لا يوجد رجوع إلى البيئة) ويستخدم سلوك القراءة فقط افتراضيًا (userTokenReadOnly: true).
• اختياري: أضف chat:write.customize إذا كنت تريد أن تستخدم الرسائل الصادرة هوية الوكيل النشطة (اسم مستخدم username مخصص وأيقونة). يستخدم icon_emoji صيغة :emoji_name:.

• يتتبع فحص حساب Slack حقول *Source و*Status لكل بيانات اعتماد (botToken وappToken وsigningSecret وuserToken).
• تكون الحالة إحدى القيم: available أو configured_unavailable أو missing.
• تعني configured_unavailable أن الحساب مُعدّ عبر SecretRef أو مصدر أسرار آخر غير مضمن، ولكن مسار الأمر/وقت التشغيل الحالي لم يتمكن من حل القيمة الفعلية.
• في وضع HTTP، يتم تضمين signingSecretStatus؛ وفي Socket Mode، يكون الزوج المطلوب هو botTokenStatus + appTokenStatus.

​

الإجراءات والبوابات

​

التحكم في الوصول والتوجيه

​

سلاسل المحادثات والجلسات وعلامات الرد

• يتم توجيه الرسائل المباشرة كـ direct؛ والقنوات كـ channel؛ وMPIMs كـ group.
• مع الإعداد الافتراضي session.dmScope=main، تُدمج الرسائل المباشرة في Slack ضمن الجلسة الرئيسية للوكيل.
• جلسات القنوات: agent:<agentId>:slack:channel:<channelId>.
• يمكن أن تنشئ ردود السلاسل لاحقات جلسة للسلسلة (:thread:<threadTs>) عند الاقتضاء.
• القيمة الافتراضية لـ channels.slack.thread.historyScope هي thread؛ والقيمة الافتراضية لـ thread.inheritParent هي false.
• يتحكم channels.slack.thread.initialHistoryLimit في عدد رسائل السلسلة الموجودة التي تُجلب عند بدء جلسة سلسلة جديدة (الافتراضي 20؛ اضبطه إلى 0 للتعطيل).

• channels.slack.replyToMode: ‏off|first|all (الافتراضي off)
• channels.slack.replyToModeByChatType: لكل من direct|group|channel
• الرجوع القديم للدردشات المباشرة: channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

تفاعلات التأكيد

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• الرجوع إلى emoji هوية الوكيل (agents.list[].identity.emoji، وإلا ”👀”)

• يتوقع Slack shortcodes (على سبيل المثال "eyes").
• استخدم "" لتعطيل التفاعل لحساب Slack أو على مستوى عام.

​

بث النص

• off: تعطيل بث المعاينة المباشرة.
• partial (الافتراضي): استبدال نص المعاينة بآخر مخرجات جزئية.
• block: إلحاق تحديثات معاينة مجزأة.
• progress: إظهار نص حالة التقدم أثناء التوليد، ثم إرسال النص النهائي.

• يجب أن تكون سلسلة رد متاحة حتى يظهر البث النصي الأصلي. ولا يزال اختيار السلسلة يتبع replyToMode. ومن دونها، تُستخدم معاينة المسودة العادية.
• تعود الوسائط والحمولات غير النصية إلى التسليم العادي.
• إذا فشل البث في منتصف الرد، يعود OpenClaw إلى التسليم العادي للحمولات المتبقية.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• تتم الترحيل التلقائي لـ channels.slack.streamMode (replace | status_final | append) إلى channels.slack.streaming.
• تتم الترحيل التلقائي لـ boolean channels.slack.streaming إلى channels.slack.nativeStreaming.

​

الرجوع إلى تفاعل الكتابة

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

• يتوقع Slack shortcodes (على سبيل المثال "hourglass_flowing_sand").
• التفاعل best-effort وتتم محاولة تنظيفه تلقائيًا بعد اكتمال الرد أو مسار الفشل.

​

الوسائط والتجزئة والتسليم

​

الأوامر وسلوك slash

• الوضع التلقائي للأوامر الأصلية معطّل في Slack (commands.native: "auto" لا يفعّل أوامر Slack الأصلية).
• فعّل معالجات أوامر Slack الأصلية باستخدام channels.slack.commands.native: true (أو الإعداد العام commands.native: true).
• عند تفعيل الأوامر الأصلية، سجّل أوامر slash المطابقة في Slack (أسماء /<command>)، مع استثناء واحد:
  • سجّل /agentstatus لأمر الحالة (يحجز Slack الاسم /status)
• إذا لم تكن الأوامر الأصلية مفعّلة، فيمكنك تشغيل أمر slash واحد مُعدّ عبر channels.slack.slashCommand.
• تتكيف قوائم الوسائط الأصلية للوسائط مع إستراتيجية العرض:
  • حتى 5 خيارات: كتل أزرار
  • من 6 إلى 100 خيار: قائمة اختيار ثابتة
  • أكثر من 100 خيار: اختيار خارجي مع تصفية خيارات غير متزامنة عند توفر معالجات خيارات التفاعلية
  • إذا تجاوزت قيم الخيارات المشفّرة حدود Slack، يعود التدفق إلى الأزرار
• بالنسبة إلى حمولات الخيارات الطويلة، تستخدم قوائم وسائط معاملات أوامر Slash مربع حوار تأكيد قبل إرسال القيمة المحددة.

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

• agent:<agentId>:slack:slash:<userId>

​

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

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

• هذه واجهة مستخدم خاصة بـ Slack. لا تترجم القنوات الأخرى توجيهات Slack Block Kit إلى أنظمة الأزرار الخاصة بها.
• قيم ردود النداء التفاعلية هي رموز opaque مولدة من OpenClaw، وليست قيمًا خام كتبها الوكيل.
• إذا كانت الكتل التفاعلية المولدة ستتجاوز حدود Slack Block Kit، فسيعود OpenClaw إلى الرد النصي الأصلي بدلًا من إرسال حمولة blocks غير صالحة.

​

موافقات exec في Slack

• تستخدم موافقات exec المسار channels.slack.execApprovals.* للتوجيه الأصلي في الرسائل المباشرة/القنوات.
• لا تزال موافقات plugin تُحل عبر سطح أزرار Slack الأصلي نفسه عندما يصل الطلب بالفعل إلى Slack ويكون نوع معرّف الموافقة هو plugin:.
• لا يزال تفويض الموافقين مفروضًا: لا يمكن سوى للمستخدمين المحددين كموافقين الموافقة على الطلبات أو رفضها عبر Slack.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (اختياري؛ يعود إلى commands.ownerAllowFrom عندما يكون ممكنًا)
• channels.slack.execApprovals.target (dm | channel | both، الافتراضي: dm)
• agentFilter, sessionFilter

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

​

الأحداث والسلوك التشغيلي

• تُربط تعديلات الرسائل/حذفها/بث السلاسل بأحداث النظام.
• تُربط أحداث إضافة/إزالة التفاعلات بأحداث النظام.
• تُربط أحداث انضمام/مغادرة الأعضاء، وإنشاء/إعادة تسمية القنوات، وإضافة/إزالة التثبيتات بأحداث النظام.
• يمكن لـ channel_id_changed ترحيل مفاتيح إعداد القنوات عندما يكون configWrites مفعّلًا.
• تُعامل بيانات topic/purpose الخاصة بالقناة كسياق غير موثوق ويمكن حقنها في سياق التوجيه.
• تُصفّى بادئات السلاسل وسياق تهيئة سجل السلسلة الأولي بحسب قوائم السماح المكونة للمرسلين عند الاقتضاء.
• تصدر إجراءات الكتل وتفاعلات النوافذ المنظمة أحداث نظام منظمة باسم Slack interaction: ... مع حقول حمولة غنية:
  • إجراءات الكتل: القيم المحددة، والتسميات، وقيم المحددات، وبيانات workflow_*
  • أحداث view_submission وview_closed الخاصة بالنوافذ مع بيانات القنوات الموجهة ومدخلات النماذج

​

مؤشرات مرجع الإعداد

• مرجع الإعداد - Slack الحقول الأبرز في Slack:
  • الوضع/المصادقة: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • الوصول إلى الرسائل المباشرة: dm.enabled, dmPolicy, allowFrom (القديم: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • مفتاح التوافق: dangerouslyAllowNameMatching (للطوارئ؛ اتركه معطّلًا ما لم تكن بحاجة إليه)
  • الوصول إلى القنوات: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • السلاسل/السجل: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • التسليم: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • العمليات/الميزات: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

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

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

ذو صلة

• الاقتران
• المجموعات
• الأمان
• توجيه القنوات
• استكشاف الأخطاء وإصلاحها
• الإعداد
• أوامر slash