Connectors

Connectors bridge your agents to chat platforms. Messages sent to the bot on any platform are routed to the assigned agent, and responses are sent back.

Supported Platforms

PlatformLibraryAuth Method
Discorddiscord.jsBot token
Slack@slack/boltBot token + App token
TelegramgrammyBot token
WhatsAppbaileysQR code pairing

Discord

  1. Create a bot at Discord Developer Portal
  2. Copy the Bot Token
  3. In SwarmClaw, go to Connectors > New Connector
  4. Select Discord, paste the token, and choose an agent
  5. Add channel IDs the bot should respond in (comma-separated)
  6. Enable and start the connector

The bot needs the MESSAGE_CONTENT intent enabled in the developer portal.

Slack

  1. Create a Slack app at api.slack.com
  2. Enable Socket Mode and generate an App-Level Token
  3. Add Bot Token Scopes: chat:write, app_mentions:read
  4. Install to your workspace and copy the Bot Token
  5. In SwarmClaw, create a Slack connector with both tokens
  6. The bot responds to mentions (@YourBot) in channels it's invited to

Telegram

  1. Message @BotFather on Telegram
  2. Create a new bot and copy the token
  3. In SwarmClaw, create a Telegram connector with the token
  4. The bot responds to all direct messages and group mentions

WhatsApp

  1. In SwarmClaw, create a WhatsApp connector
  2. A QR code appears in the connector sheet
  3. Open WhatsApp on your phone > Linked Devices > Link a Device
  4. Scan the QR code
  5. The connector links to your WhatsApp account

Note: WhatsApp uses the Baileys library (unofficial). The QR code may need to be re-scanned periodically.

Managing Connectors

Each connector shows its status: running, stopped, or error. Use the toggle to start/stop connectors. Error details are displayed when something goes wrong.