OpenClaw Slack Integration: Channel Setup and Multi-Agent Configuration

OpenClaw Slack Integration: Channel Setup and Multi-Agent Configuration

OpenClaw Slack Integration: Channel Setup and Multi-Agent Configuration

By David Park | February 7, 2026


OpenClaw Slack Integration: Channel Setup and Multi-Agent Configuration

Slack is a popular choice for team communication. This guide covers setting up OpenClaw with Slack, configuring threading, and routing messages to different agents.

---

Prerequisites

Before setting up Slack, you need:

1. Slack Workspace Admin Access — To create apps 2. Slack App — Created in api.slack.com 3. Bot Token — With required scopes

---

Step 1: Create a Slack App

1. Go to Slack API Dashboard 2. Click "Create New App" 3. Choose "From scratch" 4. Name your app (e.g., "OpenClaw Assistant") 5. Select your workspace

---

Step 2: Configure Bot Scopes

Go to OAuth & PermissionsScopes:

Required Scopes

chat:write        # Send messages chat:write.public # Post to channels channels:history  # Read channel history channels:read     # List channels groups:history    # Read private channels groups:read       # List private channels im:history        # Read DMs im:read           # List DMs mpim:history      # Read group DMs mpim:read         # List group DMs users:read        # Read user profiles 

Optional Scopes

reactions:write   # Add emoji reactions files:write       # Upload files emoji:read        # List custom emoji pins:write        # Pin messages 

---

Step 3: Install the App

1. Go to OAuth & Permissions 2. Click "Install to Workspace" 3. Review permissions and allow

Save the Bot User OAuth Token — starts with xoxb-

---

Step 4: Configure OpenClaw

Basic Setup

# Set bot token openclaw config set discord.token "xoxb-your-token"

Enable Slack

openclaw config set discord.enabled true

Full Configuration

{   "channels": {     "slack": {       "enabled": true,       "token": "xoxb-your-bot-token",       "appToken": "xapp-your-app-token",       "signingSecret": "your-signing-secret"     }   } } 

---

Step 5: Add Bot to Channels

Invite the Bot

In Slack, invite your bot to relevant channels:

/invite @OpenClaw 

Enable in Private Channels

Private channels require the bot be added directly.

---

Threading Configuration

Reply Modes

OpenClaw can reply in threads or the main channel:

# Reply in thread (default) openclaw config set channels.slack.replyToMode "thread"

Reply in main channel

openclaw config set channels.slack.replyToMode "channel"

Hybrid mode (auto-detect)

openclaw config set channels.slack.replyToMode "auto"

Per-Channel Configuration

{   "channels": {     "slack": {       "replyToModeByChatType": {         "dm": "thread",         "groupdm": "thread",         "private_channel": "channel",         "public_channel": "channel"       }     }   } } 

---

Multi-Agent Routing

Route by Channel

{   "channels": {     "slack": {       "bindings": {         "channel:general": "main",         "channel:dev-team": "work-agent",         "channel:random": "personal-agent"       }     }   } } 

Route by User

{   "channels": {     "slack": {       "bindings": {         "user:U12345678": "personal-agent",         "user:U87654321": "work-agent"       }     }   } } 

Route by Emoji Reaction

{   "channels": {     "slack": {       "reactionRouting": {         "🤖": "main",         "📝": "writing-agent",         "💻": "coding-agent"       }     }   } } 

---

Slash Commands

Create Slash Commands

In Slack API dashboard, go to Slash CommandsCreate New Command:

CommandURLDescription
/openclawhttps://your-domain.com/slack/commandsMain OpenClaw interface
/askhttps://your-domain.com/slack/askQuick question
/statushttps://your-domain.com/slack/statusCheck agent status

Configure in OpenClaw

# Enable slash commands openclaw config set channels.slack.slashCommands.enabled true

Define command aliases

openclaw config set channels.slack.slashCommands.aliases ["/oc", "/ask"]

---

Event Subscriptions

Enable Events

1. Go to Event Subscriptions in Slack API 2. Enable events 3. Subscribe to events:

message.channels      # Channel messages message.groups        # Private channel messages message.im            # DM messages message.mpim          # Group DM messages reaction_added        # Emoji reactions 

Configure Request URL

Your gateway handles events automatically:

https://your-domain.com/slack/events 

---

Troubleshooting Slack

Bot Not Responding

# Check bot status openclaw channels slack status

Verify token

openclaw config get channels.slack.token

Check permissions

Ensure all required scopes are granted

Permission Errors

# Common issues: 

- Missing scopes (reinstall app)

- Token expired (reinstall)

- Channel not in scope (reinstall)

Reinstall app

openclaw config unset channels.slack.token

Then reconfigure with new token

Message Formatting

# Enable markdown openclaw config set channels.slack.parseMarkdown true

Maximum message length

openclaw config set channels.slack.maxMessageLength 4000

---

Security Best Practices

Limit Channel Access

{   "channels": {     "slack": {       "allowedChannels": ["C01234567", "C08765432"],       "blockedChannels": ["C11111111"]     }   } } 

Restrict DM Access

{   "channels": {     "slack": {       "dmPolicy": "allowlist",       "dmAllowlist": ["U01234567", "U87654321"]     }   } } 

Audit Logging

# Enable audit logging openclaw config set channels.slack.auditLog true

View logs

openclaw channels slack logs --type audit

---

Further Reading

  • OpenClaw Slack Documentation
  • Slack API Documentation
  • LumaDock: OpenClaw Slack Integration
  • ---

    Related Articles:

  • OpenClaw Channel Setup: Connect Telegram, Discord, and WhatsApp
  • OpenClaw Multi-Agent Setup: Run Multiple AI Assistants
  • OpenClaw Troubleshooting: Fix Common Gateway and Startup Errors

  • Tags: OpenClaw, AI, Tutorial

    Comments

    Popular posts from this blog

    OpenClaw Tools vs Skills: Understanding the Mental Model

    OpenClaw Sub-Agents: How to Run Parallel Tasks Efficiently