Slack

​

Вибір транспорту

​

Режим ретрансляції

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

​

Загальноорганізаційні інсталяції Enterprise Grid

​

Socket Mode

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      enterpriseOrgInstall: true,
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

HTTP Request URLs

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      enterpriseOrgInstall: true,
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: {
        source: "env",
        provider: "default",
        id: "SLACK_SIGNING_SECRET",
      },
      webhookPath: "/slack/events",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

Установлення

openclaw plugins install @openclaw/slack

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "З’єднувач Slack для 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 з’єднує гілки помічника Slack з агентами OpenClaw.",
      "suggested_prompts": [
        { "title": "Що ви вмієте?", "message": "Із чим ви можете мені допомогти?" },
        {
          "title": "Підсумувати цей канал",
          "message": "Підсумуйте нещодавню активність у цьому каналі."
        },
        { "title": "Створити чернетку відповіді", "message": "Допоможіть мені створити чернетку відповіді." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Надіслати повідомлення до 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 для 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 з’єднує гілки помічника Slack з агентами OpenClaw.",
      "suggested_prompts": [
        { "title": "Що ви вмієте?", "message": "Із чим ви можете мені допомогти?" },
        {
          "title": "Підсумувати цей канал",
          "message": "Підсумуйте нещодавню активність у цьому каналі."
        },
        { "title": "Створити чернетку відповіді", "message": "Допоможіть мені створити чернетку відповіді." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Надіслати повідомлення до 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 для 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 з’єднує гілки помічника Slack з агентами OpenClaw.",
      "suggested_prompts": [
        { "title": "Що ви вмієте?", "message": "Із чим ви можете мені допомогти?" },
        {
          "title": "Підсумувати цей канал",
          "message": "Підсумуйте нещодавню активність у цьому каналі."
        },
        { "title": "Створити чернетку відповіді", "message": "Допоможіть мені створити чернетку відповіді." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Надіслати повідомлення до 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 для 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 з’єднує потоки асистента Slack з агентами OpenClaw.",
      "suggested_prompts": [
        { "title": "Що ти вмієш?", "message": "Із чим ти можеш мені допомогти?" },
        {
          "title": "Підсумувати цей канал",
          "message": "Підсумуй нещодавню активність у цьому каналі."
        },
        { "title": "Створити чернетку відповіді", "message": "Допоможи мені створити чернетку відповіді." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Надіслати повідомлення до 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; оскільки це перевизначення об’єктом, додайте всі поля налаштування сокета, потрібні для цього облікового запису.
• Лише clientPingTimeout має типове значення OpenClaw (15000). serverPingTimeout і pingPongLoggingEnabled передаються до Slack SDK лише тоді, коли їх налаштовано.
• Затримка між повторними спробами перезапуску Socket Mode починається приблизно з 2 секунд і обмежується приблизно 30 секундами. Після відновлюваних помилок запуску, очікування запуску та роз’єднання спроби повторюються, доки канал не зупиниться. Постійні помилки облікового запису й облікових даних, як-от недійсна автентифікація, відкликані токени або відсутні області доступу, спричиняють негайну відмову замість нескінченних повторних спроб.

​

Контрольний список маніфесту й областей доступу

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Конектор Slack для 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 з’єднує потоки асистента Slack з агентами OpenClaw.",
      "suggested_prompts": [
        { "title": "Що ти вмієш?", "message": "Із чим ти можеш мені допомогти?" },
        {
          "title": "Підсумувати цей канал",
          "message": "Підсумуй нещодавню активність у цьому каналі."
        },
        { "title": "Створити чернетку відповіді", "message": "Допоможи мені створити чернетку відповіді." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Надіслати повідомлення до 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": "Надіслати повідомлення до 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": "Почати новий сеанс",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "Скинути поточний сеанс"
    },
    {
      "command": "/compact",
      "description": "Стиснути контекст сеансу",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "Зупинити поточний запуск"
    },
    {
      "command": "/session",
      "description": "Керувати завершенням прив’язки до гілки",
      "usage_hint": "idle <duration|off> або max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "Установити рівень міркування",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "Перемкнути докладне виведення",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "Показати або встановити швидкий режим",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "Перемкнути видимість міркувань",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "Перемкнути режим із підвищеними привілеями",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "Показати або встановити типові параметри виконання",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "Схвалити або відхилити запити на схвалення, що очікують",
      "usage_hint": "<id> <decision>"
    },
    {
      "command": "/model",
      "description": "Показати або встановити модель",
      "usage_hint": "[name|#|status]"
    },
    {
      "command": "/models",
      "description": "Перелічити постачальників і моделі",
      "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
    },
    {
      "command": "/help",
      "description": "Показати коротку довідку"
    },
    {
      "command": "/commands",
      "description": "Показати згенерований каталог команд"
    },
    {
      "command": "/tools",
      "description": "Показати, що поточний агент може використовувати зараз",
      "usage_hint": "[compact|verbose]"
    },
    {
      "command": "/agentstatus",
      "description": "Показати стан середовища виконання, зокрема використання або квоту постачальника, якщо доступно"
    },
    {
      "command": "/tasks",
      "description": "Перелічити активні й нещодавні фонові завдання поточного сеансу"
    },
    {
      "command": "/context",
      "description": "Пояснити, як формується контекст",
      "usage_hint": "[list|detail|json]"
    },
    {
      "command": "/whoami",
      "description": "Показати вашу ідентичність відправника"
    },
    {
      "command": "/skill",
      "description": "Запустити навичку за назвою",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "Поставити побічне запитання без зміни контексту сеансу",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "description": "Поставити побічне запитання без зміни контексту сеансу",
      "usage_hint": "<question>"
    },
    {
      "command": "/usage",
      "description": "Керувати нижнім колонтитулом використання або показати зведення витрат",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Почати новий сеанс",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "Показати коротку довідку",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

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

• botToken + appToken потрібні для Socket Mode.
• Для режиму HTTP потрібні botToken + signingSecret.
• Для режиму ретрансляції потрібен botToken разом із relay.url, relay.authToken і relay.gatewayId; токен застосунку або секрет підпису не використовується.
• botToken, appToken, signingSecret, relay.authToken і userToken приймають рядки звичайного тексту або об’єкти SecretRef.
• Токени конфігурації перевизначають резервні значення зі змінних середовища.
• Резервні значення змінних середовища SLACK_BOT_TOKEN, SLACK_APP_TOKEN і SLACK_USER_TOKEN застосовуються лише до типового облікового запису.
• userToken за замовчуванням працює лише для читання (userTokenReadOnly: true).

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

​

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

​

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

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

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

​

Гілки, сеанси та теги відповідей

• Особисті повідомлення маршрутизуються як direct; канали — як channel; MPIM — як group.
• Прив’язки маршрутів Slack приймають необроблені ідентифікатори співрозмовників, а також форми цілей 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.channels.<id>.replyToMode: перевизначення для окремого каналу щодо повідомлень у каналах і приватних каналах Slack
• 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.chunkMode і channels.slack.nativeStreaming верхнього рівня — застарілі псевдоніми для channels.slack.streaming.chunkMode і channels.slack.streaming.nativeTransport.
• Застарілі псевдоніми не зчитуються під час виконання; запустіть openclaw doctor --fix, щоб переписати збережену конфігурацію потокового передавання Slack із використанням канонічних ключів.

​

Резервна реакція набору тексту

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

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

​

Голосове введення

• Голосове диктування Slackbot доступне в приватній розмові користувача зі Slackbot. Slack перетворює запис на запит до Slackbot, але не передає стороннім застосункам Slack через Events API аудіофайл, подію диктування, запит або маркер джерела введення. Plugin Slack для OpenClaw не може ввімкнути чи отримати його.
• Аудіокліпи Slack — це файли, збережені в Slack, які можна опублікувати в приватному повідомленні OpenClaw, каналі або гілці. OpenClaw завантажує доступний кліп за допомогою токена бота, нормалізує MIME-метадані кліпу Slack і передає його через спільний конвеєр транскрибування аудіо. Рекомендований маніфест застосунку містить необхідну область дозволів files:read.

​

Медіафайли, поділ на частини та доставлення

​

Команди та поведінка команд із похилою рискою

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

/openclaw /help

• Автоматичний режим нативних команд для Slack вимкнено, тому commands.native: "auto" не вмикає нативні команди Slack.

/help

• 3–5 достатньо коротких варіантів: меню переповнення (”…”)
• понад 100 варіантів за наявності асинхронного фільтрування: зовнішній список вибору
• 1–2 варіанти або будь-який варіант, закодоване значення якого задовге для списку вибору: блоки кнопок
• в інших випадках (6–100 варіантів або понад 100 без асинхронного фільтрування): статичне меню вибору, поділене на частини по 100 варіантів на меню

/think

​

Нативні діаграми

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "Квартальний дохід",
      "categories": ["Q1", "Q2"],
      "series": [{ "name": "Дохід", "values": [120, 145] }],
      "xLabel": "Квартал"
    }
  ]
}

• заголовок і необов’язкові підписи осей: 50 символів
• секторна діаграма: 1–12 додатних сегментів
• лінійна/стовпчикова/площинна діаграма: 1–12 рядів з унікальними назвами та 1–20 спільних категорій
• підписи сегментів, категорій і рядів: 20 символів
• кожен ряд повинен містити одне скінченне значення для кожної категорії; значення не секторних діаграм можуть бути від’ємними

​

Нативні таблиці

{
  "blocks": [
    {
      "type": "table",
      "caption": "Відкритий конвеєр",
      "headers": ["Обліковий запис", "Етап", "ARR"],
      "rows": [
        ["Acme", "Виграно", 125000],
        ["Globex", "Перевірка", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• 1–20 стовпців
• 1–100 рядків даних плюс рядок заголовка
• однакова кількість комірок у кожному рядку
• щонайбільше 10 000 символів загалом у всіх комірках таблиць одного повідомлення

​

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

{
  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 надсилає початкову текстову відповідь замість недійсного навантаження блоків.

​

Надсилання модальних форм, керованих плагінами

• Установіть callback_id у значення openclaw:<namespace>:<payload>.
• Або збережіть наявний callback_id і помістіть pluginInteractiveData: "<namespace>:<payload>" у поле private_metadata модальної форми.

​

Вбудовані підтвердження у Slack

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

• 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”) обробляються як звичайні повідомлення користувача.
• Події додавання та видалення реакцій перетворюються на системні події.
• Події приєднання та виходу учасників, створення та перейменування каналів, а також додавання та видалення закріплень перетворюються на системні події.
• Необов’язкове опитування присутності може перетворити спостережуваний перехід учасника-людини з away до active на подію в його останньому активному придатному сеансі Slack. Типово вимкнено.
• channel_id_changed може переносити ключі конфігурації каналів, коли ввімкнено configWrites.
• Метадані теми/призначення каналу вважаються ненадійним контекстом і можуть бути додані до контексту маршрутизації.
• Початкове повідомлення гілки та початкове наповнення контекстом історії гілки фільтруються за налаштованими списками дозволених відправників, коли це застосовно.
• Дії блоків, ярлики та взаємодії з модальними формами створюють структуровані системні події Slack interaction: ... із докладними полями навантаження:
  • дії блоків: вибрані значення, мітки, значення засобів вибору та метадані workflow_*
  • глобальні ярлики: метадані зворотного виклику та виконавця, спрямовані до прямого сеансу виконавця
  • ярлики повідомлень: контекст зворотного виклику, виконавця, каналу, гілки та вибраного повідомлення
  • події модальної форми view_submission і view_closed із метаданими спрямованого каналу та введеними даними форми

​

Події присутності

{
  channels: {
    slack: {
      presenceEvents: { mode: "auto" },
      channels: {
        C0123456789: { presenceEvents: { mode: "on" } },
        C0987654321: { presenceEvents: { mode: "off" } },
      },
    },
  },
}

• off (типово): без таймера присутності та викликів API Slack.
• auto: відстежувати особисті повідомлення, MPIM і гілки Slack, активні протягом останніх 24 годин, із щонайбільше 8 спостережуваними учасниками-людьми. Сеанси каналів верхнього рівня виключено.
• on: відстежувати ті самі розмови без обмеження кількості учасників і включати сеанси каналів верхнього рівня. Використовуйте перевизначення для окремого каналу, щоб примусово ввімкнути або вимкнути один канал.

​

Довідник конфігурації

​

Усунення несправностей

{
  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.
• Обмеження транскрипції аудіо: tools.media.audio.maxBytes також застосовується, коли завантажений файл надсилається постачальнику транскрипції або CLI.
• Помилки завантаження: файли, які Slack не може надати, прострочені URL-адреси, недоступні або завеликі файли та HTML-відповіді автентифікації чи входу Slack пропускаються, а не позначаються як непідтримувані формати.
• Модель комп’ютерного зору: для аналізу зображень використовується активна модель відповіді, якщо вона підтримує комп’ютерний зір, або модель зображень, налаштована в agents.defaults.imageModel.

​

Відомі обмеження

​

Пов’язана документація

• Конвеєр розпізнавання медіа
• Аудіо й голосові нотатки
• Інструмент PDF

​

Пов’язані матеріали