Slack

Slack support covers DMs and channels via Slack app integrations. Default transport is Socket Mode. HTTP Request URLs are also supported. Relay mode is for managed deployments where a trusted router owns Slack ingress.

What each page covers

• Slack setup — install the plugin, create the Slack app, and configure tokens.
• Slack transports — Socket Mode, HTTP Request URLs, and relay mode compared.
• Slack Enterprise Grid — org-wide installs across a Grid organization.
• Slack manifest and scopes — the base app manifest, OAuth scopes, and optional settings.
• Slack access control — DM policy, channel allowlists, mention gating, and action gates.
• Slack threads and sessions — session keys, reply threading, and Agent View DMs.
• Slack message behavior — ack reactions, streaming previews, and slash commands.
• Slack media and attachments — audio clips, inbound files, chunking, and delivery targets.
• Slack charts, tables, and approvals — native charts, tables, modals, and approval buttons.
• Slack events and operations — system events, interactions, and presence polling.
• Slack troubleshooting — silent channels, ignored DMs, and dead transports.

Huddles

Use the separate Slack huddles plugin to call an agent into an active huddle. It drives Slack in the OpenClaw Chrome profile, signed in as a dedicated Slack user account. Slack app and bot tokens cannot join huddles or read their audio.

Where each section moved

Every section heading from the previous single-page version keeps its anchor here, so an existing link such as /channels/slack#text-streaming still resolves. Each entry points at the page that now holds the content.

• Choosing a transport
• Relay mode
• Enterprise Grid org-wide installs
• Socket Mode
• HTTP Request URLs
• Install
• Quick setup
• User identity (post as a real person)
• Socket Mode transport tuning
• Manifest and scope checklist
• Additional manifest settings
• Token model
• Actions and gates
• Access control and routing
• Group DMs (MPDMs) and bots
• Threading, sessions, and reply tags
• Agent View DMs
• Ack reactions
• Emoji (ackReaction)
• Scope (messages.ackReactionScope)
• Text streaming
• Typing reaction fallback
• Voice input
• Media, chunking, and delivery
• Commands and slash behavior
• Native charts
• Native tables
• Plugin-owned modal submissions
• Native approvals in Slack
• Events and operational behavior
• Presence events
• Troubleshooting
• Attachment media reference
• Supported media types
• Inbound pipeline
• Thread-root attachment inheritance
• Multi-attachment handling
• Size, download, and model limits
• Known limits
• Related documentation
• User identity (post as a real person)
• Group DMs (MPDMs) and bots
• Threading, sessions, and reply tags
• Emoji (ackReaction)
• Scope (messages.ackReactionScope)
• Media, chunking, and delivery
• Size, download, and model limits
• Socket Mode (default)
• Create a new Slack app
• Configure OpenClaw
• Start gateway
• HTTP Request URLs
• Create a new Slack app
• Configure OpenClaw
• Start gateway
• Optional native slash commands
• Socket Mode (default)
• HTTP Request URLs
• Optional authorship scopes (write operations)
• Optional user-token scopes (read operations)
• DM policy
• Channel policy
• Mentions and channel users
• Inbound attachments
• Outbound text and files
• Delivery targets
• No replies in channels
• DM messages ignored
• Agent View DMs share one session
• Socket mode not connecting
• HTTP mode not receiving events
• Native/slash commands not firing

Configuration reference

Primary reference: Configuration reference - Slack.

High-signal Slack fields

• mode/auth: postAs, mode, botToken, appToken, userToken, signingSecret, webhookPath, accounts.*
• DM access: dm.enabled, dmPolicy, allowFrom (legacy: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
• compatibility toggle: dangerouslyAllowNameMatching (break-glass, keep off unless needed)
• channel access: groupPolicy, channels.*, channels.*.users, channels.*.requireMention, requireMentionInBotThreads (also per account/channel), implicitMentions.*
• group introductions: joinIntro, accounts.*.joinIntro (default: true)
• threading/history: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
• presence wakes: presenceEvents.mode, presenceEvents.prompt, channels.*.presenceEvents.* (off|auto|on, default off)
• delivery: textChunkLimit, streaming.chunkMode, mediaMaxMb, streaming, streaming.nativeTransport, streaming.preview.toolProgress
• unfurls: unfurlLinks (default: false), unfurlMedia for chat.postMessage link/media preview control. Set unfurlLinks: true to opt back into link previews
• ops/features: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

Related