Slack

جاهز للإنتاج للرسائل المباشرة والقنوات عبر تكاملات تطبيق Slack. الوضع الافتراضي هو Socket Mode؛ كما تُدعَم عناوين URL لطلبات HTTP.

اختيار Socket Mode أو عناوين URL لطلبات HTTP

كلا وسيلتي النقل جاهزتان للإنتاج وتحققان تكافؤًا في الميزات للمراسلة، وأوامر الشرطة المائلة، وApp Home، والتفاعل. اختر بناءً على شكل النشر، وليس الميزات.

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

{"display_information": {"name": "OpenClaw","description": "Slack connector for 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},"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","usergroups:read","users:read"]}},"settings": {"socket_mode_enabled": true,"event_subscriptions": {"bot_events": ["app_home_opened","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"]}}}

{"display_information": {"name": "OpenClaw","description": "Slack connector for 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},"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","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","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=xapp-...export SLACK_BOT_TOKEN=xoxb-...cat > 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=xapp-...SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "Slack connector for 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},"slash_commands": [{"command": "/openclaw","description": "Send a message to 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","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 connector for 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},"slash_commands": [{"command": "/openclaw","description": "Send a message to 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","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=xoxb-...export 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 Mode

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

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

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

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

يكون Manifest الأساسي لتطبيق Slack نفسه في Socket Mode وHTTP Request URLs. يختلف فقط قسم settings (وurl لأمر Slash).

Manifest الأساسي (Socket Mode الافتراضي):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack connector for 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    },    "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",        "usergroups:read",        "users:read"      ]    }  },  "settings": {    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_home_opened",        "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"      ]    }  }}

بالنسبة إلى وضع HTTP Request URLs، استبدل settings بمتغير HTTP وأضف url إلى كل أمر Slash. يلزم URL عام:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Send a message to 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",        "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"    }  }}

إعدادات Manifest إضافية

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

يفعّل Manifest الافتراضي تبويب الصفحة الرئيسية في Slack App Home ويشترك في app_home_opened. عندما يفتح عضو في مساحة العمل تبويب الصفحة الرئيسية، ينشر OpenClaw عرضًا افتراضيًا آمنًا للصفحة الرئيسية باستخدام views.publish؛ ولا تُضمّن أي حمولة محادثة أو تكوين خاص. يظل تبويب الرسائل مفعّلًا لرسائل Slack المباشرة.

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]"},{"command": "/reset","description": "Reset the current session"},{"command": "/compact","description": "Compact the session context","usage_hint": "[instructions]"},{"command": "/stop","description": "Stop the current run"},{"command": "/session","description": "Manage thread-binding expiry","usage_hint": "idle <duration|off> or max-age <duration|off>"},{"command": "/think","description": "Set the thinking level","usage_hint": "<level>"},{"command": "/verbose","description": "Toggle verbose output","usage_hint": "on|off|full"},{"command": "/fast","description": "Show or set fast mode","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Toggle reasoning visibility","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Toggle elevated mode","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Show or set exec defaults","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/model","description": "Show or set the model","usage_hint": "[name|#|status]"},{"command": "/models","description": "List providers/models","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Show the short help summary"},{"command": "/commands","description": "Show the generated command catalog"},{"command": "/tools","description": "Show what the current agent can use right now","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Show runtime status, including provider usage/quota when available"},{"command": "/tasks","description": "List active/recent background tasks for the current session"},{"command": "/context","description": "Explain how context is assembled","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Show your sender identity"},{"command": "/skill","description": "Run a skill by name","usage_hint": "<name> [input]"},{"command": "/btw","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/side","description": "Ask a side question without changing session context","usage_hint": "<question>"},{"command": "/usage","description": "Control the usage footer or show cost summary","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Start a new session","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Show the short help summary","url": "https://gateway-host.example.com/slack/events"}]}

نموذج الرموز

• botToken + appToken مطلوبان لوضع Socket Mode.
• يتطلب وضع HTTP كلا من botToken + signingSecret.
• تقبل botToken وappToken وsigningSecret وuserToken سلاسل نصية عادية أو كائنات SecretRef.
• تتجاوز رموز الإعدادات بديل env.
• ينطبق بديل env SLACK_BOT_TOKEN / SLACK_APP_TOKEN على الحساب الافتراضي فقط.
• userToken (xoxp-...) خاص بالإعدادات فقط (بلا بديل env) ويكون افتراضيا بسلوك القراءة فقط (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؛ وMPIMs كـ group.
• تقبل ارتباطات مسارات Slack معرفات النظراء الخام إضافة إلى صيغ أهداف Slack مثل channel:C12345678 وuser:U12345678 و<@U12345678>.
• مع session.dmScope=main الافتراضي، تطوى رسائل Slack المباشرة إلى الجلسة الرئيسية للوكيل.
• جلسات القنوات: agent:<agentId>:slack:channel:<channelId>.
• يمكن لردود السلاسل إنشاء لواحق جلسة السلسلة (:thread:<threadTs>) عند الاقتضاء.
• في القنوات التي يعالج فيها OpenClaw الرسائل ذات المستوى الأعلى دون طلب إشارة صريحة، يوجه replyToMode غير off كل جذر معالج إلى agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> بحيث ترتبط سلسلة Slack المرئية بجلسة OpenClaw واحدة من أول دور.
• الافتراضي لـ channels.slack.thread.historyScope هو thread؛ والافتراضي لـ thread.inheritParent هو false.
• تتحكم channels.slack.thread.initialHistoryLimit في عدد رسائل السلسلة الموجودة التي يتم جلبها عند بدء جلسة سلسلة جديدة (الافتراضي 20؛ اضبطها إلى 0 للتعطيل).
• channels.slack.thread.requireExplicitMention (الافتراضي false): عندما تكون true، تكبح الإشارات الضمنية في السلاسل بحيث لا يستجيب البوت إلا لإشارات @bot الصريحة داخل السلاسل، حتى عندما يكون البوت قد شارك بالفعل في السلسلة. دون هذا، تتجاوز الردود في سلسلة شارك فيها البوت بوابة requireMention.

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

• 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. اضبط topLevel: true على action: "send" أو action: "upload-file" لفرض رسالة جديدة في القناة الأصل بدلا من ذلك. تقبل threadId: null كإلغاء اختيار المستوى الأعلى نفسه.

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

يرسل ackReaction رمز emoji للإقرار أثناء معالجة OpenClaw لرسالة واردة.

ترتيب الحل:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• بديل emoji لهوية الوكيل (agents.list[].identity.emoji، وإلا "👀")

ملاحظات:

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

بث النص

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

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

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

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

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

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

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

ترتيب الحل:

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

ملاحظات:

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

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

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

تظهر أوامر الشرطة المائلة في 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

تستخدم قوائم الوسائط الأصلية استراتيجية عرض تكيفية تعرض نافذة تأكيد قبل إرسال قيمة الخيار المحدد:

• حتى 5 خيارات: كتل أزرار
• 6-100 خيار: قائمة اختيار ثابتة
• أكثر من 100 خيار: اختيار خارجي مع ترشيح خيارات غير متزامن عندما تكون معالجات خيارات التفاعلية متاحة
• تجاوز حدود Slack: تعود قيم الخيارات المرمزة إلى الأزرار

/think

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

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

يمكن لـ 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. لا تترجم القنوات الأخرى توجيهات Slack Block Kit إلى أنظمة أزرارها الخاصة.
• قيم رد الاتصال التفاعلية هي رموز مبهمة منشأة بواسطة OpenClaw، وليست قيمًا أولية من إنشاء الوكيل.
• إذا كانت الكتل التفاعلية المنشأة ستتجاوز حدود Slack Block Kit، يعود OpenClaw إلى الرد النصي الأصلي بدلًا من إرسال حمولة كتل غير صالحة.

موافقات Exec في Slack

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

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

يستخدم هذا سطح أزرار الموافقة المشترك نفسه مثل القنوات الأخرى. عند تفعيل 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 موافقات Exec الأصلية تلقائيًا عندما يكون enabled غير معيّن أو "auto" ويتم حل موافق واحد على الأقل. عيّن enabled: false لتعطيل Slack كعميل موافقة أصلي صراحةً. عيّن enabled: true لفرض تشغيل الموافقات الأصلية عند حل الموافقين.

السلوك الافتراضي دون تكوين صريح لموافقة Exec في Slack:

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

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

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

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

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

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

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

مرجع التكوين

المرجع الأساسي: مرجع التكوين - Slack.

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

مرجع رؤية المرفقات

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

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

مسار الوارد

عندما تصل رسالة Slack مع مرفقات ملفات:

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

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

عندما تصل رسالة في سلسلة (لديها أصل thread_ts):

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

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

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

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

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

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

حدود معروفة

وثائق ذات صلة

• مسار فهم الوسائط
• أداة PDF
• الملحمة: #51349 — تمكين رؤية مرفقات Slack
• اختبارات الانحدار: #51353
• التحقق المباشر: #51354

ذات صلة