Slack Setup Guide
Socket Mode is the default production setup; HTTP Events API mode is also supported.
1) Prerequisites
- Slack App with Socket Mode enabled
- App Token: xapp-...
- Bot Token: xoxb-...
- Subscribe to core events (message.*, app_mention, etc.)
2) Quick Setup (Socket Mode)
{
channels: {
slack: {
enabled: true,
mode: "socket",
appToken: "xapp-...",
botToken: "xoxb-..."
}
}
}
Default account can also use env fallback: SLACK_APP_TOKEN / SLACK_BOT_TOKEN.
3) Start and Verify
openclaw gateway
openclaw channels status --probe
openclaw pairing list slack
openclaw pairing approve slack <CODE>
4) Common Issues (Official High-Signal)
- Socket connected but no responses: verify appToken, botToken, and scopes.
- DM blocked: verify pairing status and dmPolicy.
- Channel messages ignored: check groupPolicy and channel allowlist.