Slack

يغطي دعم Slack الرسائل المباشرة والقنوات عبر تكاملات تطبيق Slack. وسيلة النقل الافتراضية هي Socket Mode؛ كما تُدعَم عناوين URL لطلبات HTTP. أما وضع الترحيل فهو مخصص لعمليات النشر المُدارة التي يتولى فيها موجّه موثوق استقبال حركة Slack الواردة.

اختيار وسيلة النقل

يوفر Socket Mode وعناوين URL لطلبات HTTP تكافؤًا في الميزات للمراسلة وأوامر الشرطة المائلة وApp Home والتفاعلات. اختر وفقًا لبنية النشر، لا وفقًا للميزات.

وضع الترحيل

يفصل وضع الترحيل استقبال حركة Slack الواردة عن Gateway الخاص بـ OpenClaw. يتولى موجّه موثوق اتصال Slack Socket Mode الوحيد، ويختار Gateway وجهة، ويمرر حدثًا محدد النوع عبر websocket موثَّق. ويظل Gateway يستخدم رمز البوت الخاص به لاستدعاءات Slack Web API الصادرة.

{  channels: {    slack: {      mode: "relay",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      relay: {        url: "wss://router.example.com/gateway/ws",        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },        gatewayId: "team-gateway",      },    },  },}

يجب أن يستخدم عنوان URL للترحيل wss:// ما لم يكن يستهدف localhost. تعامل مع رمز الحامل وجدول مسارات الموجّه بوصفهما جزءًا من حدود تخويل Slack: تدخل الأحداث الموجّهة إلى معالج رسائل Slack المعتاد كتفعيلات مخوّلة. يمكن أن يضبط slack_identity المقدم من الموجّه في إطار websocket من نوع hello اسم المستخدم والأيقونة الافتراضيين للإرسال؛ وتظل الأولوية لهوية صريحة يقدمها المستدعي. يعيد اتصال الترحيل الاتصال باستخدام توقيت التراجع المتزايد المحدود نفسه المستخدم في Socket Mode، ويمسح الهوية المقدمة من الموجّه كلما انقطع الاتصال.

عمليات التثبيت على مستوى مؤسسة Enterprise Grid

يمكن لحساب Slack واحد استقبال الرسائل من كل مساحة عمل يشملها تثبيت على مستوى مؤسسة Enterprise Grid. اختر Socket Mode المباشر أو عناوين URL لطلبات HTTP؛ فالوضع المرحّل غير مدعوم لحسابات المؤسسات. لا يفعّل كلا بياني الحد الأدنى من الامتيازات أدناه سوى مسار أحداث V1 من نوع message وapp_mention، والردود الفورية، وتفاعلات الحالة التي يملكها المستمع.

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "موصل Slack لـ OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

اطلب من Enterprise Grid Org Admin أو Org Owner الموافقة على التطبيق وتثبيته على مستوى المؤسسة واختيار مساحات العمل التي يشملها التثبيت. تأكد من توفر التطبيق في كل مساحة عمل مقصودة قبل بدء OpenClaw. أنشئ رمزًا على مستوى التطبيق مع connections:write لـ Socket Mode، ثم انسخ رمز البوت من تثبيت المؤسسة. اضبط الحساب الذي يستخدم رمز البوت المثبّت على مستوى المؤسسة:

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

عناوين URL لطلبات HTTP

