Slack Integration

Sidekick's Slack adapter connects your AI assistant to one or more Slack workspaces. Once authorised, Sidekick can read messages, post responses, react to events in real time, upload files, and handle slash commands — all autonomously, on your behalf.

Overview

Capability	Details
Event delivery	Slack Events API (real-time push)
Messaging	Channels, private channels, DMs
Threads	Read and reply in threads
Reactions	Add emoji reactions to messages
File uploads	Upload files to channels/conversations
Slash commands	Register and respond to custom commands

Connecting Your Workspace

1. Open the Integrations panel in your Sidekick dashboard.
2. Find Slack and click Connect.
3. You will be redirected to Slack's OAuth authorisation page. Select the workspace you want to connect and approve the requested permissions.
4. Once authorised, Sidekick registers the required event subscriptions and your workspace is live.

You can connect multiple workspaces by repeating this process.

How It Works

Real-Time Events

Sidekick uses the Slack Events API to receive workspace events as they happen. When Slack delivers an event (e.g. a new message, a reaction, a slash command invocation), Sidekick processes it and your AI assistant can act on it immediately — no polling, no delays.

Messaging

Your assistant can read and send messages in:

• Public channels — Any channel visible to the connected bot user.
• Private channels — Channels the bot has been invited to.
• Direct messages (DMs) — One-on-one and group DMs.

Threads

Sidekick preserves thread context. When replying within a thread, responses are scoped to that thread so conversations remain organised and readable for your teammates.

Reactions

The assistant can add emoji reactions to any message it has access to. This is useful for lightweight acknowledgements or status signals (e.g. reacting with ✅ when a task is picked up).

File Uploads

Sidekick can upload files — such as generated reports, code snippets, or documents — directly to a channel or conversation on your behalf.

Slash Commands

Custom slash commands can be registered in your workspace and routed to Sidekick. When a team member invokes a command, Sidekick receives the payload and your AI assistant handles the response.

Permissions

During OAuth authorisation, Sidekick requests the minimum set of Slack permission scopes required to power the capabilities above. You can review the exact scopes on the OAuth consent screen before approving.

Unified Adapter Architecture

The Slack integration is built on Sidekick's unified adapter architecture. This means Slack events and actions are available to the same AI workflows and automation rules as every other connected service — you can chain Slack actions with calendar updates, GitHub events, email triage, and more without any extra configuration.

ClawHub Compatibility

Community skills published on ClawHub that target Slack are fully compatible with Sidekick's Slack adapter. Local binary requirements referenced in SKILL.md files are automatically translated to equivalent cloud services.

Disconnecting

To disconnect a workspace, go to Integrations → Slack, select the workspace, and click Disconnect. Sidekick will immediately stop processing events from that workspace and revoke its event subscriptions.