Slack Setup

Prerequisites

• OpenClaw installed and running
• Slack workspace admin rights (to install a custom app)
• A public HTTPS endpoint for the Slack webhook (or use ngrok for local testing)

Step 1 — Create a Slack App

1. Go to api.slack.com/apps and click Create New App
2. Choose From Scratch, name your app, and select your workspace
3. Under OAuth & Permissions, add scopes: chat:write, im:history, im:read, channels:history
4. Click Install to Workspace and copy the Bot User OAuth Token

Step 2 — Enable Event Subscriptions

1. Go to Event Subscriptions and enable it
2. Set the Request URL to: https://yourdomain.com/channels/slack/webhook
3. Subscribe to bot events: message.im, message.channels
4. Save changes and reinstall the app

Step 3 — Configure OpenClaw

openclaw channels add slack

Enter your Bot Token and Signing Secret when prompted. Then verify the channel is active:

openclaw channels list