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
- Open @BotFather in Telegram
- Send
/newbot - Enter bot name (e.g.,
My Claw Bot) - Enter username (must end with
bot:myclawbot) - 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
- In wizard select WhatsApp
- QR code appears in terminal
- Open WhatsApp on phone → Settings → Linked Devices → Link a Device
- Scan QR code
- 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
- Go to Discord Developer Portal
- New Application → name:
OpenClaw Bot - Bot → Reset Token → copy token
- Privileged Gateway Intents (MUST enable):
- ✅ Message Content Intent — read messages
- ✅ Server Members Intent — member list
- ✅ Presence Intent — online/offline status
- OAuth2 → URL Generator → Scopes:
bot+applications.commands- Bot Permissions:
Send Messages,Embed Links,Attach Files,Read Message History,Use Slash Commands,Manage Messages
- Bot Permissions:
- 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
- Go to api.slack.com/apps → Create New App → From scratch
- App Name:
OpenClaw, Workspace: yours - OAuth & Permissions → Bot Token Scopes (add):
chat:write— send messageschannels:read,groups:read,im:read,mpim:read— read channelschannels:history,groups:history,im:history,mpim:history— historyreactions:write— reactionsfiles:write— upload filesapp_mentions:read— bot mentions
- Install to Workspace → Allow
- Bot User OAuth Token (
xoxb-...) → paste in OpenClaw wizard - Event Subscriptions → Enable → Request URL:
https://your.domain/slack/events(needs webhook/SSL) - Subscribe to bot events:
app_mention,message.channels,message.im
5. Matrix — Decentralized
- Register account on any Matrix homeserver (matrix.org, your server)
- Create Access Token: Element → Settings → Security → Access Tokens
- In wizard: Matrix → Homeserver URL, User ID, Access Token
- Invite bot to rooms:
/invite @openclaw:matrix.org
6. Permissions & Group Chats
| Messenger | Group Chats | DMs | Admin Rights |
|---|---|---|---|
| Telegram | ✅ (add bot to group) | ✅ | Needed for message deletion |
| ✅ (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 Disableat @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 ✅
- [ ] Telegram: token from @BotFather,
/setprivacy Disable - [ ] WhatsApp: QR scanned, session saved
- [ ] Discord: token, 3 Intents enabled, bot on server
- [ ] Slack: Bot Token + Signing Secret, Event Subscriptions, bot in workspace
- [ ] Matrix: Access Token, bot in rooms
- [ ] Test: message bot
/helpin each messenger - [ ] Test:
/skill deployin Telegram → check notification
Links: Messengers Docs | Discord #messengers
