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.

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, 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