Connect Slack

Table of contents

1. Create a Slack App
2. Enable Bot Token Scopes
3. Install to Workspace
4. Login Command
5. Invite the Bot
6. Next Steps
7. FAQ

Create a Slack App

1. Go to api.slack.com/apps
2. Click “Create New App”
3. Choose “From scratch”
4. Enter an app name (e.g., “OpenClaw Bot”)
5. Select your workspace
6. Click “Create App”

Enable Bot Token Scopes

1. In the app sidebar, go to “OAuth & Permissions”
2. Scroll to “Scopes” > “Bot Token Scopes”
3. Click “Add an OAuth Scope”
4. Add: app_mentions:read, chat:write, channels:history, users:read

Install to Workspace

1. Scroll up to “OAuth Tokens for Your Workspace”
2. Click “Install to Workspace”
3. Review permissions and click “Allow”
4. Copy the Bot User OAuth Token (starts with xoxb-)

Login Command

Run the login command with your token:

openclaw channels login slack --token YOUR_TOKEN

Replace YOUR_TOKEN with the Bot User OAuth Token.

Invite the Bot

• DM: Open a direct message with @YourBotName
• Channel: Type /invite @YourBotName in any channel
• Mentions: Mention @YourBotName to trigger

Next Steps

• Getting Started Overview
• Allowlists and Sender Policies
• Daily Brief Workflow
• Slack Setup Guide
• Slack Troubleshooting

FAQ

Q: Do I need both Bot and App tokens?
A: Only Bot token is required for basic use. App token enables Events API.

Q: How do I limit which channels the bot joins?
A: Configure channels.slack.allowChannels in openclaw.json.

Q: What if the bot doesn’t respond?
A: Ensure it’s invited and that you’re mentioning it. Check logs.

Q: Can I use slash commands?
A: Yes. Configure slash commands in the Slack app and map them to OpenClaw skills.

Q: How do I disconnect?
A: Run openclaw channels logout slack.

Recommended next

Connect Discord