Slack

Готовий до production-використання для DM і каналів через інтеграції Slack app. Режим за замовчуванням — Socket Mode; HTTP Request URLs також підтримуються.

# Вибір між Socket Mode і HTTP Request URLs

Обидва транспорти готові до production-використання й мають паритет функцій для обміну повідомленнями, slash commands, App Home та інтерактивності. Обирайте за формою розгортання, а не за функціями.

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

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

{
"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",
"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",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

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

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

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

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

Використовуйте це лише для робочих просторів Socket Mode, які логують тайм-аути Slack websocket pong/server-ping, або запускаються на хостах з відомим виснаженням event loop. clientPingTimeout — це очікування pong після того, як SDK надсилає клієнтський ping; serverPingTimeout — це очікування ping від сервера Slack. Повідомлення й події app залишаються станом застосунку, а не сигналами працездатності транспорту.

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

Базовий маніфест Slack app однаковий для Socket Mode і HTTP Request URLs. Відрізняється лише блок settings (і url slash command).

Базовий маніфест (типово 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
    },
    "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"
      ]
    }
  }
}

Для режиму HTTP Request URLs замініть settings на HTTP-варіант і додайте url до кожного slash command. Потрібна публічна 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",
        "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"
    }
  }
}

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

Відкрийте різні функції, які розширюють наведені вище типові значення.

Типовий маніфест вмикає вкладку Home у Slack App Home і підписується на app_home_opened. Коли учасник робочого простору відкриває вкладку Home, OpenClaw публікує безпечний типовий Home view за допомогою views.publish; payload розмови або приватна конфігурація не включаються. Вкладка Messages залишається ввімкненою для Slack DM.

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

# Дії та шлюзи

Дії Slack керуються через channels.slack.actions.*.

Доступні групи дій у поточному інструментарії Slack:

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

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

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

• 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>), коли це застосовно.
• 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>]]

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

ackReaction надсилає emoji підтвердження, поки OpenClaw обробляє вхідне повідомлення.

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

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

Примітки:

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

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

channels.slack.streaming керує поведінкою попереднього перегляду наживо:

• off: вимкнути потокове передавання попереднього перегляду наживо.
• 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 має бути доступний тред відповіді. Вибір треду досі відповідає replyToMode.
• Канал, груповий чат і кореневі DM верхнього рівня досі можуть використовувати звичайну чернетку попереднього перегляду, коли нативне потокове передавання недоступне або треду відповіді немає.
• DM Slack верхнього рівня за замовчуванням залишаються поза тредом, тому вони не показують нативний потоковий/статусний попередній перегляд Slack у стилі треду; натомість OpenClaw публікує та редагує чернетку попереднього перегляду в DM.
• Медіа та нетекстові payload повертаються до звичайної доставки.
• Фінальні медіа/помилки скасовують очікувані редагування попереднього перегляду; придатні текстові/блокові фінали скидаються лише тоді, коли можуть редагувати попередній перегляд на місці.
• Якщо потокове передавання не вдається посеред відповіді, OpenClaw повертається до звичайної доставки для решти payload.

Використовуйте чернетку попереднього перегляду замість нативного потокового передавання тексту Slack:

{
  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 на канонічні ключі.

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

typingReaction додає тимчасову реакцію до вхідного повідомлення Slack, поки OpenClaw обробляє відповідь, а потім прибирає її після завершення запуску. Це найкорисніше поза відповідями в тредах, які використовують типовий індикатор стану "is typing...".

Порядок розв’язання:

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

Примітки:

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

# Медіа, фрагментація та доставка

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

Slash-команди відображаються в Slack або як одна налаштована команда, або як кілька нативних команд. Налаштуйте channels.slack.slashCommand, щоб змінити типові значення команд:

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

/openclaw /help

Нативні команди потребують додаткових налаштувань manifest у вашому застосунку Slack і натомість вмикаються через channels.slack.commands.native: true або commands.native: true у глобальних конфігураціях.

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

/help

Меню аргументів нативних команд використовують адаптивну стратегію рендерингу, яка показує модальне вікно підтвердження перед dispatch вибраного значення опції:

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

/think

Slash-сесії використовують ізольовані ключі на кшталт agent:<agentId>:slack:slash:<userId> і все одно маршрутизують виконання команд до цільової сесії розмови за допомогою CommandTargetSessionKey.

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

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.

Примітки:

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

# Exec-схвалення в Slack

Slack може діяти як нативний клієнт схвалення з інтерактивними кнопками та взаємодіями замість fallback до Web UI або термінала.

• Exec-схвалення використовують channels.slack.execApprovals.* для нативної маршрутизації DM/каналом.
• Схвалення Plugin усе ще можуть розв’язуватися через ту саму нативну поверхню кнопок Slack, коли запит уже потрапляє в Slack, а вид ID схвалення — plugin:.
• Авторизація схвалювача все ще застосовується: лише користувачі, визначені як схвалювачі, можуть схвалювати або відхиляти запити через Slack.

Це використовує ту саму спільну поверхню кнопок схвалення, що й інші канали. Коли 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" і принаймні один схвалювач розв’язується. Установіть enabled: false, щоб явно вимкнути Slack як нативний клієнт схвалення. Установіть enabled: true, щоб примусово ввімкнути нативні схвалення, коли схвалювачі розв’язуються.

Типова поведінка без явної конфігурації exec-схвалення Slack:

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

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

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

Спільне переспрямування approvals.exec є окремим. Використовуйте його лише тоді, коли запити exec-схвалення також мають маршрутизуватися до інших чатів або явних позаканальних цілей. Спільне переспрямування approvals.plugin також окреме; нативні кнопки Slack усе ще можуть розв’язувати схвалення Plugin, коли ці запити вже потрапляють у Slack.

Same-chat /approve також працює в каналах Slack і DM, які вже підтримують команди. Див. Exec-схвалення, щоб переглянути повну модель переспрямування схвалень.

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

• Редагування/видалення повідомлень зіставляються із системними подіями.
• Трансляції тредів (відповіді в тредах "Also send to channel") обробляються як звичайні повідомлення користувача.
• Події додавання/видалення реакцій зіставляються із системними подіями.
• Події входу/виходу учасника, створення/перейменування каналу та додавання/видалення pin зіставляються із системними подіями.
• channel_id_changed може мігрувати ключі конфігурації каналу, коли ввімкнено configWrites.
• Метадані теми/призначення каналу розглядаються як недовірений контекст і можуть бути впроваджені в контекст маршрутизації.
• Початкове повідомлення треду та початкове засівання контексту історії треду фільтруються за налаштованими allowlist-ами відправників, коли застосовно.
• Block actions і модальні взаємодії створюють структуровані системні події Slack interaction: ... з багатими полями payload:
  • block actions: вибрані значення, мітки, значення picker-а та метадані workflow_*
  • події модальних view_submission і view_closed з маршрутизованими метаданими каналу та введеннями форми

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

Основний довідник: Довідник конфігурації - Slack.

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

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

openclaw pairing list slack

# Довідник vision для вкладень

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

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

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

Коли надходить повідомлення Slack із файловими вкладеннями:

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

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

Коли повідомлення надходить у гілці (має батьківський thread_ts):

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

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

Коли одне повідомлення Slack містить кілька файлових вкладень:

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

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

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

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

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

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

# Пов’язане