Create Slack App

1. Go to Slack API Dashboard: https://api.slack.com/apps

2. Create New App:

   • Click "Create New App"
   • Choose "From scratch"
   • App Name: OpenClaw Bot (or your preferred name)
   • Pick a workspace: Select your development workspace
   • Click "Create App"

Enable Socket Mode

1. Go to Settings → Socket Mode (left sidebar)
2. Toggle "Enable Socket Mode" → ON
3. Generate App-Level Token:
   • Token Name: openclaw-socket
   • Scopes: Select connections:write
   • Click "Generate"
   • Copy the App Token (starts with xapp-) - save it securely!

Configure Bot Token Scopes

1. Go to Features → OAuth & Permissions
2. Scroll to "Scopes" → "Bot Token Scopes"
3. Click "Add an OAuth Scope" and add these scopes:
   • app_mentions:read - See @mentions of the bot
   • channels:history - View messages in public channels
   • channels:read - View basic channel information
   • chat:write - Send messages
   • groups:history - View messages in private channels
   • groups:read - View basic private channel info
   • im:history - View messages in DMs
   • im:read - View basic DM info
   • im:write - Start direct messages
   • mpim:history - View messages in group DMs
   • mpim:read - View basic group DM info
   • users:read - View people in workspace

Install App to Workspace

1. Stay on OAuth & Permissions page
2. Click "Install to Workspace" (top of page)
3. Review permissions → Click "Allow"
4. Copy the Bot User OAuth Token (starts with xoxb-) - save it securely!

Enable Event Subscriptions

1. Go to Features → Event Subscriptions
2. Toggle "Enable Events" → ON
3. Subscribe to bot events:
   • Click "Add Bot User Event"
   • Add these events:
     • app_mention - When bot is @mentioned
     • message.channels - Messages in public channels
     • message.groups - Messages in private channels
     • message.im - Direct messages to bot
     • message.mpim - Group direct messages
4. Click "Save Changes"

Get Slack IDs

Get Channel ID

• Open Slack workspace in browser or desktop app
• Go to the channel (e.g., #general)
• Click channel name at top → View details
• Scroll down → Channel ID (e.g., C04ABC12345)

Or right-click channel → Copy → Copy Link

• Link format: https://yourworkspace.slack.com/archives/C04ABC12345
• The ID is after /archives/

Get User ID

• Click on your profile picture → Profile
• Click ••• (More) → Copy member ID
• Format: U04ABC12345

Get Workspace/Team ID (if needed)

• Go to workspace settings
• Or extract from any Slack URL: https://app.slack.com/client/T04ABC12345/...
• Format: T04ABC12345

Add Slack Configuration

Set environment variables:

# Slack Configuration
SLACK_BOT_TOKEN=xoxb-YOUR-BOT-TOKEN-HERE
SLACK_APP_TOKEN=xapp-YOUR-APP-TOKEN-HERE

Update configuration file ~/.openclaw/openclaw.json:

{
  "channels": {
    "slack": {
      "enabled": true,
      "socketMode": true,
      "dm": {
        "enabled": true,
        "policy": "allowlist",
        "allowFrom": ["U04ABC12345"]
      },
      "groupPolicy": "allowlist",
      "channels": {
        "C04ABC12345": {
          "allow": true,
          "requireMention": false
        }
      },
      "teams": {
        "T04ABC12345": {
          "users": ["U04ABC12345"]
        }
      }
    }
  },
  "plugins": {
    "entries": {
      "slack": {
        "enabled": true
      }
    }
  }
}

Replace with your IDs:

• xoxb-... - Your Slack Bot Token
• xapp-... - Your Slack App Token
• U04ABC12345 - Your Slack user ID
• C04ABC12345 - Your channel ID
• T04ABC12345 - Your workspace/team ID

Invite Bot to Channels

After configuration, invite the bot to channels:

1. Go to the Slack channel (e.g., #general)
2. Type: /invite @OpenClaw Bot
3. Press Enter
4. Bot will join the channel

Or:

• Click channel name → Integrations tab
• Click "Add apps" → Find your bot → Add