​

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

​

Контрольний список маніфесту та 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"
      ]
    }
  }
}

​

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

• 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).
• Необов’язково: додайте chat:write.customize, якщо хочете, щоб вихідні повідомлення використовували ідентичність активного агента (власні username та icon). Для icon_emoji використовується синтаксис :emoji_name:.

• Перевірка облікового запису Slack відстежує поля *Source і *Status для кожних облікових даних (botToken, appToken, signingSecret, userToken).
• Статус може бути available, configured_unavailable або missing.
• configured_unavailable означає, що обліковий запис налаштовано через SecretRef або інше не-inline джерело секретів, але поточний шлях команди/виконання не зміг визначити фактичне значення.
• У HTTP-режимі включається signingSecretStatus; у Socket Mode обов’язковою парою є botTokenStatus + appTokenStatus.

​

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

​

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

​

Треди, сесії та теги відповідей

• Особисті повідомлення маршрутизуються як 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.replyToMode: off|first|all|batched (типово off)
• channels.slack.replyToModeByChatType: для direct|group|channel
• застаріле резервне значення для прямих чатів: channels.slack.dm.replyToMode

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

​

Реакції-підтвердження

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

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

​

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

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

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

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

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

​

Резервна реакція друку

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

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

​

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

​

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

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

​

Підтвердження exec у Slack

• Підтвердження exec використовують channels.slack.execApprovals.* для вбудованої маршрутизації в особисті повідомлення/канали.
• Підтвердження plugin також можуть визначатися через ту саму вбудовану поверхню кнопок Slack, коли запит уже надходить у Slack, а тип ідентифікатора підтвердження — plugin:.
• Авторизація затверджувачів і далі примусово застосовується: лише користувачі, визначені як затверджувачі, можуть схвалювати або відхиляти запити через 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",
      },
    },
  },
}

​

Події та поведінка під час роботи

• Редагування/видалення повідомлень і thread broadcast відображаються в системні події.
• Події додавання/видалення реакцій відображаються в системні події.
• Події входу/виходу учасників, створення/перейменування каналу та додавання/видалення закріплень відображаються в системні події.
• channel_id_changed може мігрувати ключі конфігурації каналу, якщо ввімкнено configWrites.
• Метадані topic/purpose каналу вважаються недовіреним контекстом і можуть бути впроваджені в контекст маршрутизації.
• Початкове повідомлення треду та початкове заповнення контексту історії треду фільтруються за налаштованими allowlist відправників, якщо це застосовно.
• Дії блоків і взаємодії модальних вікон створюють структуровані системні події Slack interaction: ... із розширеними полями payload:
  • дії блоків: вибрані значення, мітки, значення picker і метадані workflow_*
  • події модальних вікон 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-команди