OpenClaw Channel Setup: Connect Telegram, Discord, and WhatsApp
OpenClaw Channel Setup: Connect Telegram, Discord, and WhatsApp
By Sarah Chen | February 7, 2026
OpenClaw Channel Setup: Connect Telegram, Discord, and WhatsApp
OpenClaw becomes truly powerful when connected to your everyday messaging apps. This guide covers setup for the three most popular channels: Telegram, Discord, and WhatsApp.
---
Prerequisites
Before configuring channels, ensure:
openclaw gateway status---
Telegram Setup
Step 1: Create a Bot
1. Open Telegram and search for @BotFather 2. Send /newbot to create a new bot 3. Follow prompts to name your bot (ends in bot or Bot) 4. Copy the token — you'll need it for configuration
Step 2: Configure OpenClaw
# Set the bot token openclaw config set telegram.token "YOUR_BOT_TOKEN"Enable Telegram channel
openclaw config set telegram.enabled trueOptional: Restrict to specific users
openclaw config set telegram.allowFrom ["user_id_1", "user_id_2"] Step 3: Pair Your Account
# Start the pairing process openclaw channels telegram pair You'll receive a code in Telegram — enter it to complete pairing.
Step 4: Test the Connection
# Send a test message openclaw message send --channel telegram --to "@your_bot" --message "Hello from OpenClaw!" ---
Discord Setup
Step 1: Create a Discord Application
1. Go to Discord Developer Portal 2. Click "New Application" and name it 3. Go to "Bot" → "Add Bot" 4. Copy the Bot Token
Step 2: Configure Permissions
Under Bot settings, enable:
Step 3: Invite the Bot
1. Go to OAuth2 → URL Generator 2. Select scopes: bot 3. Select permissions: Send Messages, Read Message History 4. Copy the URL and open it to invite the bot to your server
Step 4: Configure OpenClaw
# Set the bot token openclaw config set discord.token "YOUR_DISCORD_TOKEN"Enable Discord
openclaw config set discord.enabled trueSet the default guild (server)
openclaw config set discord.guildId "YOUR_GUILD_ID" Step 5: Test Discord
# Check connection openclaw channels discord testSend a message
openclaw message send --channel discord --to "#general" --message "OpenClaw is connected!" ---
WhatsApp Business Setup
Step 1: Get WhatsApp Business API
Using Meta for Developers:
1. Create a Meta App 2. Add WhatsApp product 3. Get Phone Number ID and Access Token
Step 2: Configure OpenClaw
# Set WhatsApp credentials openclaw config set whatsapp.phoneNumberId "YOUR_PHONE_NUMBER_ID" openclaw config set whatsapp.accessToken "YOUR_ACCESS_TOKEN"Enable WhatsApp
openclaw config set whatsapp.enabled trueSet message policy
openclaw config set whatsapp.selfChatMode true openclaw config set whatsapp.dmPolicy "allowlist" openclaw config set whatsapp.allowFrom ["+15551234567"] Step 3: Verify Phone Number
Complete WhatsApp business verification in Meta portal before testing.
---
Multi-Channel Best Practices
Organization Tips
| Use Case | Recommended Channel |
|---|---|
| Quick questions | Telegram |
| Team collaboration | Discord |
| Personal reminders | |
| Voice interactions | Telegram (voice notes) |
Security Considerations
# Restrict channels to trusted users openclaw config set telegram.allowFrom ["user_id_1"]Set DM policy
openclaw config set telegram.dmPolicy "allowlist" openclaw config set discord.dmPolicy "allowlist"Disable specific channels if unused
openclaw config set whatsapp.enabled false ---
Troubleshooting Channel Issues
Common Errors
| Error | Solution |
|---|---|
| Token invalid | Regenerate token in platform settings |
| Gateway not running | openclaw gateway start |
| Channel not enabled | Check openclaw config get |
| Permission denied | Verify bot has correct roles/permissions |
Verify Configuration
# Check all channel settings openclaw config get channelsTest each channel
openclaw channels test --allView gateway status
openclaw gateway status ---
Advanced: Channel-Specific Agents
Route different channels to different agents:
{ "channels": { "telegram": { "agentId": "main" }, "discord": { "agentId": "work-assistant" }, "whatsapp": { "agentId": "personal-assistant" } } } This lets each channel have its own personality, memory, and tools.
---
Final Thoughts
Multiple channels make OpenClaw accessible wherever you already communicate. Start with one channel, verify it works, then add others gradually.
---
Related Articles:
Tags: OpenClaw, AI, Tutorial
Comments
Post a Comment