Slack

​

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

​

وضع الترحيل

{
  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",
      },
    },
  },
}

​

التثبيت

openclaw plugins install @openclaw/slack

​

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

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
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=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example

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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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 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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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-example
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

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

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

​

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

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "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"
      ]
    }
  }
}

{
  "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",
        "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"
    }
  }
}

​

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

{
  "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": "/approve",
      "description": "Approve or deny pending approval requests",
      "usage_hint": "<id> <decision>"
    },
    {
      "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.
• يتطلب وضع HTTP وجود botToken + signingSecret.
• يتطلب وضع Relay وجود botToken بالإضافة إلى relay.url وrelay.authToken وrelay.gatewayId؛ ولا يستخدم رمز تطبيق أو سر توقيع.
• تقبل botToken وappToken وsigningSecret وrelay.authToken وuserToken سلاسل نص عادي أو كائنات SecretRef.
• تتجاوز رموز الإعدادات بديل env الاحتياطي.
• ينطبق بديل env الاحتياطي SLACK_BOT_TOKEN / SLACK_APP_TOKEN على الحساب الافتراضي فقط.
• userToken مخصص للإعدادات فقط (من دون بديل env احتياطي) ويستخدم افتراضيًا سلوك القراءة فقط (userTokenReadOnly: true).

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

​

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

​

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

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { allow: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { allow: true, requireMention: true },
      },
    },
  },
}

​

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

• تُوجَّه الرسائل المباشرة كـ direct؛ والقنوات كـ channel؛ وMPIMs كـ 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.replyToMode: off|first|all|batched (الافتراضي off)
• channels.slack.replyToModeByChatType: لكل direct|group|channel
• رجوع قديم للدردشات المباشرة: channels.slack.dm.replyToMode

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

​

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

​

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

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

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

​

النطاق (messages.ackReactionScope)

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

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

​

بث النص

• 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"
        }
      }
    }
  }
}

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

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

{
  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.nativeStreaming القديم هو اسم مستعار في وقت التشغيل لـ channels.slack.streaming.nativeTransport.
• شغّل openclaw doctor --fix لإعادة كتابة إعدادات بث Slack المحفوظة إلى المفاتيح المعيارية.

​

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

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

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

​

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

​

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

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

/openclaw /help

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

/help

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

/think

​

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

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

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

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

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

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

​

عمليات إرسال النوافذ المنبثقة المملوكة من Plugin

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

​

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

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

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

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

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

​

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

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

​

مرجع التكوين

​

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

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

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

openclaw pairing list slack

​

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

​

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

​

مسار الوارد

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

​

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

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

​

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

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

​

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

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

​

الحدود المعروفة

​

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

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

​

ذات صلة