Slack - profClaw

profClaw’s Slack integration supports both Socket Mode (recommended, no public URL needed) and HTTP webhook mode. It handles slash commands, direct messages, app mentions, and interactive components.

Capabilities

Feature	Supported
Direct messages	Yes
Channel messages	Yes (on mention)
Slash commands	Yes
Block Kit messages	Yes
Interactive buttons/menus	Yes
Message reactions	Yes
Message threads	Yes
File sharing	Yes
Socket Mode	Yes
OAuth app installation	Yes

Setup

Socket Mode (Recommended)
HTTP Mode

Create a Slack App

Go to api.slack.com/apps and create a new app from scratch.

Enable Socket Mode

Under Settings > Socket Mode, enable Socket Mode and generate an App-Level Token with connections:write scope.

Add Bot Token Scopes

Under OAuth & Permissions > Bot Token Scopes, add:

app_mentions:read
chat:write
commands
im:history
im:read
im:write
reactions:write

Enable Events

Under Event Subscriptions, enable and subscribe to:

app_mention
message.im

Install and configure

Install the app to your workspace, then set:

SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_MODE=socket

Create a Slack App

Create a new Slack app at api.slack.com/apps.

Set Request URLs

Under Event Subscriptions, set the Request URL to: https://your-domain.com/webhooks/slack/events

Configure

SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=...
SLACK_MODE=http

Environment Variables

SLACK_BOT_TOKEN

string

required

Bot OAuth token. Format: xoxb-...

SLACK_APP_TOKEN

string

App-level token for Socket Mode. Format: xapp-... Required when SLACK_MODE=socket.

SLACK_SIGNING_SECRET

string

Signing secret for webhook verification. Required when SLACK_MODE=http.

SLACK_MODE

string

Connection mode: socket or http. Defaults to http.

SLACK_WEBHOOK_URL

string

Incoming webhook URL for simple outbound messages (optional).

Configuration Example

.env (Socket Mode)
.env (HTTP Mode)
settings.yml

SLACK_BOT_TOKEN=xoxb-1234567890-...
SLACK_APP_TOKEN=xapp-1-...
SLACK_MODE=socket

SLACK_BOT_TOKEN=xoxb-1234567890-...
SLACK_SIGNING_SECRET=abc123...
SLACK_MODE=http

chat:
  slack:
    mode: socket
    bot_token: "${SLACK_BOT_TOKEN}"
    app_token: "${SLACK_APP_TOKEN}"

Slash Commands

/ask [question]        - Ask the AI a question
/run [skill] [args]    - Run a profClaw skill
/status                - Check agent status

Custom slash commands can be registered via the CLI:

profclaw slack commands add /deploy "Deploy to production" "run deploy"

Block Kit Messages

profClaw sends structured Block Kit messages for rich responses:

{
  "blocks": [
    {
      "type": "section",
      "text": { "type": "mrkdwn", "text": "Here's what I found:" }
    },
    {
      "type": "actions",
      "elements": [
        { "type": "button", "text": { "type": "plain_text", "text": "Approve" }, "action_id": "approve" }
      ]
    }
  ]
}

Notes

Socket Mode is strongly recommended for development and behind-firewall deployments.
In Socket Mode, profClaw connects outbound to Slack’s servers - no inbound ports needed.
The bot responds to @mention in channels and to all DMs by default.
Multiple Slack workspaces are supported via multi-account configuration.

Slack Bot Setup Guide - Step-by-step walkthrough with screenshots
Chat Providers Overview - Compare all 27 supported channels
Notifications Tool - Send proactive messages to Slack channels from agents
profclaw channels - Enable and test the Slack connection from the CLI

Chat Providers

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Slash Commands

​Block Kit Messages

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Slash Commands

Block Kit Messages

Notes

Related