Slack Setup

Overview

Connect Clawdbot to your Slack workspace, enabling Claude-powered assistance in channels, threads, and direct messages.

Prerequisites

• Clawdbot installed
• Slack workspace admin access

Setup

1. Create a Slack App

   • Go to Slack API
   • Click “Create New App”
   • Choose “From scratch”
   • Name: “Clawdbot”, select workspace

2. Configure Bot Permissions

   Navigate to OAuth & Permissions → Scopes → Bot Token Scopes:

   • app_mentions:read
   • channels:history
   • chat:write
   • im:history
   • im:read
   • im:write

3. Enable Event Subscriptions

   • Go to Event Subscriptions
   • Enable Events
   • Set Request URL: https://your-server/slack/events
   • Subscribe to: app_mention, message.im

4. Install to Workspace

   • Go to Install App
   • Click “Install to Workspace”
   • Copy the Bot User OAuth Token

5. Configure Clawdbot

   SLACK_ENABLED=true
   SLACK_BOT_TOKEN=xoxb-your-token
   SLACK_SIGNING_SECRET=your-signing-secret

6. Start Clawdbot

   python -m clawdbot

Configuration

.env

SLACK_ENABLED=true
SLACK_BOT_TOKEN=xoxb-xxx
SLACK_SIGNING_SECRET=xxx
SLACK_APP_TOKEN=xapp-xxx  # For Socket Mode

# Rate limiting
SLACK_RATE_LIMIT=20

# Channels to monitor (empty = all)
SLACK_ALLOWED_CHANNELS=C123,C456

# Thread behavior
SLACK_REPLY_IN_THREAD=true

Features

• Channel mentions: Respond when @mentioned
• Direct messages: Private conversations
• Thread support: Continue conversations in threads
• Slash commands: Custom /clawdbot command

Troubleshooting

Bot not responding?

• Verify Event Subscriptions URL is accessible
• Check bot token permissions
• Ensure app is installed to workspace

Missing messages?

• Enable required scopes
• Add bot to channels

Next Steps

• Telegram Setup
• Plugin Development