Skip to main content

​
Prerequisites

  • A Slack workspace where you have admin permissions
  • A running Suji instance

​
Create a Slack App

1

Go to the Slack API portal

Navigate to api.slack.com/apps and click Create New App. Choose From scratch.
2

Name your app

Enter an app name and select the workspace to install it in.
3

Enable Socket Mode

Go to Socket Mode in the left sidebar and enable it. Give your app-level token a name (e.g., suji-connection) and click Generate.Copy the App-Level Token — it starts with xapp-.
4

Enable Event Subscriptions

Go to Event Subscriptions and enable events. Under Subscribe to bot events, add:
  • message.channels
  • message.groups
  • message.im
  • message.mpim
  • app_mention
5

Set bot token scopes

Go to OAuth & Permissions. Under Bot Token Scopes, add:
  • chat:write
  • channels:history
  • groups:history
  • im:history
  • mpim:history
  • app_mentions:read
6

Install to workspace

Go to Install App and click Install to Workspace. Authorize the requested permissions.Copy the Bot User OAuth Token — it starts with xoxb-.

​
Connect to Suji

1

Go to your instance

Open your instance in the Suji dashboard and click the Connectors tab.
2

Add Slack connector

Click Add Connector and select Slack.
3

Enter credentials

  • botToken: Your Bot User OAuth Token (xoxb-...)
  • appToken: Your App-Level Token (xapp-...)
4

Save

Click Save. The connector status should change to Connected within a few seconds.

​
Verify the Connection

Invite your bot to a channel (type /invite @your-bot-name) and send a message. Your OpenClaw agent should respond.

​
Troubleshooting

  • Make sure the bot is invited to the channel
  • Verify message.channels event subscription is enabled
  • Check that channels:history scope is granted
  • Verify the App-Level Token (xapp-) is correct
  • Make sure Socket Mode is enabled in the Slack API portal
  • Check the instance logs for WebSocket connection errors
  • Go to OAuth & Permissions and verify all required scopes are added
  • Re-install the app to the workspace after adding new scopes