Platform Setup Guides: Telegram, WhatsApp, Discord & Slack

Create a Bot with BotFather

Open Telegram, search for @BotFather, and send /newbot. Follow the prompts to choose a name and username (must end in 'bot'). Copy the token provided.

# BotFather will give you a token like:
# 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Configure Moltbot

Add your Telegram bot token to the Moltbot configuration. You can do this during onboarding or manually in the config file.

# Store token securely in vault
moltbot vault set TELEGRAM_BOT_TOKEN "your-token-here"

# Or add to config.yaml:
channels:
  telegram:
    enabled: true
    botToken: "${TELEGRAM_BOT_TOKEN}"
    dmPolicy: pairing

Start Chatting

Find your bot on Telegram and send a message. You'll receive a pairing code—approve it with the CLI to start using Moltbot.

# Approve pairing code
moltbot pairing approve telegram YOUR_CODE

Enable WhatsApp Channel

WhatsApp uses a web bridge connection. Enable it in your Moltbot config and restart the Gateway.

# In config.yaml:
channels:
  whatsapp:
    enabled: true
    dmPolicy: pairing

Scan QR Code

After enabling, Moltbot will display a QR code in the terminal. Open WhatsApp on your phone, go to Settings > Linked Devices, and scan the code.

Send a Test Message

Send yourself a message on WhatsApp. Moltbot will see it and respond. DM pairing applies—approve the pairing code to enable full access.

Create a Discord Application

Go to the Discord Developer Portal, create a new application, and create a bot. Copy the bot token and enable the Message Content intent.

# Discord Developer Portal:
# https://discord.com/developers/applications

Invite Bot to Server

Generate an OAuth2 URL with bot permissions (Send Messages, Read Message History) and invite the bot to your server.

# Configure in config.yaml:
channels:
  discord:
    enabled: true
    botToken: "${DISCORD_BOT_TOKEN}"
    dmPolicy: pairing

Start Using

Mention your bot or send a DM in Discord. Approve the pairing code and you're ready to go.

Create a Slack App

Go to api.slack.com/apps, create a new app, and configure bot scopes (chat:write, channels:read, im:read, im:write). Install to your workspace.

# Required bot scopes:
# chat:write, channels:read, channels:history
# im:read, im:write, im:history

Configure Moltbot

Add your Slack bot token and signing secret to Moltbot. The bot will connect using Socket Mode for real-time messaging.

# Store Slack credentials
moltbot vault set SLACK_BOT_TOKEN xoxb-...
moltbot vault set SLACK_SIGNING_SECRET abc...

# In config.yaml:
channels:
  slack:
    enabled: true

Start Using in Slack

Invite the bot to a channel with /invite @moltbot, or send a direct message. The bot will respond and process your requests.