TextClaw

Slack

Bring your agent into Slack so your team can interact with it in any channel.

How it works

Your agent connects to Slack using Socket Mode, which means it listens for messages in real-time without needing a public URL. You'll create a Slack app, grab two tokens, and paste them into TextClaw.

Create a Slack app

  1. Go to api.slack.com/apps and click Create New App.
  2. Choose From scratch and give it a name.
  3. Select the workspace you want to install it in.

Enable Socket Mode

  1. In your app settings, go to Socket Mode in the left sidebar.
  2. Toggle Enable Socket Mode on.
  3. You'll be prompted to create an App-Level Token. Give it the connections:write scope.
  4. Copy the token (starts with xapp-). You'll need this in a moment.

Set up bot permissions

  1. Go to OAuth & Permissions in the left sidebar.
  2. Under Bot Token Scopes, add these scopes:
  • app_mentions:read
  • channels:history
  • chat:write
  • groups:history
  • im:history
  • mpim:history
  1. Click Install to Workspace and authorize.
  2. Copy the Bot User OAuth Token (starts with xoxb-).

Subscribe to events

  1. Go to Event Subscriptions and toggle it on.
  2. Under Subscribe to bot events, add:
  • app_mention
  • message.channels
  • message.groups
  • message.im
  • message.mpim

Connect to TextClaw

  1. Go to your TextClaw dashboard.
  2. Click Add Slack on the Slack card.
  3. Paste your App Token (xapp-...) and Bot Token (xoxb-...).
  4. Click Connect. Your agent will come online in Slack within a few seconds.

Using your agent in Slack

  • Invite the bot to any channel where you want it to participate.
  • Mention the bot with @name to get its attention.
  • In DMs, the bot responds to every message.