استخدم وضع HTTP عندما تكون لدى Gateway نقطة نهاية HTTPS عامة ولا تفتح اتصال Socket Mode. استبدل عنوان URL في المثال بعنوان URL العام webhookPath للـ Gateway (الافتراضي /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "موصل Slack لـ OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

اطلب من Enterprise Grid Org Admin أو Org Owner الموافقة على التطبيق وتثبيته على مستوى المؤسسة واختيار مساحات العمل التي يشملها التثبيت. بعد أن يتحقق Slack من Request URL، انسخ رمز البوت الخاص بتثبيت المؤسسة وBasic Information -> App Credentials -> Signing Secret الخاص بالتطبيق. اضبط حساب المؤسسة باستخدام مسار Request URL نفسه:

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

عند بدء التشغيل، يتحقق OpenClaw من enterpriseOrgInstall باستخدام auth.test الخاص بـ Slack. يفشل بدء التشغيل عند استخدام رمز مثبّت على مستوى المؤسسة من دون العلامة، أو رمز مساحة عمل مع العلامة. يظل Slack مصدر الحقيقة بشأن مساحات العمل التي منحت التثبيت؛ ثم يطبق OpenClaw سياسات القنوات والمستخدمين والرسائل المباشرة والإشارات المضبوطة على كل حدث يتم تسليمه. يرفض Enterprise V1 جميع أحداث message وapp_mention التي أنشأها البوت قبل التوجيه، بصرف النظر عن allowBots، لأن عمليات التثبيت على مستوى المؤسسة لا توفر هوية بوت مستقرة مؤهلة بمساحة العمل لمنع الحلقات.

يقتصر دعم المؤسسات عمدًا على أحداث message وapp_mention عبر Socket Mode المباشر أو HTTP وردودها الفورية. لا يتوفر للحساب المؤسسي وضع الترحيل، أو أوامر الشرطة المائلة، أو التفاعلات، أو App Home، أو مستمعو أحداث التفاعلات، أو التثبيتات، أو أدوات إجراءات Slack، أو الموافقات الأصلية في Slack، أو الارتباطات، أو التسليم في قائمة انتظار أو المجدول، أو عمليات الإرسال الاستباقية. تُدعَم تفاعلات الإقرار والكتابة والحالة الصادرة عبر عميل Slack الذي يملكه المستمع، وتتطلب reactions:write؛ بينما تظل إشعارات التفاعلات الواردة وأدوات إجراءات التفاعلات غير متاحة.

تعيد الردود الفورية استخدام سلوك التسليم القياسي في Slack للمقاطع، والوسائط، والبيانات الوصفية، والرجوع الاحتياطي للهوية، ومعاينات الروابط، وإيصالات الاستلام، ولكن فقط ما دام العميل الذي يملكه المستمع بعد التحقق منه ضمن دورة الحدث النشطة. يُقسَّم صف الإرسال في الذاكرة وسجلات المشاركة في سلاسل المحادثات بحسب مساحة عمل ذلك الحدث؛ ولا يُسلسَل العميل نفسه أو يُحفَظ مطلقًا.

يجب أن تستخدم مفاتيح سياسة القنوات وإدخالات dm.groupChannels معرّفات قنوات Slack الثابتة الخام أو صيغة channel:<id>. يطبّع OpenClaw كلتا الصيغتين إلى معرّف القناة الخام من أجل المطابقة في وقت التشغيل؛ وتتسبب البادئات slack: وgroup: وmpim: في فشل بدء التشغيل. يجب أن تستخدم إدخالات سياسة المستخدمين معرّفات مستخدمي Slack الثابتة؛ وتتسبب الأسماء والأسماء المختصرة وأسماء العرض وعناوين البريد الإلكتروني في فشل بدء التشغيل. يجب أن تستخدم المعرّفات بادئة Slack الأساسية بالأحرف الكبيرة ومتنها (على سبيل المثال، C0123456789 أو U0123456789)؛ وتتسبب الأحرف الصغيرة والمعرّفات القصيرة المشابهة في فشل بدء التشغيل. لا يمكن لحسابات المؤسسة تمكين dangerouslyAllowNameMatching. يمكن لحسابات المؤسسة تعيين mentionPatterns.mode العام، لكن mentionPatterns.allowIn و mentionPatterns.denyIn يتسببان في فشل بدء التشغيل لأن معرّفات قنوات Slack المجرّدة غير مؤهلة بمساحة العمل ويمكن إعادة استخدامها عبر مساحات العمل. تحتفظ عمليات التثبيت في مساحات العمل بسلوك نمط الإشارة المحدد النطاق الحالي. تحصل كل مساحة عمل مقبولة على هوية منفصلة للتوجيه والجلسة والنص المنسوخ وإزالة التكرار والسجل وذاكرة التخزين المؤقت، حتى عندما تتداخل معرّفات Slack. ضمن تدفق message، تُدعَم رسائل المستخدمين العادية وأحداث file_share التي أنشأها المستخدمون؛ وتُرفض الأنواع الفرعية الأخرى للرسائل قبل التفويض أو معالجة أحداث النظام.

يجب إما تعطيل الرسائل المباشرة للمؤسسة (dm.enabled=false أو dmPolicy="disabled") أو فتحها صراحةً باستخدام dmPolicy="open" و قيمة allowFrom فعالة للحساب تحتوي على القيمة الحرفية "*". تؤدي قائمة سماح فارغة أو معرّفات خاصة بمستخدمين من دون "*" إلى فشل بدء التشغيل. يُرفض الاقتران وقوائم السماح للرسائل المباشرة لكل مستخدم لأن معرّفات مستخدمي Slack غير مؤهلة بمساحة العمل في مخازن التفويض تلك. يستمر تطبيق سياسة القناة والمرسل على رسائل القنوات.

التثبيت

openclaw plugins install @openclaw/slack

يسجّل plugins install الـ Plugin ويمكّنه. ولا يفعل شيئًا حتى تهيئ تطبيق Slack وإعدادات القناة أدناه. راجع Plugins للاطلاع على القواعد العامة لتثبيت الـ Plugin.

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

تنشئ ملفات البيان في هذا القسم عملية تثبيت محددة النطاق بمساحة العمل. بالنسبة إلى عملية تثبيت على مستوى مؤسسة Enterprise Grid، استخدم بدلًا من ذلك ملف البيان وسير العمل على مستوى المؤسسة المخصصين.

{"display_information": {"name": "OpenClaw","description": "موصل Slack لـ OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.","suggested_prompts": [{ "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },{"title": "تلخيص هذه القناة","message": "لخّص النشاط الأخير في هذه القناة."},{ "title": "صياغة رد", "message": "ساعدني في صياغة رد." }]},"slash_commands": [{"command": "/openclaw","description": "إرسال رسالة إلى 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","usergroups:read","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]}}}

{"display_information": {"name": "OpenClaw","description": "موصل Slack لـ OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.","suggested_prompts": [{ "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },{"title": "تلخيص هذه القناة","message": "لخّص النشاط الأخير في هذه القناة."},{ "title": "صياغة رد", "message": "ساعدني في صياغة رد." }]},"slash_commands": [{"command": "/openclaw","description": "إرسال رسالة إلى OpenClaw","should_escape": false}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > slack.socket.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "socket",appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "موصل Slack لـ OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.","suggested_prompts": [{ "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },{"title": "تلخيص هذه القناة","message": "لخّص النشاط الأخير في هذه القناة."},{ "title": "صياغة رد", "message": "ساعدني في صياغة رد." }]},"slash_commands": [{"command": "/openclaw","description": "إرسال رسالة إلى OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"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","usergroups:read","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","channel_rename","member_joined_channel","member_left_channel","message.channels","message.groups","message.im","message.mpim","pin_added","pin_removed","reaction_added","reaction_removed"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

{"display_information": {"name": "OpenClaw","description": "موصل Slack لـ OpenClaw"},"features": {"bot_user": { "display_name": "OpenClaw", "always_online": true },"app_home": {"home_tab_enabled": true,"messages_tab_enabled": true,"messages_tab_read_only_enabled": false},"assistant_view": {"assistant_description": "يربط OpenClaw سلاسل مساعد Slack بوكلاء OpenClaw.","suggested_prompts": [{ "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },{"title": "لخّص هذه القناة","message": "لخّص النشاط الأخير في هذه القناة."},{ "title": "صياغة رد", "message": "ساعدني في صياغة رد." }]},"slash_commands": [{"command": "/openclaw","description": "إرسال رسالة إلى OpenClaw","should_escape": false,"url": "https://gateway-host.example.com/slack/events"}]},"oauth_config": {"scopes": {"bot": ["app_mentions:read","assistant:write","channels:history","channels:read","chat:write","commands","groups:history","groups:read","im:history","im:read","im:write","users:read"]}},"settings": {"event_subscriptions": {"request_url": "https://gateway-host.example.com/slack/events","bot_events": ["app_home_opened","app_mention","assistant_thread_context_changed","assistant_thread_started","message.channels","message.groups","message.im"]},"interactivity": {"is_enabled": true,"request_url": "https://gateway-host.example.com/slack/events","message_menu_options_url": "https://gateway-host.example.com/slack/events"}}}

export SLACK_BOT_TOKEN=slack-bot-token-exampleexport SLACK_SIGNING_SECRET=...cat > slack.http.patch.json5 <<'JSON5'{channels: {slack: {enabled: true,mode: "http",botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },webhookPath: "/slack/events",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

ضبط نقل وضع Socket

يضبط OpenClaw مهلة انتظار pong لعميل Slack SDK على 15 ثانية افتراضيًا في وضع Socket. لا تتجاوز إعدادات النقل إلا عند الحاجة إلى ضبط خاص بمساحة العمل أو المضيف:

{  channels: {    slack: {      mode: "socket",      socketMode: {        clientPingTimeout: 20000,        serverPingTimeout: 30000,        pingPongLoggingEnabled: false,      },    },  },}

استخدم هذا فقط لمساحات العمل في وضع Socket التي تسجّل انتهاء مهلات pong أو server-ping لاتصال Slack عبر websocket، أو التي تعمل على مضيفين يعانون من تجويع معروف لحلقة الأحداث. يمثّل clientPingTimeout مدة انتظار pong بعد أن يرسل SDK اختبار اتصال من العميل؛ ويمثّل serverPingTimeout مدة انتظار اختبارات الاتصال من خادم Slack. تظل رسائل التطبيق وأحداثه حالةً للتطبيق، وليست إشارات لحيوية النقل.

ملاحظات:

• يتم تجاهل socketMode في وضع HTTP Request URL.
• تنطبق إعدادات channels.slack.socketMode الأساسية على جميع حسابات Slack ما لم يتم تجاوزها. تستخدم التجاوزات الخاصة بكل حساب channels.slack.accounts.<accountId>.socketMode؛ ونظرًا إلى أن هذا تجاوز كائن، فأدرج كل حقل من حقول ضبط Socket الذي تريده لذلك الحساب.
• لا يملك قيمة OpenClaw افتراضية (15000) سوى clientPingTimeout. لا يتم تمرير serverPingTimeout وpingPongLoggingEnabled إلى Slack SDK إلا عند تهيئتهما.
• يبدأ التراجع بين محاولات إعادة تشغيل وضع Socket من نحو 2 ثانية ويبلغ حده الأقصى عند نحو 30 ثانية. تُعاد محاولة إخفاقات البدء وانتظار البدء وانقطاع الاتصال القابلة للاسترداد حتى تتوقف القناة. أما أخطاء الحساب وبيانات الاعتماد الدائمة، مثل المصادقة غير الصالحة أو الرموز المميزة الملغاة أو النطاقات المفقودة، فتفشل سريعًا بدلًا من إعادة المحاولة إلى الأبد.

قائمة التحقق من البيان والنطاقات

بيان تطبيق Slack الأساسي هو نفسه لوضع Socket وعناوين URL لطلبات HTTP. لا يختلف سوى مقطع settings (وurl لأمر الشرطة المائلة).

البيان الأساسي (وضع Socket افتراضيًا):

{  "display_information": {    "name": "OpenClaw",    "description": "موصل Slack لـ OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true },    "app_home": {      "home_tab_enabled": true,      "messages_tab_enabled": true,      "messages_tab_read_only_enabled": false    },    "assistant_view": {      "assistant_description": "يربط OpenClaw سلاسل مساعد Slack بوكلاء OpenClaw.",      "suggested_prompts": [        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },        {          "title": "لخّص هذه القناة",          "message": "لخّص النشاط الأخير في هذه القناة."        },        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "إرسال رسالة إلى 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",        "usergroups:read",        "users:read"      ]    }  },  "settings": {    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

بالنسبة إلى وضع عناوين URL لطلبات HTTP، استبدل settings بنسخة HTTP وأضف url إلى كل أمر شرطة مائلة. يلزم عنوان URL عام:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "إرسال رسالة إلى OpenClaw",        "should_escape": false,        "url": "https://gateway-host.example.com/slack/events"      }    ]  },  "settings": {    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_home_opened",        "app_mention",        "assistant_thread_context_changed",        "assistant_thread_started",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    },    "interactivity": {      "is_enabled": true,      "request_url": "https://gateway-host.example.com/slack/events",      "message_menu_options_url": "https://gateway-host.example.com/slack/events"    }  }}

إعدادات إضافية للبيان

اعرض ميزات مختلفة توسّع الإعدادات الافتراضية المذكورة أعلاه.

يفعّل البيان الافتراضي علامة تبويب Home في Slack App Home ويشترك في app_home_opened. عندما يفتح عضو في مساحة العمل علامة التبويب Home، ينشر OpenClaw عرض Home افتراضيًا آمنًا باستخدام views.publish؛ ولا يتم تضمين أي حمولة محادثة أو تهيئة خاصة. عند تفعيل وضع أمر الشرطة المائلة الواحد، يستخدم تلميح الأمر channels.slack.slashCommand.name؛ أما عمليات التثبيت التي تستخدم أوامر أصلية أو لا تستخدم أوامر شرطة مائلة فتحذف ذلك التلميح. تظل علامة التبويب Messages مفعّلة لرسائل Slack المباشرة. يفعّل البيان أيضًا سلاسل مساعد Slack باستخدام features.assistant_view وassistant:write وassistant_thread_started وassistant_thread_context_changed؛ وتُوجَّه سلاسل المساعد إلى جلسات سلاسل OpenClaw الخاصة بها، مع إبقاء سياق السلسلة الذي يوفّره Slack متاحًا للوكيل.

{"slash_commands": [{"command": "/new","description": "بدء جلسة جديدة","usage_hint": "[model]"},{"command": "/reset","description": "إعادة تعيين الجلسة الحالية"},{"command": "/compact","description": "ضغط سياق الجلسة","usage_hint": "[instructions]"},{"command": "/stop","description": "إيقاف التشغيل الحالي"},{"command": "/session","description": "إدارة انتهاء صلاحية ربط سلسلة المحادثة","usage_hint": "خمول <duration|off> أو أقصى عمر <duration|off>"},{"command": "/think","description": "تعيين مستوى التفكير","usage_hint": "<level>"},{"command": "/verbose","description": "تبديل الإخراج المفصّل","usage_hint": "on|off|full"},{"command": "/fast","description": "عرض الوضع السريع أو تعيينه","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "تبديل ظهور الاستدلال","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "تبديل الوضع ذي الصلاحيات المرتفعة","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "عرض الإعدادات الافتراضية للتنفيذ أو تعيينها","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "الموافقة على طلبات الموافقة المعلّقة أو رفضها","usage_hint": "<id> <decision>"},{"command": "/model","description": "عرض النموذج أو تعيينه","usage_hint": "[name|#|status]"},{"command": "/models","description": "إدراج الموفّرين/النماذج","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "عرض ملخص المساعدة القصير"},{"command": "/commands","description": "عرض دليل الأوامر المُنشأ"},{"command": "/tools","description": "عرض ما يمكن للوكيل الحالي استخدامه الآن","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "عرض حالة وقت التشغيل، بما في ذلك استخدام الموفّر/الحصة عند توفرهما"},{"command": "/tasks","description": "إدراج مهام الخلفية النشطة/الحديثة للجلسة الحالية"},{"command": "/context","description": "شرح كيفية تجميع السياق","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "عرض هوية المُرسِل الخاصة بك"},{"command": "/skill","description": "تشغيل مهارة بالاسم","usage_hint": "<name> [input]"},{"command": "/btw","description": "طرح سؤال جانبي دون تغيير سياق الجلسة","usage_hint": "<question>"},{"command": "/side","description": "طرح سؤال جانبي دون تغيير سياق الجلسة","usage_hint": "<question>"},{"command": "/usage","description": "التحكم في تذييل الاستخدام أو عرض ملخص التكلفة","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "بدء جلسة جديدة","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "عرض ملخص المساعدة القصير","url": "https://gateway-host.example.com/slack/events"}]}

نموذج الرموز

• botToken + appToken مطلوبان لـ Socket Mode.
• يتطلب وضع HTTP ‏botToken + signingSecret.
• يتطلب وضع الترحيل botToken بالإضافة إلى relay.url وrelay.authToken وrelay.gatewayId؛ ولا يستخدم رمز تطبيق أو سر توقيع.
• تقبل botToken وappToken وsigningSecret وrelay.authToken وuserToken سلاسل نصية عادية أو كائنات SecretRef.
• تتجاوز رموز الإعدادات القيم الاحتياطية لمتغيرات البيئة.
• تنطبق القيم الاحتياطية لمتغيرات البيئة SLACK_BOT_TOKEN وSLACK_APP_TOKEN وSLACK_USER_TOKEN كلٌّ منها على الحساب الافتراضي فقط.
• تكون القيمة الافتراضية لـ userToken سلوك القراءة فقط (userTokenReadOnly: true).

سلوك لقطة الحالة:

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

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

تتحكم channels.slack.actions.* في إجراءات Slack.

مجموعات الإجراءات المتاحة في أدوات Slack الحالية:

تتضمن إجراءات رسائل Slack الحالية send وupload-file وdownload-file وread وedit وdelete وpin وunpin وlist-pins وmember-info وemoji-list. تقبل download-file معرّفات ملفات Slack المعروضة في العناصر النائبة للملفات الواردة، وتعيد معاينات للصور أو بيانات وصفية للملف المحلي للأنواع الأخرى من الملفات.

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

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

• تُوجَّه الرسائل المباشرة بصيغة direct؛ والقنوات بصيغة channel؛ والرسائل المباشرة الجماعية بصيغة group.
• تقبل ارتباطات مسارات Slack معرّفات النظراء الأولية، بالإضافة إلى صيغ أهداف Slack مثل channel:C12345678 وuser:U12345678 و<@U12345678>.
• مع القيمة الافتراضية session.dmScope=main، تُدمج رسائل Slack المباشرة في جلسة الوكيل الرئيسية.
• جلسات القنوات: agent:<agentId>:slack:channel:<channelId>.
• تظل رسائل القناة العادية ذات المستوى الأعلى في جلسة كل قناة، حتى عندما تكون replyToMode بقيمة غير off.
• تستخدم ردود سلاسل محادثات Slack قيمة thread_ts الأصلية في Slack للواحق الجلسات (:thread:<threadTs>)، حتى عند تعطيل تسلسل الردود الصادرة باستخدام replyToMode="off".
• يُدخل OpenClaw جذر قناة مؤهلًا ذا مستوى أعلى في agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> عندما يُتوقع أن يبدأ ذلك الجذر سلسلة محادثات مرئية في Slack، لكي يتشارك الجذر وردود السلسلة اللاحقة جلسة OpenClaw واحدة. ينطبق هذا على أحداث app_mention، والمطابقات الصريحة لإشارة البوت أو نمط الإشارة المضبوط، وقنوات requireMention: false ذات replyToMode بقيمة غير off.
• القيمة الافتراضية لـ channels.slack.thread.historyScope هي thread؛ والقيمة الافتراضية لـ thread.inheritParent هي false.
• يتحكم channels.slack.thread.initialHistoryLimit في عدد رسائل سلسلة المحادثات الحالية التي تُجلب عند بدء جلسة سلسلة جديدة (الافتراضي 20؛ اضبطه على 0 للتعطيل).
• channels.slack.thread.requireExplicitMention (الافتراضي false): عندما تكون القيمة true، تُمنع إشارات سلسلة المحادثات الضمنية لكي يستجيب البوت فقط لإشارات @bot الصريحة داخل السلاسل، حتى عندما يكون البوت قد شارك بالفعل في السلسلة. من دون ذلك، تتجاوز الردود في سلسلة شارك فيها البوت بوابة requireMention.

عناصر التحكم في تسلسل الردود:

• channels.slack.channels.<id>.replyToMode: تجاوز لكل قناة لرسائل قنوات Slack والقنوات الخاصة
• channels.slack.replyToMode: off|first|all|batched (الافتراضي off)
• channels.slack.replyToModeByChatType: لكل direct|group|channel
• البديل الاحتياطي القديم للمحادثات المباشرة: channels.slack.dm.replyToMode

وسوم الرد اليدوية مدعومة:

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

للردود الصريحة على سلاسل Slack من أداة message، اضبط replyBroadcast: true مع action: "send" وthreadId أو replyTo لطلب أن يبث Slack أيضًا رد السلسلة إلى القناة الأصلية. يُطابق هذا علامة reply_broadcast في chat.postMessage لدى Slack، ولا يُدعم إلا لعمليات إرسال النص أو Block Kit، وليس لرفع الوسائط.

عندما تُنفَّذ استدعاءة أداة message داخل سلسلة Slack وتستهدف القناة نفسها، يرث OpenClaw عادةً سلسلة Slack الحالية وفقًا لـ replyToMode الفعالة للحساب أو نوع المحادثة أو لكل قناة. تستخدم الردود التلقائية واستدعاءات send أو upload-file في القناة نفسها التجاوز ذاته لكل قناة. اضبط topLevel: true على action: "send" أو action: "upload-file" لفرض رسالة جديدة في القناة الأصلية بدلًا من ذلك. تُقبل threadId: null باعتبارها إلغاء الاشتراك نفسه على المستوى الأعلى.

تفاعلات الإقرار

يرسل ackReaction رمزًا تعبيريًا للإقرار بينما يعالج OpenClaw رسالة واردة. ويحدد ackReactionScope متى يُرسل ذلك الرمز فعليًا.

افتراضيًا، يظل الإقرار ثابتًا بينما تعرض حالة سلسلة المساعد الأصلية في Slack التقدم باستخدام رسائل تحميل متناوبة. اضبط messages.statusReactions.enabled: true للاشتراك بدلًا من ذلك في دورة حياة تفاعلات الانتظار/التفكير/الأداة/الاكتمال/الخطأ.

الرمز التعبيري (ackReaction)

ترتيب الحل:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• البديل الاحتياطي للرمز التعبيري لهوية الوكيل (agents.list[].identity.emoji، وإلا "eyes" / 👀)

ملاحظات:

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

النطاق (messages.ackReactionScope)

يقرأ موفر Slack النطاق من messages.ackReactionScope (الافتراضي "group-mentions"). لا يوجد حاليًا تجاوز على مستوى حساب Slack أو قناة Slack؛ فالقيمة عامة على مستوى Gateway.

القيم:

• "all": التفاعل في الرسائل المباشرة والمجموعات، بما في ذلك أحداث الغرف المحيطة.
• "direct": التفاعل في الرسائل المباشرة فقط.
• "group-all": التفاعل مع كل رسالة جماعية باستثناء أحداث الغرف المحيطة (من دون رسائل مباشرة).
• "group-mentions" (الافتراضي): التفاعل في المجموعات، ولكن فقط عند الإشارة إلى البوت (أو في العناصر القابلة للإشارة الجماعية التي اشتركت). تُستبعد الرسائل المباشرة.
• "off" / "none": عدم التفاعل مطلقًا.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // التفاعل في الرسائل المباشرة والمجموعات  },}

بث النص

يتحكم channels.slack.streaming في سلوك المعاينة المباشرة:

• off: تعطيل بث المعاينة المباشرة.
• partial (الافتراضي): استبدال نص المعاينة بأحدث مخرجات جزئية.
• block: إلحاق تحديثات المعاينة المجزأة.
• progress: عرض نص حالة التقدم أثناء الإنشاء، ثم إرسال النص النهائي.
• streaming.preview.toolProgress: عندما تكون معاينة المسودة نشطة، توجيه تحديثات الأداة/التقدم إلى رسالة المعاينة المعدّلة نفسها (الافتراضي: true). اضبط false للاحتفاظ برسائل منفصلة للأداة/التقدم.
• streaming.preview.commandText / streaming.progress.commandText: اضبطها على status للاحتفاظ بأسطر تقدم الأداة الموجزة مع إخفاء نص الأمر/التنفيذ الأولي (الافتراضي: raw).

إخفاء نص الأمر/التنفيذ الأولي مع الاحتفاظ بأسطر التقدم الموجزة:

{  "channels": {    "slack": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

يتحكم channels.slack.streaming.nativeTransport في بث النص الأصلي في Slack عندما تكون channels.slack.streaming.mode بقيمة partial (الافتراضي: true).

بطاقات مهام التقدم الأصلية في Slack اختيارية لوضع التقدم. اضبط channels.slack.streaming.progress.nativeTaskCards على true مع channels.slack.streaming.mode="progress" لإرسال بطاقة خطة/مهمة أصلية في Slack أثناء تنفيذ العمل، ثم تحديث بطاقة المهمة نفسها عند الاكتمال. من دون هذه العلامة، يحتفظ وضع التقدم بسلوك معاينة المسودة القابل للنقل.

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

استخدام معاينة المسودة بدلًا من بث النص الأصلي في Slack:

{  channels: {    slack: {      streaming: {        mode: "partial",        nativeTransport: false,      },    },  },}

الاشتراك في بطاقات مهام التقدم الأصلية في Slack:

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          nativeTaskCards: true,          render: "rich",        },      },    },  },}

المفاتيح القديمة:

• channels.slack.streamMode (replace | status_final | append) اسم مستعار قديم لـ channels.slack.streaming.mode.
• القيمة المنطقية channels.slack.streaming اسم مستعار قديم لـ channels.slack.streaming.mode وchannels.slack.streaming.nativeTransport.
• القيمتان channels.slack.chunkMode وchannels.slack.nativeStreaming على المستوى الأعلى اسمان مستعاران قديمان لـ channels.slack.streaming.chunkMode وchannels.slack.streaming.nativeTransport.
• لا تُقرأ الأسماء المستعارة القديمة في وقت التشغيل؛ شغّل openclaw doctor --fix لإعادة كتابة إعدادات بث Slack المحفوظة باستخدام المفاتيح القياسية.

البديل الاحتياطي لتفاعل الكتابة

يضيف typingReaction تفاعلًا مؤقتًا إلى رسالة Slack الواردة بينما يعالج OpenClaw ردًا، ثم يزيله عند انتهاء التشغيل. يكون هذا أكثر فائدة خارج ردود السلاسل، التي تستخدم مؤشر حالة افتراضيًا يفيد بأن المستخدم "يكتب...".

ترتيب الحل:

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

ملاحظات:

• يتوقع Slack رموزًا مختصرة (مثل "hourglass_flowing_sand").
• يُنفّذ التفاعل على أساس بذل أفضل جهد، وتُحاول إزالته تلقائيًا بعد اكتمال مسار الرد أو الفشل.

الإدخال الصوتي

للتحدث إلى OpenClaw في Slack حاليًا، أرسل مقطعًا صوتيًا من Slack إلى تطبيق OpenClaw. ميكروفون الإملاء في Slackbot ميزة منفصلة مملوكة لـ Slack، وليس واجهة API للتطبيق.

• يعمل الإملاء الصوتي في Slackbot داخل محادثة Slackbot الخاصة بالمستخدم. يحوّل Slack التسجيل إلى مطالبة في Slackbot، لكنه لا يرسل ملفًا صوتيًا أو حدث إملاء أو مطالبة أو علامة لمصدر الإدخال إلى تطبيقات Slack التابعة لجهات خارجية عبر Events API. لا يمكن لـ Plugin Slack في OpenClaw تمكينه أو استقباله.
• مقاطع Slack الصوتية هي ملفات مخزنة في Slack يمكن نشرها في رسالة خاصة أو قناة أو سلسلة محادثات في OpenClaw. ينزّل OpenClaw المقطع القابل للوصول باستخدام رمز البوت، ويوحّد بيانات MIME الوصفية للمقطع في Slack، ثم يرسله عبر مسار تحويل الصوت إلى نص المشترك. يتضمن بيان التطبيق الموصى به نطاق files:read المطلوب.

تختلف دلالات الخصوصية بين المقاطع الصوتية والإملاء في Slackbot: تخضع المقاطع لسياسة الاحتفاظ بالملفات في Slack وينزّلها OpenClaw لتحويلها إلى نص، بينما يفيد Slack بأن صوت الإملاء لا يُخزَّن.

في قناة تستخدم requireMention: true، يمكن لمقطع صوتي بلا تسمية توضيحية اجتياز البوابة عبر نطق نمط إشارة مُعدّ (agents.list[].groupChat.mentionPatterns، مع الرجوع إلى messages.groupChat.mentionPatterns). يتحقق OpenClaw من صلاحية المرسل قبل تنزيل المقطع أو تحويله إلى نص، ثم لا يقبله إلا إذا طابق النص الناتج النمط. يُتخلّص من النص الاستباقي الفاشل أو غير المطابق مع المقطع المنزّل، ولا يُحتفظ به في سجل القناة. لا يمكن استنتاج هوية @bot الأصلية في Slack من الكلام، لذا يجب إعداد نمط للاسم المنطوق أو تضمين إشارة مكتوبة. إذا فُعّل تكرار النص الناتج، فلا يُرسل التكرار إلا بعد القبول.

الوسائط والتقسيم والتسليم

الأوامر وسلوك أوامر الشرطة المائلة

تظهر أوامر الشرطة المائلة في Slack إما كأمر واحد مُعدّ أو كعدة أوامر أصلية. اضبط channels.slack.slashCommand لتغيير القيم الافتراضية للأوامر:

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

/openclaw /help

تتطلب الأوامر الأصلية إعدادات إضافية للبيان في تطبيق Slack، وتُفعّل باستخدام channels.slack.commands.native: true أو commands.native: true في الإعدادات العامة بدلًا من ذلك.

• الوضع التلقائي للأوامر الأصلية معطّل في Slack، لذلك لا يفعّل commands.native: "auto" أوامر Slack الأصلية.

/help

تُعرض قوائم وسيطات الأوامر الأصلية بإحدى الصور التالية، حسب ترتيب الأولوية:

• من 3 إلى 5 خيارات قصيرة بما يكفي: قائمة تجاوز ("...")
• أكثر من 100 خيار، مع توفر تصفية غير متزامنة للخيارات: تحديد خارجي
• خيار واحد أو خياران، أو أي خيار تكون قيمته المشفرة أطول مما يسمح به عنصر التحديد: كتل أزرار
• خلاف ذلك (من 6 إلى 100 خيار، أو أكثر من 100 دون تصفية غير متزامنة): قائمة تحديد ثابتة، مقسمة إلى 100 خيار لكل قائمة

/think

تستخدم جلسات أوامر الشرطة المائلة مفاتيح معزولة مثل agent:<agentId>:slack:slash:<userId>، وتظل توجّه تنفيذ الأوامر إلى جلسة المحادثة المستهدفة باستخدام CommandTargetSessionKey.

المخططات الأصلية

تعرض كتلة Block Kit العامة data_visualization في Slack مخططات خطية وشريطية ومساحية ودائرية في الرسائل. يربط OpenClaw كتلة presentation chart المحمولة بتلك البنية الأصلية؛ ولا يلزم أي نطاق OAuth إضافي أو رفع ملفات أو عارض صور أو إعداد في Slack بخلاف صلاحية الوصول العادية إلى رسائل chat:write.

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "الإيرادات الفصلية",      "categories": ["الربع الأول", "الربع الثاني"],      "series": [{ "name": "الإيرادات", "values": [120, 145] }],      "xLabel": "الربع"    }  ]}

تُفرض حدود Slack قبل العرض الأصلي:

• العنوان وتسميات المحاور الاختيارية: 50 حرفًا
• المخطط الدائري: من 1 إلى 12 قطاعًا موجبًا
• المخطط الخطي أو الشريطي أو المساحي: من 1 إلى 12 سلسلة ذات أسماء فريدة ومن 1 إلى 20 فئة مشتركة
• تسميات القطاعات والفئات والسلاسل: 20 حرفًا
• يجب أن تحتوي كل سلسلة على قيمة محدودة واحدة لكل فئة؛ ويمكن أن تكون قيم المخططات غير الدائرية سالبة

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

يقبل Slack حاليًا ما يصل إلى كتلتين من data_visualization لكل رسالة. عندما يحتوي العرض على أكثر من مخططين صالحين، يحافظ OpenClaw على ترتيبها ويتابع العرض الأصلي في رسائل متابعة، بما لا يزيد على مخططين في كل رسالة.

يوثّق إطلاق المطورين في Slack الكتلة باعتبارها ميزة Block Kit موجهة للتطبيقات، ولا ينشر أي قيد على الخطط المدفوعة. تنطبق صياغة أهلية Business+/Enterprise على إنشاء المخططات التلقائي بالذكاء الاصطناعي في Slackbot، وهو أمر منفصل عن إرسال تطبيق لمخطط Block Kit منظم مسبقًا. المخططات كتل مخصصة للرسائل فقط، وليست محتوى في App Home أو النوافذ المشروطة أو Canvas.

الجداول الأصلية

تعرض كتلة Block Kit الحالية data_table في Slack صفوفًا وأعمدة منظمة داخل الرسائل. يربط OpenClaw كتلة presentation table المحمولة والصريحة بـ data_table؛ ولا يستخدم كتلة Slack القديمة table. لا يلزم أي نطاق OAuth إضافي أو إعداد في Slack بخلاف صلاحية الوصول العادية إلى رسائل chat:write.

{  "blocks": [    {      "type": "table",      "caption": "مسار المبيعات المفتوح",      "headers": ["الحساب", "المرحلة", "الإيراد السنوي المتكرر"],      "rows": [        ["Acme", "تم الفوز", 125000],        ["Globex", "قيد المراجعة", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

يربط OpenClaw خلايا العناوين والسلاسل النصية بخلايا raw_text في Slack. وتُربط الخلايا الرقمية بـ raw_number، مع الحفاظ على القيمة الرقمية المحدودة للفرز والتصفية الأصليين. يحدد rowHeaderColumnIndex، عند وجوده، ذلك العمود ذي الفهرسة الصفرية بوصفه عناوين صفوف Slack.

تُفرض حدود data_table المنشورة من Slack قبل العرض الأصلي:

• من 1 إلى 20 عمودًا
• من 1 إلى 100 صف بيانات، بالإضافة إلى صف العنوان
• العدد نفسه من الخلايا في كل صف
• بحد أقصى 10,000 حرف إجمالًا عبر جميع خلايا الجدول في رسالة واحدة

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

يحمل كل جدول أصلي ناتج من عرض محمول أيضًا تمثيلًا نصيًا على المستوى الأعلى لقارئات الشاشة والإشعارات ونسخ الجلسات والعملاء الذين لا يمكنهم عرض الكتلة. تبقى قيم المخططات والجداول الخام حرفية في البديل، فلا تتحول بيانات الخلايا مثل <@U123> إلى إشارة في Slack. إذا رفض Slack كتل المخططات أو الجداول الأصلية باستخدام invalid_blocks، فإن OpenClaw يزيل كل كتل البيانات الأصلية في خطوة استرداد واحدة محدودة، ويحتفظ بالكتل الشقيقة الصالحة مثل الأزرار وعناصر التحديد، ويرسل النص الكامل المرئي للمخططات والجداول مع تعطيل تنسيق Slack. يتتبع تسليم أوامر الشرطة المائلة ميزانية response_url ذات الاستدعاءات الخمسة في Slack طوال الأمر. وقبل كل دفعة ردود، يختار خطة كاملة تناسب الاستدعاءات المتبقية أو يفشل قبل نشر تلك الدفعة.

لا تُرقّى إلى جداول أصلية إلا كتل الجداول الصريحة presentation. تبقى جداول Markdown ذات الأنابيب نصًا كما أُلّفت؛ ولا يخمّن OpenClaw بنية الجدول أو أنواع الخلايا. يمكن للمنتجين الحاليين الموثوقين الذين يستخدمون بنية Slack الأصلية الاستمرار في تمرير الكتل الخام عبر channelData.slack.blocks؛ ويستخرج OpenClaw نصًا بديلًا من خلايا data_table الخام الصالحة، بينما قد تتراجع الكتل المخصصة غير الصحيحة إلى تسميتها التوضيحية أو إلى بديل Block Kit العام. ينبغي أن تستخدم مخرجات الوكلاء وCLI والإضافات المحمولة presentation.

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

يمكن لـ Slack عرض عناصر تحكم تفاعلية في الردود ينشئها الوكلاء، لكن هذه الميزة معطلة افتراضيًا. بالنسبة إلى المخرجات الجديدة من الوكلاء وCLI والإضافات، يُفضّل استخدام أزرار presentation المشتركة أو كتل التحديد. فهي تستخدم مسار تفاعل Slack نفسه، مع إمكانية التراجع أيضًا على القنوات الأخرى.

فعّلها عموميًا:

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

أو فعّلها لحساب Slack واحد فقط:

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

عند تفعيلها، يظل بإمكان الوكلاء إصدار توجيهات رد مهملة خاصة بـ Slack:

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

تُترجم هذه التوجيهات إلى Slack Block Kit، وتوجّه النقرات أو عمليات التحديد عبر مسار أحداث التفاعل الحالي في Slack. احتفظ بها للمطالبات القديمة ولمخارج الطوارئ الخاصة بـ Slack؛ واستخدم العرض المشترك لعناصر التحكم المحمولة الجديدة.

واجهات API الخاصة بمترجم التوجيهات مهملة أيضًا في شيفرة المنتجين الجديدة:

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

استخدم حمولات presentation وbuildSlackPresentationBlocks(...) لعناصر التحكم الجديدة المعروضة في Slack.

ملاحظات:

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

عمليات إرسال النماذج المشروطة المملوكة للـ Plugin

يمكن أيضًا لـ Plugins الخاصة بـ Slack التي تسجّل معالجًا تفاعليًا تلقي أحداث دورة حياة view_submission وview_closed قبل أن ينفّذ OpenClaw عملية Compaction للحمولة ضمن حدث النظام المرئي للوكيل. استخدم أحد أنماط التوجيه التالية عند فتح نموذج مشروط في Slack:

• اضبط callback_id على openclaw:<namespace>:<payload>.
• أو احتفظ بـ callback_id موجود وضع pluginInteractiveData: "<namespace>:<payload>" في private_metadata الخاص بالنموذج المشروط.

يتلقى المعالج ctx.interaction.kind بوصفه view_submission أو view_closed، وinputs بعد تسويته، وكائن stateValues الخام الكامل من Slack. يكفي التوجيه باستخدام معرّف الاستدعاء فقط لاستدعاء معالج الـ Plugin؛ أدرج حقول توجيه المستخدم/الجلسة private_metadata الموجودة في النموذج المشروط عندما ينبغي للنموذج المشروط أيضًا إنشاء حدث نظام مرئي للوكيل. يتلقى الوكيل حدث نظام Slack interaction: ... موجزًا ومنقّحًا. إذا أعاد المعالج systemEvent.summary أو systemEvent.reference أو systemEvent.data، فستُدرج هذه الحقول في ذلك الحدث الموجز كي يتمكن الوكيل من الإشارة إلى التخزين المملوك للـ Plugin من دون رؤية حمولة النموذج الكاملة.

الموافقات الأصلية في Slack

يمكن أن يعمل Slack كعميل موافقات أصلي باستخدام الأزرار والتفاعلات، بدلًا من الرجوع إلى واجهة الويب أو الطرفية.

• يمكن عرض موافقات التنفيذ والـ Plugin كمطالبات Slack Block Kit أصلية.
• يظل channels.slack.execApprovals.* إعداد تمكين عميل موافقات التنفيذ الأصلي وتوجيه الرسائل المباشرة/القنوات.
• تستخدم الرسائل المباشرة لموافقة التنفيذ channels.slack.execApprovals.approvers أو commands.ownerAllowFrom.
• تستخدم موافقات الـ Plugin أزرار Slack الأصلية عندما يكون Slack مفعّلًا كعميل موافقات أصلي للجلسة المنشئة، أو عندما يوجّه approvals.plugin إلى جلسة Slack المنشئة أو إلى هدف Slack.
• تستخدم الرسائل المباشرة لموافقة الـ Plugin معتمدي Slack Plugin من channels.slack.allowFrom، أو allowFrom للحساب المسمّى، أو مسار الحساب الافتراضي.
• يظل تفويض المعتمد مفروضًا: لا يمكن للمعتمدين المخوّلين للتنفيذ فقط الموافقة على طلبات الـ Plugin ما لم يكونوا أيضًا من معتمدي الـ Plugin.

يستخدم هذا سطح أزرار الموافقات المشترك نفسه الذي تستخدمه القنوات الأخرى. عندما يكون interactivity مفعّلًا في إعدادات تطبيق Slack، تظهر مطالبات الموافقة كأزرار Block Kit مباشرةً في المحادثة. عند وجود هذه الأزرار، تكون هي تجربة الموافقة الأساسية؛ ولا ينبغي لـ OpenClaw تضمين أمر /approve يدوي إلا عندما تشير نتيجة الأداة إلى أن موافقات الدردشة غير متاحة أو أن الموافقة اليدوية هي المسار الوحيد.

مسار الإعداد:

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

يفعّل Slack موافقات التنفيذ الأصلية تلقائيًا عندما لا يكون enabled مضبوطًا أو يكون "auto"، وعندما يتحدد معتمد تنفيذ واحد على الأقل. يمكن لـ Slack أيضًا معالجة موافقات الـ Plugin الأصلية عبر مسار العميل الأصلي هذا عندما يتحدد معتمدو Slack Plugin ويطابق الطلب مرشحات العميل الأصلي. اضبط enabled: false لتعطيل Slack صراحةً بوصفه عميل موافقات أصليًا. اضبط enabled: true لفرض تشغيل الموافقات الأصلية عند تحديد المعتمدين. لا يؤدي تعطيل موافقات تنفيذ Slack إلى تعطيل تسليم موافقات Slack Plugin الأصلية المفعّل عبر approvals.plugin؛ إذ يستخدم تسليم موافقة الـ Plugin معتمدي Slack Plugin بدلًا من ذلك.

السلوك الافتراضي عند عدم وجود إعداد صريح لموافقة تنفيذ Slack:

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

لا يلزم إعداد Slack الأصلي الصريح إلا عندما تريد تجاوز المعتمدين، أو إضافة مرشحات، أو الاشتراك في التسليم إلى دردشة المنشأ:

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

إعادة توجيه approvals.exec المشتركة منفصلة. استخدمها فقط عندما يجب أيضًا توجيه مطالبات موافقة التنفيذ إلى دردشات أخرى أو أهداف صريحة خارج النطاق. كما أن إعادة توجيه approvals.plugin المشتركة منفصلة؛ ولا يمنع التسليم الأصلي في Slack هذا المسار الاحتياطي إلا عندما يستطيع Slack معالجة طلب موافقة الـ Plugin أصليًا.

يعمل أيضًا /approve ضمن الدردشة نفسها في قنوات Slack والرسائل المباشرة التي تدعم الأوامر بالفعل. راجع موافقات التنفيذ للاطلاع على نموذج إعادة توجيه الموافقات الكامل.

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

• تُحوّل تعديلات الرسائل وعمليات حذفها إلى أحداث نظام.
• تُعالَج عمليات بث سلاسل المحادثات (ردود السلسلة عبر "Also send to channel") كرسائل مستخدم عادية.
• تُحوّل أحداث إضافة التفاعلات وإزالتها إلى أحداث نظام.
• تُحوّل أحداث انضمام الأعضاء ومغادرتهم، وإنشاء القنوات وإعادة تسميتها، وإضافة التثبيت وإزالته إلى أحداث نظام.
• يمكن لاستقصاء الحضور الاختياري تحويل انتقال away إلى active لأحد المشاركين البشر الذين جرت ملاحظتهم إلى أحدث جلسة Slack مؤهلة ونشطة لذلك المشارك. يكون هذا معطلًا افتراضيًا.
• يمكن لـ channel_id_changed ترحيل مفاتيح إعداد القناة عندما يكون configWrites مفعّلًا.
• تُعامل البيانات الوصفية لموضوع القناة وغرضها كسياق غير موثوق ويمكن حقنها في سياق التوجيه.
• تُرشّح بادرة سلسلة المحادثات وبذر سياق السجل الأولي للسلسلة وفق قوائم السماح للمرسلين المضبوطة عند انطباقها.
• تصدر إجراءات الكتل والاختصارات وتفاعلات النماذج المشروطة أحداث نظام Slack interaction: ... منظّمة تتضمن حقول حمولة غنية:
  • إجراءات الكتل: القيم المحددة، والتسميات، وقيم أدوات الاختيار، والبيانات الوصفية لـ workflow_*
  • الاختصارات العامة: البيانات الوصفية للاستدعاء والفاعل، وتُوجّه إلى جلسة الفاعل المباشرة
  • اختصارات الرسائل: سياق الاستدعاء والفاعل والقناة والسلسلة والرسالة المحددة
  • أحداث النموذج المشروط view_submission وview_closed مع البيانات الوصفية للقناة الموجّهة ومدخلات النموذج

عرّف اختصارات عامة أو اختصارات رسائل في إعداد تطبيق Slack واستخدم أي معرّف استدعاء غير فارغ. يقرّ OpenClaw باستلام حمولات الاختصارات المطابقة، ويطبّق سياسة مرسل الرسائل المباشرة/القنوات نفسها المطبّقة على تفاعلات Slack الأخرى، ويضع الحدث المنقّى في قائمة انتظار جلسة الوكيل الموجّهة. تُنقّح معرّفات المشغّلات وعناوين URL للاستجابة من سياق الوكيل.

أحداث الحضور

لا يرسل Slack تغييرات الحضور عبر Events API أو Socket Mode. وبدلًا من ذلك، يمكن لـ OpenClaw استقصاء users.getPresence للمشاركين البشر الذين اجتازت رسائلهم عمليات التحقق العادية للوصول والتوجيه في Slack.

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off (الافتراضي): لا يوجد مؤقت حضور أو استدعاءات Slack API.
• auto: راقب الرسائل المباشرة وMPIMs وسلاسل Slack النشطة خلال آخر 24 ساعة، بحد أقصى 8 مشاركين بشر تمت ملاحظتهم. تُستبعد جلسات القنوات ذات المستوى الأعلى.
• on: راقب المحادثات نفسها من دون حد للمشاركين، وأدرج جلسات القنوات ذات المستوى الأعلى. استخدم تجاوزًا خاصًا بكل قناة لفرض مراقبة قناة واحدة أو منعها.

يستقصي OpenClaw بحد أقصى 45 مستخدمًا فريدًا في الدقيقة لكل حساب Slack، ويستخدم النتيجة الأولى كبذرة من دون إيقاظ الوكيل، ولا يوقظه إلا عند ملاحظة انتقال من away إلى active. تُطبّق فترة تهدئة دائمة مدتها 8 ساعات لكل حساب Slack ومستخدم، حتى إذا شارك ذلك الشخص في عدة سلاسل. لا يُوجّه الحدث إلا إلى أحدث محادثة مؤهلة ونشطة لذلك الشخص، ويطلب من الوكيل الرجوع إلى الذاكرة/الويكي وسياق المنطقة الزمنية المعروف قبل أن يقرر ما إذا كان سيرسل تحية قصيرة واحدة. ويمكن للوكيل التزام الصمت.

يحتاج رمز البوت إلى users:read، وهو مُدرج بالفعل في البيان الموصى به. لا تتوفر أحداث الحضور لعمليات التثبيت على مستوى مؤسسة Enterprise Grid بأكملها.

مرجع الإعداد

المرجع الأساسي: مرجع الإعداد - Slack.

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

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

مرجع وسائط المرفقات

يمكن لـ Slack إرفاق الوسائط المنزّلة بدورة الوكيل عند نجاح تنزيل ملفات Slack وسماح حدود الحجم بذلك. يمكن نسخ المقاطع الصوتية نصيًا، ويمكن تمرير ملفات الصور عبر مسار فهم الوسائط أو مباشرةً إلى نموذج رد يدعم الرؤية، بينما تظل الملفات الأخرى متاحة كسياق ملفات قابل للتنزيل.

أنواع الوسائط المدعومة

مسار المعالجة الواردة

عند وصول رسالة Slack تحتوي على مرفقات ملفات:

1. ينزّل OpenClaw الملف من عنوان URL الخاص في Slack باستخدام رمز البوت.
2. يُكتب الملف في مخزن الوسائط عند النجاح.
3. تُضاف مسارات الوسائط المنزّلة وأنواع محتواها إلى السياق الوارد.
4. تُوجّه المقاطع الصوتية إلى مسار النسخ المشترك؛ ويمكن لمسارات النماذج/الأدوات الداعمة للصور استخدام مرفقات الصور من السياق نفسه.
5. تظل الملفات الأخرى متاحة كبيانات وصفية للملفات أو مراجع وسائط للأدوات القادرة على التعامل معها.

توارث مرفقات جذر سلسلة المحادثة

عند وصول رسالة ضمن سلسلة محادثات (لها أصل thread_ts):

• إذا لم يحتوِ الرد نفسه على وسائط مباشرة وكانت الرسالة الجذرية المضمّنة تحتوي على ملفات، فيمكن لـ Slack تحميل ملفات الجذر كسياق لبادئ سلسلة المحادثات.
• تُحمّل ملفات الجذر فقط عند تهيئة جلسة سلسلة محادثات جديدة أو معاد ضبطها. تعيد الردود النصية اللاحقة استخدام سياق الجلسة الحالي ولا تعيد إرفاق ملفات الجذر كوسائط جديدة.
• تأخذ مرفقات الرد المباشرة الأولوية على مرفقات الرسالة الجذرية.
• تُمثّل الرسالة الجذرية التي تحتوي ملفات فقط ولا تحتوي نصًا بعنصر نائب للمرفق، بحيث يمكن للخيار الاحتياطي تضمين ملفاتها مع ذلك.

معالجة المرفقات المتعددة

عندما تحتوي رسالة Slack واحدة على عدة مرفقات ملفات:

• يُعالج كل مرفق بصورة مستقلة عبر مسار الوسائط.
• تُجمّع مراجع الوسائط المنزّلة في سياق الرسالة.
• يتبع ترتيب المعالجة ترتيب ملفات Slack في حمولة الحدث.
• لا يمنع فشل تنزيل أحد المرفقات معالجة المرفقات الأخرى.

حدود الحجم والتنزيل والنموذج

• حد الحجم: الافتراضي 20 MB لكل ملف. قابل للتهيئة عبر channels.slack.mediaMaxMb.
• حد النسخ الصوتي: ينطبق tools.media.audio.maxBytes أيضًا عند إرسال الملف المنزّل إلى موفّر نسخ أو CLI.
• إخفاقات التنزيل: تُتخطى الملفات التي يتعذر على Slack توفيرها، وعناوين URL المنتهية الصلاحية، والملفات التي يتعذر الوصول إليها، والملفات التي تتجاوز الحجم، واستجابات HTML الخاصة بمصادقة/تسجيل دخول Slack، بدلًا من الإبلاغ عنها كتنسيقات غير مدعومة.
• نموذج الرؤية: يستخدم تحليل الصور نموذج الرد النشط عندما يدعم الرؤية، أو نموذج الصور المُعدّ في agents.defaults.imageModel.

القيود المعروفة

الوثائق ذات الصلة

• مسار فهم الوسائط
• الصوت والملاحظات الصوتية
• أداة PDF

ذات صلة