Slack Setup
Workspace-level Slack install and production requirements for the OpenClaw bot.
Slack setup is admin-driven in the current architecture. This bot runs through OpenClaw in Slack Socket Mode, which means a normal user-facing OAuth install is not enough on its own.
A workspace admin can install the app for the company, but Socket Mode still requires an app-level token (`xapp`) to be provisioned in Slack app settings and added to the server environment. Individual reps do not need to install anything once the workspace bot is configured.
Slack bot token
Required for the bot user to post and read messages in the workspace.
Slack app token
Required for Socket Mode. This is not issued by standard Add to Slack OAuth.
Slack OAuth client
Optional for future install UX. Useful for linking back to the Slack app install flow.
Socket Mode runtime
Current runtime model. Good for internal deployments, but admin-managed.
Admin Checklist
- Create or open the Slack app for your company workspace.
- Enable Socket Mode and generate an app-level token.
- Install the app to the workspace and collect the bot token.
- Set `SLACK_TOKEN`, `SLACK_BOT_TOKEN`, and optionally `SLACK_CLIENT_ID` on DigitalOcean.
- Restart the OpenClaw gateway so the new tokens are loaded.
- After that, reps can use the bot directly in Slack without per-user installs.