Slack

Готово для продакшена в личных сообщениях и каналах через интеграции Slack app. Режим по умолчанию — Socket Mode; URL-адреса HTTP-запросов также поддерживаются. Режим ретрансляции предназначен для управляемых развертываний, где доверенный маршрутизатор отвечает за входящий трафик Slack.

Выбор Socket Mode или URL-адресов HTTP-запросов

Оба транспорта готовы для продакшена и обеспечивают паритет функций для обмена сообщениями, slash-команд, 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. Рассматривайте bearer-токен и таблицу маршрутов маршрутизатора как часть границы авторизации Slack: маршрутизированные события попадают в обычный обработчик сообщений Slack как авторизованные активации. Предоставленный маршрутизатором slack_identity в websocket-фрейме hello может задать исходящие имя пользователя и значок по умолчанию; явно переданная вызывающей стороной identity по-прежнему имеет приоритет. Соединение ретрансляции переподключается с теми же ограниченными интервалами backoff, что и Socket Mode, и очищает предоставленную маршрутизатором identity при каждом отключении.

Установка

Установите Slack перед настройкой канала:

openclaw plugins install @openclaw/slack

plugins install регистрирует и включает Plugin. Plugin по-прежнему ничего не делает, пока вы не настроите Slack app и параметры канала ниже. См. Plugins для общего поведения Plugin и правил установки.

Быстрая настройка

{"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-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 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-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 Mode

OpenClaw по умолчанию задает для клиента Slack SDK тайм-аут pong в 15 секунд для Socket Mode. Переопределяйте настройки транспорта только тогда, когда нужна настройка под конкретное рабочее пространство или хост:

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

Используйте это только для рабочих пространств Socket Mode, где логируются тайм-ауты websocket pong/server-ping Slack, или для хостов с известным истощением event loop. clientPingTimeout — это ожидание pong после того, как SDK отправляет клиентский ping; serverPingTimeout — ожидание серверных ping от Slack. Сообщения приложения и события остаются состоянием приложения, а не сигналами жизнеспособности транспорта.

Примечания:

• socketMode игнорируется в режиме HTTP Request URL.
• Базовые настройки channels.slack.socketMode применяются ко всем учетным записям Slack, если они не переопределены. Переопределения для отдельных учетных записей используют channels.slack.accounts.<accountId>.socketMode; поскольку это объектное переопределение, включите все поля настройки сокета, которые нужны для этой учетной записи.
• Только у clientPingTimeout есть значение по умолчанию OpenClaw (15000). serverPingTimeout и pingPongLoggingEnabled передаются в Slack SDK только при явной настройке.
• Backoff перезапуска Socket Mode начинается примерно с 2 секунд и ограничивается примерно 30 секундами. Восстановимые сбои запуска, ожидания запуска и отключения повторяются, пока канал не остановится. Постоянные ошибки учетной записи и учетных данных, такие как недействительная аутентификация, отозванные токены или отсутствующие scope, завершаются быстро вместо бесконечных повторов.

Контрольный список манифеста и scope

Базовый манифест приложения 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    },    "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"      ]    }  }}

Для режима 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",        "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"    }  }}

Дополнительные настройки манифеста

Предоставьте другие функции, расширяющие приведенные выше значения по умолчанию.

Манифест по умолчанию включает вкладку Slack App Home Home и подписывается на app_home_opened. Когда участник рабочей области открывает вкладку Home, OpenClaw публикует безопасное представление Home по умолчанию с помощью views.publish; полезная нагрузка беседы или приватная конфигурация не включаются. Вкладка Messages остается включенной для Slack DM. Манифест также включает потоки Slack assistant с features.assistant_view, assistant:write, assistant_thread_started и assistant_thread_context_changed; потоки assistant направляются в собственные сеансы потоков OpenClaw и сохраняют предоставленный 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": "/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 Mode.
• Для режима 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 или другой не inline-источник секрета, но текущая команда или путь выполнения не смогли получить фактическое значение.
• В режиме HTTP включается signingSecretStatus; в Socket Mode обязательная пара — botTokenStatus + appTokenStatus.

Действия и шлюзы

Действия Slack управляются через channels.slack.actions.*.

Доступные группы действий в текущих инструментах Slack:

Текущие действия с сообщениями Slack включают send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info и emoji-list. download-file принимает идентификаторы файлов Slack, показанные во входящих заполнителях файлов, и возвращает предварительные просмотры изображений для изображений или метаданные локального файла для других типов файлов.

Контроль доступа и маршрутизация

Потоки, сессии и теги ответов

