> ## Documentation Index
> Fetch the complete documentation index at: https://clawhqplatform.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Connect your ClawHQ agents to Slack.

## Create a Slack app

<Steps>
  <Step title="Create the app">
    Go to [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App → From scratch**.

    Name it (e.g. "Mike") and select your workspace.
  </Step>

  <Step title="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`
  </Step>

  <Step title="Enable Event Subscriptions">
    Go to **Event Subscriptions** and toggle it on.

    Set the Request URL to: `https://your-clawhq-domain.com/api/channels/slack/events`

    Subscribe to these bot events:

    * `app_mention`
    * `message.im`
  </Step>

  <Step title="Install to workspace">
    Go to **OAuth & Permissions** and click **Install to Workspace**.

    Copy the **Bot User OAuth Token** (starts with `xoxb-`).
  </Step>

  <Step title="Add the token to ClawHQ">
    In the ClawHQ dashboard, go to **Settings → Channels → Slack**.

    Paste your Bot Token and click **Save**.
  </Step>
</Steps>

## 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