OpenClaw: Complete Messenger Setup in 10 Minutes

OpenClaw supports 5 transports out of the box. Each setup takes 2 minutes in the wizard (openclaw on first run) or via config. Let's break down each step-by-step.

1. Telegram Bot — Easiest

Create Bot

  1. Open @BotFather in Telegram
  2. Send /newbot
  3. Enter bot name (e.g., My Claw Bot)
  4. Enter username (must end with bot: myclawbot)
  5. Copy token (format: 123456789:ABCdefGhIjkLmnOpqRsTuvWxYz)

Setup in OpenClaw

In wizard (openclaw → Configure → Messengers → Telegram) paste token. Done!

Useful Settings

  • /setprivacy → Disable → bot sees all messages in groups
  • /setjoingroups → Enable → bot can be added to groups
  • /setcommands — add commands: start - Start, help - Help, skill - Run skill

Webhooks vs Long Polling

  • Long Polling (default): no public IP/SSL needed, works everywhere including localhost
  • Webhook: needs HTTPS domain, faster, less load. Configure in config.toml: webhook_url = "https://your.domain/telegram/webhook"

2. WhatsApp (Baileys) — Via QR Code

Connection

  1. In wizard select WhatsApp
  2. QR code appears in terminal
  3. Open WhatsApp on phone → Settings → Linked Devices → Link a Device
  4. Scan QR code
  5. Session saves to ~/.config/openclaw/sessions/whatsapp/

Important Notes

  • Works via Baileys (unofficial WebSocket client)
  • May need reconnection every few days
  • Group chats: bot must be admin or added by participant
  • Supports: text, images, documents, voice, locations

Multi-Account

Connect multiple WhatsApp numbers — create separate sessions in ~/.config/openclaw/sessions/whatsapp_1/, whatsapp_2/ and specify in config.toml.

3. Discord Bot — Via Developer Portal

Create Application

  1. Go to Discord Developer Portal
  2. New Application → name: OpenClaw Bot
  3. Bot → Reset Token → copy token
  4. Privileged Gateway Intents (MUST enable):
    • ✅ Message Content Intent — read messages
    • ✅ Server Members Intent — member list
    • ✅ Presence Intent — online/offline status
  5. OAuth2 → URL Generator → Scopes: bot + applications.commands
    • Bot Permissions: Send Messages, Embed Links, Attach Files, Read Message History, Use Slash Commands, Manage Messages
  6. Copy generated URL → open in browser → add bot to server

Slash Commands

OpenClaw auto-registers slash commands on startup: /skill, /agent, /help, /undo. In Discord they appear as native commands.

4. Slack App — Via api.slack.com

Create App

  1. Go to api.slack.com/apps → Create New App → From scratch
  2. App Name: OpenClaw, Workspace: yours
  3. OAuth & Permissions → Bot Token Scopes (add):
    • chat:write — send messages
    • channels:read, groups:read, im:read, mpim:read — read channels
    • channels:history, groups:history, im:history, mpim:history — history
    • reactions:write — reactions
    • files:write — upload files
    • app_mentions:read — bot mentions
  4. Install to Workspace → Allow
  5. Bot User OAuth Token (xoxb-...) → paste in OpenClaw wizard
  6. Event Subscriptions → Enable → Request URL: https://your.domain/slack/events (needs webhook/SSL)
  7. Subscribe to bot events: app_mention, message.channels, message.im

5. Matrix — Decentralized

  1. Register account on any Matrix homeserver (matrix.org, your server)
  2. Create Access Token: Element → Settings → Security → Access Tokens
  3. In wizard: Matrix → Homeserver URL, User ID, Access Token
  4. Invite bot to rooms: /invite @openclaw:matrix.org

6. Permissions & Group Chats

MessengerGroup ChatsDMsAdmin Rights
Telegram✅ (add bot to group)✅Needed for message deletion
WhatsApp✅ (bot must be admin)✅Not required
Discord✅ (bot on server)✅ (DM)Manage Messages for deletion
Slack✅ (add to channel: @OpenClaw)✅ (DM)Not required
Matrix✅ (invite to room)✅ (DM)Power level 100+ for moderation

7. Advanced Config (config.toml)

[messengers.telegram]
token = "123456789:ABCdef..."
webhook_url = "https://your.domain/telegram/webhook"  # optional
allowed_users = [123456789, 987654321]  # optional: whitelist

[messengers.whatsapp]
session_path = "~/.config/openclaw/sessions/whatsapp"
multi_device = true

[messengers.discord]
token = "MTIzNDU2Nzg5..."
# slash commands auto-register

[messengers.slack]
token = "xoxb-123456..."
signing_secret = "abcdef..."
webhook_url = "https://your.domain/slack/events"

[messengers.matrix]
homeserver = "https://matrix.org"
user_id = "@openclaw:matrix.org"
access_token = "syt_..."

8. Common Issues & Fixes

  • Telegram: bot silent in group → /setprivacy Disable at @BotFather
  • WhatsApp: QR won't scan → restart openclaw, update Baileys: cd openclaw && git pull && ./install.sh
  • Discord: bot sees no messages → enable Message Content Intent in Developer Portal
  • Slack: events not arriving → check Signing Secret, SSL cert, URL reachable from outside
  • Matrix: bot won't join → check Room Power Level (need 100+)

9. Multi-Messenger: Lobster Everywhere

OpenClaw works in all messengers simultaneously. Configure each in wizard or config.toml — lobster replies everywhere added. Context shared (SQLite memory), transports independent.

Setup Checklist ✅

  1. [ ] Telegram: token from @BotFather, /setprivacy Disable
  2. [ ] WhatsApp: QR scanned, session saved
  3. [ ] Discord: token, 3 Intents enabled, bot on server
  4. [ ] Slack: Bot Token + Signing Secret, Event Subscriptions, bot in workspace
  5. [ ] Matrix: Access Token, bot in rooms
  6. [ ] Test: message bot /help in each messenger
  7. [ ] Test: /skill deploy in Telegram → check notification

Links: Messengers Docs | Discord #messengers