@amodalai/channel-slack

Slack messaging channel plugin for Amodal agents. Lets users interact with their agent via Slack DMs and channel mentions.

Install

pnpm add @amodalai/channel-slack

Add to amodal.json:

{
  "packages": ["@amodalai/channel-slack"]
}

Set environment variables:

SLACK_BOT_TOKEN=xoxb-...
SLACK_SIGNING_SECRET=...

Setup

1. Create a Slack app at https://api.slack.com/apps
2. Enable Event Subscriptions and set the request URL to https://your-domain.com/channels/slack/webhook
3. Subscribe to bot events: message.im, app_mention
4. Install the app to your workspace
5. Copy the Bot User OAuth Token and Signing Secret to your .env
6. Start the server: amodal dev

Config

| Field | Required | Description | |-------|----------|-------------| | botToken | Yes | Bot User OAuth Token (xoxb-...) | | signingSecret | Yes | Signing secret for webhook verification | | appToken | No | App-level token for Socket Mode (xapp-...) | | allowedWorkspaces | No | Array of workspace IDs. If omitted, all workspaces accepted. |

Features

• Responds to DMs and @mentions
• Shows italic "Thinking..." placeholder while processing (updates in place)
• Message chunking for long responses
• Signature verification on all incoming webhooks
• Workspace allowlist for multi-workspace apps