Channels Setup

Connect Clawdbot to WhatsApp using Baileys library.

1. Link the device: clawdbot channels login (stores creds in ~/.clawdbot/credentials)
2. Allowlist who can talk to the assistant via channels.whatsapp.allowFrom
3. If channels.whatsapp.groups is set, it becomes a group allowlist; include "*" to allow all

Note: WhatsApp requires pairing via QR code. The credentials are stored locally and encrypted.

Set up Clawdbot as a Telegram bot using grammY library.

1. Create a bot via @BotFather on Telegram
2. Set TELEGRAM_BOT_TOKEN environment variable or channels.telegram.botToken in config (env wins)
3. Optional: set channels.telegram.groups (with channels.telegram.groups."*".requireMention); when set, it is a group allowlist (include "*" to allow all)
4. Also configure channels.telegram.allowFrom or channels.telegram.webhookUrl as needed

{
  "channels": {
    "telegram": {
      "botToken": "123456:ABCDEF"
    }
  }
}

Connect Clawdbot to Discord servers using discord.js.

1. Create a Discord application at Discord Developer Portal
2. Set DISCORD_BOT_TOKEN environment variable or channels.discord.token in config (env wins)
3. Optional: set commands.native, commands.text, or commands.useAccessGroups
4. Configure channels.discord.dm.allowFrom, channels.discord.guilds, or channels.discord.mediaMaxMb as needed

{
  "channels": {
    "discord": {
      "token": "1234abcd"
    }
  }
}

Connect Clawdbot to Slack workspaces using Bolt framework.

1. Create a Slack app at Slack API
2. Set SLACK_BOT_TOKEN + SLACK_APP_TOKEN environment variables
3. Or configure channels.slack.botToken + channels.slack.appToken in config
4. Configure channels.slack.dm.allowFrom for DM access control

Connect Clawdbot to Signal using signal-cli.

1. Install signal-cli on your system
2. Link your Signal account
3. Configure channels.signal section in your config

Note: Signal requires signal-cli to be installed and properly configured.

Connect Clawdbot to iMessage on macOS using imsg library.

• macOS only: iMessage integration requires macOS
• Messages app must be signed in
• If channels.imessage.groups is set, it becomes a group allowlist; include "*" to allow all

Connect Clawdbot to Microsoft Teams using Bot Framework.

1. Create a Teams app in Azure Portal
2. Configure Bot Framework
3. Add a msteams config section
4. Allowlist who can talk via msteams.allowFrom
5. Configure group access via msteams.groupAllowFrom or msteams.groupPolicy: "open"

Connect Clawdbot to Google Chat (beta support).

1. Create a Google Chat app in Google Cloud Console
2. Configure via channels.googlechat section
3. Set up webhook URL or OAuth as needed

Note: Google Chat support is currently in beta.

Use Clawdbot's built-in WebChat interface.

• Uses the Gateway WebSocket; no separate WebChat port/config needed
• Accessible via the Gateway control UI
• Works in any modern web browser

Clawdbot also supports additional channels via extensions:

• BlueBubbles: Connect via BlueBubbles extension
• Matrix: Connect to Matrix protocol servers
• Zalo: Connect to Zalo messaging
• Zalo Personal: Connect to Zalo Personal messaging

These require additional extension setup. Refer to the extension documentation for details.

For group chats, Clawdbot supports:

• Group allowlists: Control which groups the bot responds to
• Mention gating: Require @mentions in groups
• Reply tags: Handle replies and threading
• Per-channel routing: Route messages to different agents
• Activation modes: Control when the bot responds in groups