Slack

Connect your LemonClaw instance to a Slack workspace using Socket Mode

Add an AI assistant to your Slack workspace using Socket Mode — no public URL required. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments.

Prerequisites

• A Slack workspace where you have admin access
• A LemonClaw instance:
  • Hosted: create a Claw instance
  • Self-hosted: install LemonClaw

Setup Guide

1. Create a Slack App

   1. Go to Slack API and click Create New App
   2. Choose From scratch
   3. Enter an app name (e.g., “AI Assistant”) and select your workspace
   4. Click Create App
2. Enable Socket Mode

   1. In the left sidebar, go to Socket Mode
   2. Toggle Enable Socket Mode to ON
   3. Give the token a name (e.g., “claw-socket”) and click Generate
   4. Copy the App-Level Token (starts with xapp-) — you’ll need this
3. Configure Bot Permissions

   1. Go to OAuth & Permissions in the sidebar
   2. Under Bot Token Scopes, add these scopes:
      • chat:write — Send messages
      • im:history — Read DM history
      • im:read — View DMs
      • im:write — Start DMs
      • app_mentions:read — Detect @mentions
   3. Click Install to Workspace at the top
   4. Authorize the app
   5. Copy the Bot User OAuth Token (starts with xoxb-)
4. Enable Events

   1. Go to Event Subscriptions in the sidebar
   2. Toggle Enable Events to ON
   3. Under Subscribe to bot events, add:
      • message.im — Messages in DMs
      • app_mention — @mentions in channels
   4. Click Save Changes
5. Open the LemonClaw WebUI

   1. If you’re using hosted Claw, go to your Claw Dashboard and click Open WebUI
   2. If you’re self-hosting LemonClaw, open your own WebUI (for example http://your-ip:18789) and sign in with your token
   3. In the WebUI, navigate to Settings → Channels
   4. Expand the Slack section
   5. Paste your App Token (xapp-...) and Bot Token (xoxb-...)
   6. Click Save
6. Start Chatting

   1. In Slack, send a DM to your bot or @mention it in a channel
   2. The first user is automatically paired as the owner — no code needed!
   3. Start chatting with AI!

Access Control

Group Settings

Configure channel access in the Channels settings of your LemonClaw WebUI:

Setting	Options	Description
Group Policy	Open (default) / Allowlist / Disabled	Controls which channels the bot responds in
Require @mention	On / Off	Bot only responds when @mentioned
Group IDs	List of channel IDs	Restrict to specific channels (empty = all channels)
Group Allowed Users	List of user IDs	Only these users can trigger the bot (allowlist mode)

By default, Slack uses the open group policy — the bot responds in all channels it’s invited to. Use allowlist to restrict to specific channels.

Troubleshooting

Bot doesn't respond to DMs

• Verify both tokens are correct (App Token starts with xapp-, Bot Token with xoxb-)
• Check that message.im event is subscribed
• Make sure the app is installed to your workspace

Bot doesn't respond to @mentions

• Check that app_mentions:read scope and app_mention event are configured
• The bot must be invited to the channel first (type /invite @botname)

'not_allowed_token_type' error

• Make sure you’re using the App-Level Token (xapp-) for the App Token field, not the Bot Token
• The Bot Token (xoxb-) goes in the Bot Token field