• Личные сообщения маршрутизируются как direct; каналы как channel; MPIM как group.
• Привязки маршрутов Slack принимают необработанные ID собеседников, а также формы целей Slack, например channel:C12345678, user:U12345678 и <@U12345678>.
• При значении по умолчанию session.dmScope=main личные сообщения Slack сворачиваются в основную сессию агента.
• Сессии каналов: agent:<agentId>:slack:channel:<channelId>.
• Обычные сообщения верхнего уровня в канале остаются в сессии конкретного канала, даже когда replyToMode не равен off.
• Ответы в потоках Slack используют родительский Slack thread_ts для суффиксов сессии (: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
• устаревший fallback для прямых чатов: channels.slack.dm.replyToMode

Поддерживаются ручные теги ответов:

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

Для явных ответов в потоках Slack из инструмента message задайте replyBroadcast: true с action: "send" и threadId или replyTo, чтобы попросить Slack также транслировать ответ в потоке в родительский канал. Это сопоставляется с флагом Slack chat.postMessage reply_broadcast и поддерживается только для отправки текста или Block Kit, но не для загрузок медиа.

Когда вызов инструмента message выполняется внутри потока Slack и нацелен на тот же канал, OpenClaw обычно наследует текущий поток Slack согласно replyToMode. Задайте topLevel: true для action: "send" или action: "upload-file", чтобы принудительно создать новое сообщение в родительском канале. threadId: null принимается как тот же отказ от потока верхнего уровня.

Реакции подтверждения

ackReaction отправляет emoji подтверждения, пока OpenClaw обрабатывает входящее сообщение. ackReactionScope определяет, когда этот emoji фактически отправляется.

Emoji (ackReaction)

Порядок разрешения:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback на emoji идентичности агента (agents.list[].identity.emoji, иначе "eyes" / 👀)

Примечания:

• Slack ожидает shortcodes (например, "eyes").
• Используйте "", чтобы отключить реакцию для аккаунта Slack или глобально.

Область (messages.ackReactionScope)

Провайдер Slack читает область из messages.ackReactionScope (по умолчанию "group-mentions"). На сегодня нет переопределения на уровне аккаунта Slack или канала Slack; значение глобально для gateway.

Значения:

• "all": реагировать в личных сообщениях и группах.
• "direct": реагировать только в личных сообщениях.
• "group-all": реагировать на каждое групповое сообщение (без личных сообщений).
• "group-mentions" (по умолчанию): реагировать в группах, но только когда бот упомянут (или в групповых mentionables, которые включили это). Личные сообщения исключены.
• "off" / "none": никогда не реагировать.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // react in DMs and groups  },}

Потоковая передача текста

channels.slack.streaming управляет поведением live preview:

• off: отключить потоковую передачу live preview.
• partial (по умолчанию): заменять текст предварительного просмотра последним частичным выводом.
• block: добавлять фрагментированные обновления предварительного просмотра.
• progress: показывать текст состояния прогресса во время генерации, затем отправлять финальный текст.
• streaming.preview.toolProgress: когда черновой предварительный просмотр активен, направлять обновления инструментов/прогресса в то же редактируемое сообщение предварительного просмотра (по умолчанию: true). Задайте false, чтобы сохранять отдельные сообщения инструментов/прогресса.
• streaming.preview.commandText / streaming.progress.commandText: задайте status, чтобы сохранять компактные строки прогресса инструментов, скрывая необработанный текст команд/exec (по умолчанию: raw).

Скрыть необработанный текст команд/exec, сохраняя компактные строки прогресса:

{  "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 в стиле thread; вместо этого OpenClaw публикует и редактирует черновой предварительный просмотр в личном сообщении.
• Медиа и нетекстовые payloads используют fallback к обычной доставке.
• Финальные медиа/ошибки отменяют ожидающие правки предварительного просмотра; подходящие финальные тексты/блоки сбрасываются только когда они могут редактировать предварительный просмотр на месте.
• Если потоковая передача завершается ошибкой в середине ответа, OpenClaw использует fallback к обычной доставке для оставшихся payloads.

Использовать черновой предварительный просмотр вместо нативной потоковой передачи текста 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) — устаревший runtime-псевдоним для channels.slack.streaming.mode.
• boolean channels.slack.streaming — устаревший runtime-псевдоним для channels.slack.streaming.mode и channels.slack.streaming.nativeTransport.
• устаревший channels.slack.nativeStreaming — runtime-псевдоним для channels.slack.streaming.nativeTransport.
• Запустите openclaw doctor --fix, чтобы переписать сохраненную конфигурацию потоковой передачи Slack на канонические ключи.

Fallback реакции набора текста

typingReaction добавляет временную реакцию к входящему сообщению Slack, пока OpenClaw обрабатывает ответ, а затем удаляет ее после завершения запуска. Это наиболее полезно вне ответов в потоках, которые используют стандартный индикатор состояния "is typing...".

Порядок разрешения:

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

Примечания:

• Slack ожидает shortcodes (например, "hourglass_flowing_sand").
• Реакция выполняется по принципу best-effort, а очистка автоматически предпринимается после завершения ответа или пути ошибки.

Медиа, разбиение на фрагменты и доставка

Команды и поведение slash

Slash-команды отображаются в 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 опций: внешний select с асинхронной фильтрацией опций, когда доступны обработчики options для интерактивности
• превышены лимиты Slack: закодированные значения опций используют fallback к кнопкам

/think

Slash-сеансы используют изолированные ключи вроде agent:<agentId>:slack:slash:<userId> и по-прежнему направляют выполнение команд в целевой сеанс беседы с помощью CommandTargetSessionKey.

Интерактивные ответы

Slack может отображать созданные агентом элементы управления интерактивными ответами, но по умолчанию эта функция отключена. Для нового вывода агента, CLI и Plugin предпочитайте общие кнопки 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.

Примечания:

• Это устаревший UI, специфичный для Slack. Другие каналы не переводят директивы Slack Block Kit в собственные системы кнопок.
• Значения интерактивных обратных вызовов являются непрозрачными токенами, созданными OpenClaw, а не сырыми значениями, заданными агентом.
• Если созданные интерактивные блоки превысят ограничения Slack Block Kit, OpenClaw вернется к исходному текстовому ответу вместо отправки недопустимой полезной нагрузки блоков.

Отправки модальных окон, принадлежащие Plugin

Plugin Slack, которые регистрируют интерактивный обработчик, также могут получать события жизненного цикла модальных окон view_submission и view_closed до того, как OpenClaw сожмет полезную нагрузку для видимого агенту системного события. При открытии модального окна Slack используйте один из этих шаблонов маршрутизации:

• Задайте callback_id как openclaw:<namespace>:<payload>.
• Или сохраните существующий callback_id и поместите pluginInteractiveData: "<namespace>:<payload>" в private_metadata модального окна.

Обработчик получает ctx.interaction.kind как view_submission или view_closed, нормализованные inputs и полный сырой объект stateValues из Slack. Маршрутизации только по callback ID достаточно, чтобы вызвать обработчик Plugin; включайте существующие поля маршрутизации пользователя/сеанса из private_metadata модального окна, когда модальное окно также должно создать видимое агенту системное событие. Агент получает компактное, отредактированное системное событие Slack interaction: .... Если обработчик возвращает systemEvent.summary, systemEvent.reference или systemEvent.data, эти поля включаются в это компактное событие, чтобы агент мог ссылаться на хранилище, принадлежащее Plugin, не видя полной полезной нагрузки формы.

Нативные подтверждения в Slack

Slack может работать как нативный клиент подтверждений с интерактивными кнопками и взаимодействиями, вместо отката к Web UI или терминалу.

• Подтверждения Exec и Plugin могут отображаться как нативные подсказки Slack Block Kit.
• channels.slack.execApprovals.* остается конфигурацией включения нативного клиента подтверждений exec и маршрутизации DM/канала.
• DM подтверждений exec используют channels.slack.execApprovals.approvers или commands.ownerAllowFrom.
• Подтверждения Plugin используют нативные кнопки Slack, когда Slack включен как нативный клиент подтверждений для исходного сеанса или когда approvals.plugin направляет в исходный сеанс Slack либо целевой Slack.
• DM подтверждений Plugin используют утверждающих Plugin Slack из channels.slack.allowFrom, allowFrom именованной учетной записи или маршрута учетной записи по умолчанию.
• Авторизация утверждающих по-прежнему принудительно проверяется: утверждающие только exec не могут подтверждать запросы Plugin, если они также не являются утверждающими Plugin.

Это использует ту же общую поверхность кнопок подтверждения, что и другие каналы. Когда interactivity включена в настройках вашего приложения Slack, подсказки подтверждения отображаются как кнопки Block Kit прямо в беседе. Когда эти кнопки присутствуют, они являются основным UX подтверждения; 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" и разрешается хотя бы один утверждающий exec. Slack также может обрабатывать нативные подтверждения Plugin через этот путь нативного клиента, когда разрешаются утверждающие Plugin Slack и запрос соответствует фильтрам нативного клиента. Задайте enabled: false, чтобы явно отключить Slack как нативный клиент подтверждений. Задайте enabled: true, чтобы принудительно включить нативные подтверждения, когда разрешаются утверждающие. Отключение подтверждений exec Slack не отключает доставку нативных подтверждений Plugin Slack, включенную через approvals.plugin; доставка подтверждений Plugin вместо этого использует утверждающих Plugin Slack.

Поведение по умолчанию без явной конфигурации подтверждений exec Slack:

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

Явная нативная конфигурация Slack нужна только когда требуется переопределить утверждающих, добавить фильтры или включить доставку в исходный чат:

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

Общая пересылка approvals.exec отделена. Используйте ее только когда подсказки подтверждения exec также должны направляться в другие чаты или явные внеполосные цели. Общая пересылка approvals.plugin также отделена; нативная доставка Slack подавляет этот откат только когда Slack может обработать запрос подтверждения Plugin нативно.

/approve в том же чате также работает в каналах Slack и DM, которые уже поддерживают команды. См. Подтверждения Exec для полной модели пересылки подтверждений.

События и операционное поведение

• Редактирования/удаления сообщений преобразуются в системные события.
• Трансляции тредов (ответы в треде с "Also send to channel") обрабатываются как обычные сообщения пользователя.
• События добавления/удаления реакций преобразуются в системные события.
• События входа/выхода участника, создания/переименования канала и добавления/удаления закрепления преобразуются в системные события.
• channel_id_changed может мигрировать ключи конфигурации канала, когда включено configWrites.
• Метаданные темы/назначения канала считаются недоверенным контекстом и могут быть внедрены в контекст маршрутизации.
• Начальное сообщение треда и первичное заполнение контекста истории треда фильтруются настроенными allowlist отправителей, когда применимо.
• Действия блоков, ярлыки и модальные взаимодействия создают структурированные системные события Slack interaction: ... с богатыми полями полезной нагрузки:
  • действия блоков: выбранные значения, метки, значения picker и метаданные workflow_*
  • глобальные ярлыки: метаданные callback и участника, направленные в прямой сеанс участника
  • ярлыки сообщений: контекст callback, участника, канала, треда и выбранного сообщения
  • события модальных окон view_submission и view_closed с маршрутизированными метаданными канала и вводом формы

Определите глобальные ярлыки или ярлыки сообщений в конфигурации приложения Slack и используйте любой непустой callback ID. OpenClaw подтверждает соответствующие полезные нагрузки ярлыков, применяет ту же политику отправителей DM/каналов, что и для других взаимодействий Slack, и ставит очищенное событие в очередь для маршрутизированного сеанса агента. Trigger ID и URL ответов редактируются из контекста агента.

Справочник конфигурации

Основной справочник: Справочник конфигурации - Slack.

Устранение неполадок

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

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Справочник по vision для вложений

Slack может прикреплять загруженные медиа к ходу агента, когда загрузка файлов Slack успешна и ограничения размера это позволяют. Файлы изображений могут передаваться через путь понимания медиа или напрямую в модель ответа с поддержкой vision; другие файлы сохраняются как загружаемый файловый контекст, а не рассматриваются как входные изображения.

Поддерживаемые типы медиа

Входящий конвейер

Когда приходит сообщение Slack с файловыми вложениями:

1. OpenClaw загружает файл с приватного URL Slack, используя токен бота.
2. При успехе файл записывается в хранилище медиа.
3. Пути загруженных медиа и типы содержимого добавляются во входящий контекст.
4. Пути модели/инструмента с поддержкой изображений могут использовать вложения изображений из этого контекста.
5. Файлы, не являющиеся изображениями, остаются доступными как файловые метаданные или ссылки на медиа для инструментов, которые могут их обработать.

Наследование вложений из корня треда

Когда сообщение приходит в треде (имеет родительский thread_ts):

• Если у самого ответа нет прямых медиа, а включенное корневое сообщение содержит файлы, Slack может подгрузить корневые файлы как контекст начального сообщения треда.
• Прямые вложения ответа имеют приоритет над вложениями корневого сообщения.
• Корневое сообщение, в котором есть только файлы и нет текста, представляется placeholder вложения, чтобы резервный путь все равно мог включить его файлы.

Обработка нескольких вложений

Когда одно сообщение Slack содержит несколько файловых вложений:

• Каждое вложение обрабатывается независимо через медийный конвейер.
• Ссылки на загруженные медиа агрегируются в контекст сообщения.
• Порядок обработки следует порядку файлов Slack в полезной нагрузке события.
• Сбой загрузки одного вложения не блокирует остальные.

Ограничения размера, загрузки и модели

• Ограничение размера: по умолчанию 20 MB на файл. Настраивается через channels.slack.mediaMaxMb.
• Сбои загрузки: файлы, которые Slack не может отдать, истекшие URL, недоступные файлы, слишком большие файлы и HTML-ответы Slack auth/login пропускаются вместо сообщения о неподдерживаемых форматах.
• Модель vision: анализ изображений использует активную модель ответа, когда она поддерживает vision, или модель изображений, настроенную в agents.defaults.imageModel.

Известные ограничения

Связанная документация

• Конвейер понимания медиа
• Инструмент PDF
• Эпик: #51349 — включение vision для вложений Slack
• Регрессионные тесты: #51353
• Live-верификация: #51354

Связанные материалы