Skip to main content

​
Create a Slack app

1

Create the app

Go to api.slack.com/apps and click Create New App → From scratch.Name it (e.g. “Mike”) and select your workspace.
2

Set OAuth scopes

In the sidebar, click OAuth & Permissions → Scopes → Bot Token Scopes.Add these scopes:
  • app_mentions:read
  • channels:history
  • channels:read
  • chat:write
  • im:history
  • im:read
  • im:write
  • users:read
3

Enable Event Subscriptions

Go to Event Subscriptions and toggle it on.Set the Request URL to: https://your-clawhq-domain.com/api/channels/slack/eventsSubscribe to these bot events:
  • app_mention
  • message.im
4

Install to workspace

Go to OAuth & Permissions and click Install to Workspace.Copy the Bot User OAuth Token (starts with xoxb-).
5

Add the token to ClawHQ

In the ClawHQ dashboard, go to Settings → Channels → Slack.Paste your Bot Token and click Save.

​
Talk to your agent

Mention your bot in any channel: 
@Mike summarize the last 20 messages in #engineering
@Scout research our top competitor's pricing page
Or DM the bot directly for private tasks.

​
Troubleshooting

Events not arriving
  • Verify your ClawHQ URL is publicly accessible (not localhost)
  • Check the Event Subscriptions page for delivery errors
  • Ensure all required scopes are added and the app is reinstalled
“not_authed” errors
  • Your token may have expired — reinstall the app to get a fresh token