Slack Plugin

The Slack plugin connects Eliza agents to Slack workspaces as a bot app, handling messages in channels, DMs, and threads with support for slash commands and interactive components.

Package: @elizaos/plugin-slack

Installation

bash

eliza plugins install @elizaos/plugin-slack

Setup

1. Create a Slack App

Go to api.slack.com/apps
Click Create New App → From scratch
Name the app and select your workspace

2. Configure Bot Permissions

Navigate to OAuth & Permissions → Scopes → Bot Token Scopes and add:

Scope	Purpose
`app_mentions:read`	Receive @mentions
`channels:history`	Read channel messages
`channels:read`	List channels
`chat:write`	Post messages
`groups:history`	Read private channel messages
`im:history`	Read DM history
`im:read`	Access DM info
`im:write`	Send DMs
`mpim:history`	Read group DM history
`reactions:write`	Add reactions
`users:read`	Look up user info

3. Enable Socket Mode (Recommended for Development)

Navigate to Socket Mode and toggle it on. Generate an App-Level Token with the connections:write scope.

4. Enable Event Subscriptions

Navigate to Event Subscriptions and subscribe to bot events:

app_mention
message.channels
message.groups
message.im
message.mpim

5. Install to Workspace

Navigate to OAuth & Permissions and click Install to Workspace. Copy the Bot User OAuth Token (xoxb-...).

6. Configure Eliza

json

{
  "connectors": {
    "slack": {
      "botToken": "<SLACK_BOT_TOKEN>",
      "appToken": "<SLACK_APP_TOKEN>"
    }
  }
}

Configuration

Field	Required	Description
`botToken`	Yes	Bot User OAuth Token (`xoxb-...`)
`appToken`	No	App-Level Token for Socket Mode (`xapp-...`). Required for Socket Mode (default transport)
`mode`	No	Transport mode: `"socket"` (default) or `"http"`
`signingSecret`	No	Signing secret for HTTP mode webhook verification (required when `mode` is `"http"`)
`userToken`	No	User Token (`xoxp-...`) for user-scoped API calls
`enabled`	No	Set `false` to disable (default: `true`)
`groupPolicy`	No	Group/channel join policy: `"open"`, `"disabled"`, or `"allowlist"` (default: `"allowlist"`)

Features

Slash commands — Register and respond to /commands
@mentions — Responds when mentioned in channels
DMs — Full private conversation support
Threads — Participates in threaded replies
Reactions — Adds emoji reactions to messages
Socket Mode — Real-time event delivery without a public URL
Webhook mode — Production webhook endpoint support
Interactive components — Block Kit buttons and modals

Message Flow

Slack Event (via Socket Mode or webhook)
       ↓
Plugin validates event signature
       ↓
Determines response context:
  - app_mention → respond in channel thread
  - message.im → respond in DM
       ↓
AgentRuntime processes message
       ↓
Response posted to Slack channel/DM

Environment Variables

Variable	Required	Description
`SLACK_APP_TOKEN`	Yes	App-Level Token for Socket Mode (`xapp-...`)
`SLACK_BOT_TOKEN`	Yes	Bot User OAuth Token (`xoxb-...`)
`SLACK_USER_TOKEN`	No	User Token (`xoxp-...`) for user-scoped API calls
`SLACK_CHANNEL_IDS`	No	Comma-separated list of channel IDs to monitor
`SLACK_SIGNING_SECRET`	No	Signing secret for HTTP mode webhook verification
`SLACK_SHOULD_IGNORE_BOT_MESSAGES`	No	Ignore messages from other bots
`SLACK_SHOULD_RESPOND_ONLY_TO_MENTIONS`	No	Only respond when @mentioned

Auto-Enable

The plugin auto-enables when connectors.slack.botToken is set.

Thread Behavior

Thread history scope is configurable. By default, threads maintain isolated conversation history: