Slack

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

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

​

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

{
  "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
    },
    "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",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
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=xapp-...
SLACK_BOT_TOKEN=xoxb-...

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

export SLACK_BOT_TOKEN=xoxb-...
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,
      },
    },
  },
}

​

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

{
  "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
    },
    "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",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

​

Додаткові налаштування маніфесту

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Start a new session",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "Reset the current session"
    },
    {
      "command": "/compact",
      "description": "Compact the session context",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "Stop the current run"
    },
    {
      "command": "/session",
      "description": "Manage thread-binding expiry",
      "usage_hint": "idle <duration|off> or max-age <duration|off>"
    },
    {
      "command": "/think",
      "description": "Set the thinking level",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "Toggle verbose output",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "Show or set fast mode",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "Toggle reasoning visibility",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "Toggle elevated mode",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "Show or set exec defaults",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/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.
• 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.

​

Дії та шлюзи

​

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

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

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

​

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

• DM маршрутизуються як direct; канали як channel; MPIM як group.
• Прив’язки маршрутів Slack приймають сирі ID співрозмовників, а також форми цілей Slack, як-от channel:C12345678, user:U12345678 і <@U12345678>.
• З типовим session.dmScope=main DM Slack згортаються до основної сесії агента.
• Сесії каналів: agent:<agentId>:slack:channel:<channelId>.
• Відповіді в тредах можуть створювати суфікси сесій тредів (:thread:<threadTs>), коли це застосовно.
• У каналах, де OpenClaw обробляє повідомлення верхнього рівня без вимоги явної згадки, не-off replyToMode маршрутизує кожен оброблений кореневий елемент у agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, щоб видимий тред Slack від першого ходу відповідав одній сесії OpenClaw.
• Типове значення 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>]]

​

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

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

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

​

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

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

{
  "channels": {
    "slack": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

• Ланцюжок відповіді має бути доступний, щоб з’являлися нативне потокове передавання тексту та статус ланцюжка помічника Slack. Вибір ланцюжка все одно відповідає replyToMode.
• Корені каналів, групових чатів і DM верхнього рівня все ще можуть використовувати звичайний попередній перегляд чернетки, коли нативне потокове передавання недоступне або ланцюжка відповіді не існує.
• DM Slack верхнього рівня за замовчуванням залишаються поза ланцюжками, тому вони не показують нативний потоковий перегляд/перегляд статусу у стилі ланцюжків Slack; натомість OpenClaw публікує та редагує попередній перегляд чернетки в DM.
• Медіа та нетекстові корисні навантаження повертаються до звичайної доставки.
• Фінальні медіа/помилки скасовують очікувані редагування попереднього перегляду; придатні фінальні текстові/блокові повідомлення скидаються лише тоді, коли можуть редагувати попередній перегляд на місці.
• Якщо потокове передавання переривається посеред відповіді, OpenClaw повертається до звичайної доставки для решти корисних навантажень.

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

• channels.slack.streamMode (replace | status_final | append) є застарілим runtime-псевдонімом для channels.slack.streaming.mode.
• булевий channels.slack.streaming є застарілим runtime-псевдонімом для channels.slack.streaming.mode і channels.slack.streaming.nativeTransport.
• застарілий channels.slack.nativeStreaming є runtime-псевдонімом для channels.slack.streaming.nativeTransport.
• Запустіть openclaw doctor --fix, щоб переписати збережену конфігурацію потокового передавання Slack на канонічні ключі.

​

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

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

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

​

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

​

Команди та поведінка слеш-команд

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

/openclaw /help

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

/help

• до 5 параметрів: блоки кнопок
• 6-100 параметрів: статичне меню вибору
• понад 100 параметрів: зовнішній вибір з асинхронною фільтрацією параметрів, коли доступні обробники параметрів інтерактивності
• перевищено обмеження Slack: закодовані значення параметрів повертаються до кнопок

/think

​

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

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

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

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

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

​

Підтвердження виконання у Slack

• Підтвердження виконання використовують channels.slack.execApprovals.* для нативної маршрутизації DM/каналу.
• Підтвердження 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",
      },
    },
  },
}

​

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

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

​

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

​

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

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

openclaw pairing list slack

​

Довідка щодо зору для вкладень

​

Підтримувані типи медіа

​

Вхідний конвеєр

1. OpenClaw завантажує файл із приватної URL-адреси Slack за допомогою токена бота (xoxb-...).
2. У разі успіху файл записується до сховища медіа.
3. Шляхи завантажених медіа та типи вмісту додаються до вхідного контексту.
4. Шляхи моделей/інструментів із підтримкою зображень можуть використовувати вкладення зображень із цього контексту.
5. Файли, що не є зображеннями, залишаються доступними як файлові метадані або медіапосилання для інструментів, які можуть їх обробляти.

​

Успадкування вкладень кореневого повідомлення треду

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

​

Обробка кількох вкладень

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

​

Обмеження розміру, завантаження та моделей

• Обмеження розміру: типово 20 МБ на файл. Налаштовується через channels.slack.mediaMaxMb.
• Помилки завантаження: файли, які Slack не може надати, протерміновані URL-адреси, недоступні файли, завеликі файли та HTML-відповіді автентифікації/входу Slack пропускаються, а не повідомляються як непідтримувані формати.
• Модель зору: аналіз зображень використовує активну модель відповіді, коли вона підтримує зір, або модель зображень, налаштовану в agents.defaults.imageModel.

​

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

​

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

• Конвеєр розуміння медіа
• Інструмент PDF
• Епік: #51349 — увімкнення зору для вкладень Slack
• Регресійні тести: #51353
• Жива перевірка: #51354

​

Пов’язане