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; поскольку это переопределение объекта, укажите все поля настройки сокета, необходимые для этой учётной записи.
• Значение по умолчанию в OpenClaw (15000) есть только у clientPingTimeout. 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": "простой <duration|off> или максимальный возраст <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 аудиофайл, событие диктовки, запрос или маркер источника ввода. Плагин OpenClaw для Slack не может включить или получать эти данные.
• Аудиоклипы 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": "Quarterly revenue",
      "categories": ["Q1", "Q2"],
      "series": [{ "name": "Revenue", "values": [120, 145] }],
      "xLabel": "Quarter"
    }
  ]
}

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

​

Нативные таблицы

{
  "blocks": [
    {
      "type": "table",
      "caption": "Open pipeline",
      "headers": ["Account", "Stage", "ARR"],
      "rows": [
        ["Acme", "Won", 125000],
        ["Globex", "Review", 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 (по умолчанию): без таймера присутствия и вызовов Slack API.
• 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 МБ на файл. Настраивается через channels.slack.mediaMaxMb.
• Ограничение транскрибирования аудио: tools.media.audio.maxBytes также применяется, когда загруженный файл отправляется поставщику транскрибирования или CLI.
• Ошибки загрузки: файлы, которые Slack не может предоставить, URL с истекшим сроком действия, недоступные и слишком большие файлы, а также HTML-ответы страницы аутентификации или входа Slack пропускаются, а не помечаются как неподдерживаемые форматы.
• Модель компьютерного зрения: для анализа изображений используется активная модель ответа, если она поддерживает компьютерное зрение, либо модель изображений, настроенная в agents.defaults.imageModel.

​

Известные ограничения

​

Связанная документация

• Процесс распознавания медиафайлов
• Аудио и голосовые заметки
• Инструмент PDF

​

Связанные материалы