Slack

The Slack package supports explicit tools and an optional chat interface. Tools let the assistant inspect or act on Slack from another conversation. The chat interface lets admitted Slack users talk to the assistant inside Slack.

Install the Slack app

Use the ready-to-paste app manifest shown in Marketplace. It configures Socket Mode, interactivity, an App Home Messages tab, relevant events, bot scopes, and the /pneum command.

1. Create the Slack app from the manifest.
2. Create an app-level token with connections:write and copy the xapp-... value.
3. Install the app to the workspace and copy the bot token beginning xoxb-....
4. Enter both secrets when chat is enabled, or the bot token for tool-only use.

If Slack says messaging is turned off, enable the App Home Messages tab and allow users to send messages there, or update the app from the current manifest.

Allow channels

Use channel IDs rather than names. Copy a channel link and take the C... value after /archives/. Every channel argument is resolved and checked against this allowlist inside the adapter.

Select tools

Read tools cover allowed-channel listing, recent messages, threads, drafts, and users. Write tools cover posts, thread replies, updates to the bot’s own messages, and reactions. Enable the connector write toggle before selecting writes.

The chat interface does not require proactive Slack tools merely to reply to the triggering message.

Configure chat admission

Choose whether direct messages are disabled, limited to immutable Slack user IDs, or open to anyone who can reach the app. Open DMs are rate limited per user. In channels, optionally require an @mention; /pneum and approval buttons remain explicit invocations.

Approval messages use Approve and Deny buttons tied to the same immutable-user authorization as /ai approve and /ai deny.

Verify

Test a DM, an allowed channel mention, a disallowed channel, a thread reply, and an approval button. If the connector never becomes healthy, verify the xapp-... token, Socket Mode, app installation, event scopes, and that another process is not using the app connection unexpectedly.