Slack

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

# اختيار Socket Mode أو HTTP Request URLs

كلتا وسيلتي النقل جاهزتان للإنتاج وتحققان تكافؤ الميزات في المراسلة، وأوامر الشرطة المائلة، و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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw 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",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw 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. تظل رسائل التطبيق والأحداث حالة تطبيق، وليست إشارات حياة للنقل.

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

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

البيان الأساسي (الافتراضي في 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"
    }
  }
}

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

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

يمكّن البيان الافتراضي تبويب Slack App Home Home ويشترك في app_home_opened. عندما يفتح عضو في مساحة العمل تبويب Home، ينشر OpenClaw عرض Home افتراضيًا آمنًا باستخدام views.publish؛ ولا تُضمّن أي حمولة محادثة أو إعدادات خاصة. يظل تبويب Messages ممكّنًا لرسائل 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>) عند الاقتضاء.
• الافتراضي لـ 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>]]

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

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

ترتيب الحل:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• بديل الرموز التعبيرية لهوية الوكيل (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").
• التفاعل يبذل أفضل جهد، وتتم محاولة التنظيف تلقائياً بعد اكتمال الرد أو مسار الفشل.

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

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

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

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

/openclaw /help

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

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

/help

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

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

/think

تستخدم جلسات slash مفاتيح معزولة مثل 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 --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

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

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

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

# مسار الإدخال الوارد

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

1. ينزّل OpenClaw الملف من عنوان 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

# ذات صلة