​

Slack

​

Швидке налаштування

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

openclaw gateway

​

Контрольний список manifest і scope

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "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": {
      "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "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"
    }
  }
}

​

Модель токенів

• 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.

​

Дії та обмеження

​

Керування доступом і маршрутизація

​

Треди, сесії та теги reply

• Приватні повідомлення маршрутизуються як direct; канали — як channel; MPIM — як group.
• Із типовим 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>]]

​

Ack-реакції

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• резервне значення emoji з ідентичності агента (agents.list[].identity.emoji, інакше ”👀”)

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

​

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

• off: вимкнути live preview streaming.
• partial (типово): замінювати текст попереднього перегляду останнім частковим виводом.
• block: додавати фрагментовані оновлення попереднього перегляду.
• progress: показувати текст стану прогресу під час генерації, а потім надсилати фінальний текст.

• Щоб з’явилася нативна потокова передача тексту, має бути доступний тред відповіді. Вибір треду, як і раніше, підпорядковується replyToMode. Без нього використовується звичайний чернетковий попередній перегляд.
• Медіа та нетекстові корисні навантаження повертаються до звичайної доставки.
• Якщо потокова передача зламається посеред відповіді, OpenClaw повернеться до звичайної доставки для решти корисних навантажень.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) автоматично мігрує до channels.slack.streaming.
• булевий channels.slack.streaming автоматично мігрує до channels.slack.nativeStreaming.

​

Резервний варіант з typing reaction

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

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

​

Медіа, розбиття на частини та доставка

​

Команди та поведінка slash

• Нативний автоматичний режим команд для Slack вимкнено (commands.native: "auto" не вмикає нативні команди Slack).
• Увімкніть нативні обробники команд Slack через channels.slack.commands.native: true (або глобально commands.native: true).
• Коли нативні команди ввімкнено, зареєструйте відповідні slash-команди у Slack (імена /<command>), з одним винятком:
  • зареєструйте /agentstatus для команди status (Slack резервує /status)
• Якщо нативні команди не ввімкнено, можна запускати одну налаштовану slash-команду через channels.slack.slashCommand.
• Нативні меню аргументів тепер адаптують свою стратегію відображення:
  • до 5 варіантів: блоки кнопок
  • 6-100 варіантів: статичне меню вибору
  • понад 100 варіантів: зовнішній вибір з асинхронною фільтрацією варіантів, якщо доступні обробники параметрів interactivity
  • якщо закодовані значення варіантів перевищують обмеження Slack, потік повертається до кнопок
• Для довгих корисних навантажень варіантів меню аргументів slash-команд використовують діалог підтвердження перед відправленням вибраного значення.

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

• agent:<agentId>:slack:slash:<userId>

​

Інтерактивні відповіді

{
  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]]

• Це UI, специфічний для Slack. Інші канали не перекладають директиви Slack Block Kit у власні системи кнопок.
• Значення інтерактивних callback — це непрозорі токени, згенеровані OpenClaw, а не необроблені значення, створені агентом.
• Якщо згенеровані інтерактивні блоки перевищать обмеження Slack Block Kit, OpenClaw повернеться до початкової текстової відповіді замість надсилання недійсного корисного навантаження blocks.

​

Погодження exec у Slack

• Погодження exec використовують channels.slack.execApprovals.* для нативної маршрутизації до приватних повідомлень/каналів.
• Погодження plugin також можуть визначатися через ту саму поверхню нативних кнопок Slack, коли запит уже надходить у Slack, а тип ID погодження — plugin:.
• Авторизація того, хто погоджує, як і раніше, примусово застосовується: лише користувачі, визначені як approvers, можуть погоджувати або відхиляти запити через Slack.

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

​

Події та операційна поведінка

• Редагування/видалення повідомлень і трансляції тредів зіставляються із системними подіями.
• Події додавання/видалення реакцій зіставляються із системними подіями.
• Події входу/виходу учасників, створення/перейменування каналів і додавання/видалення закріплень зіставляються із системними подіями.
• channel_id_changed може мігрувати ключі конфігурації каналу, коли ввімкнено configWrites.
• Метадані теми/призначення каналу вважаються недовіреним контекстом і можуть бути ін’єктовані в контекст маршрутизації.
• Початкове повідомлення треду та початкове заповнення контексту історії треду фільтруються відповідно до налаштованих allowlist відправників, де це застосовно.
• Дії block і взаємодії modal створюють структуровані системні події Slack interaction: ... із насиченими полями корисного навантаження:
  • дії block: вибрані значення, мітки, значення picker і метадані workflow_*
  • події modal view_submission і view_closed з маршрутизованими метаданими каналу та введеними значеннями форми

​

Вказівники на довідкову конфігурацію

• Довідник конфігурації - Slack Високосигнальні поля Slack:
  • mode/auth: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • доступ до приватних повідомлень: dm.enabled, dmPolicy, allowFrom (застаріле: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • перемикач сумісності: dangerouslyAllowNameMatching (аварійний варіант; тримайте вимкненим, якщо не потрібно)
  • доступ до каналів: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • треди/історія: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • доставка: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • операції/можливості: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Усунення проблем

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

openclaw pairing list slack

​

Пов’язані розділи

• Сполучення
• Групи
• Безпека
• Маршрутизація каналів
• Усунення проблем
• Конфігурація
• Slash-команди