How to Connect OpenClaw to WhatsApp, Telegram, Slack, Discord, and iMessage [2026]

Most AI tools live in one place. A chatbot for your website. A bot in your Discord server. A separate assistant in Slack. Each one is its own island — different context, different memory, different personality.

OpenClaw works differently. You configure one agent with a single personality (soul.md) and a single knowledge base (memory.md), and then connect it to every messaging platform you use. The same agent, the same memory, the same context — whether someone reaches it on WhatsApp, Telegram, Slack, Discord, or iMessage.

This guide walks through connecting each of the five most popular messaging channels to your OpenClaw agent.

Why Does Multi-Channel Matter for AI Agents?

Think about how you actually communicate. You talk to your team on Slack, your clients on WhatsApp, your community on Discord, your friends on Telegram, and your family on iMessage. A useful AI agent needs to meet you where you already are.

With OpenClaw's multi-channel architecture, your agent responds on 20+ platforms through a single Gateway, maintains one unified memory, uses the same personality everywhere (defined once in soul.md), and routes all messages through the Gateway on port 18789.

How Do the Five Main Channels Compare?

Our recommendation: Start with Telegram. It takes about 2 minutes, requires no admin approvals, and gives you a fast feedback loop.

How Do You Set Up Telegram?

Telegram is the easiest channel to connect.

Step 1: Create a Bot via @BotFather

1. Open Telegram and search for @BotFather
2. Send /newbot
3. Provide a display name and username (must end in bot)
4. Copy the bot token immediately

Step 2: Connect in OpenClaw Dashboard

Run openclaw dashboard, navigate to Channels, select Telegram, paste your token, and click Connect.

Step 3: Test

Find your bot by username and send it a message.

Telegram Tips

• Disable privacy mode via @BotFather (/setprivacy) to let the agent see all group messages
• Register slash commands with /setcommands for a clean user menu
• One bot works in both DMs and group chats

How Do You Set Up WhatsApp?

OpenClaw connects to WhatsApp via the WhatsApp Web protocol — scan a QR code, just like linking WhatsApp Web in a browser.

Steps

1. Run openclaw dashboard and navigate to Channels > WhatsApp
2. Scan the displayed QR code with your phone (Settings > Linked Devices > Link a Device)
3. Verify by sending a message from a different phone

WhatsApp Tips

• Use a dedicated phone number to keep personal and agent messages separate
• Sessions can expire if your phone loses connectivity — check the dashboard periodically
• The agent can receive images, voice notes, and documents depending on your model's multimodal capabilities
• Configure soul.md with clear instructions about when to respond in group chats

How Do You Set Up Discord?

Steps

1. Create a Bot Application in the Discord Developer Portal
2. Enable Message Content Intent (mandatory) under Privileged Gateway Intents
3. Generate an invite URL with bot scope and required permissions (Read/Send Messages, Read History)
4. Invite the bot to your server
5. Paste the bot token in openclaw dashboard > Channels > Discord

Discord Tips

• Use channel permissions to restrict the bot to specific channels like #ai-assistant
• One bot token works across all servers the bot has been invited to
• Discord enforces rate limits on bot messages — the Gateway handles retries automatically

How Do You Set Up Slack?

Slack is the most involved setup — it requires creating a Slack app, configuring OAuth scopes, and getting workspace admin approval.

Steps

1. Create a Slack App at api.slack.com/apps
2. Add Bot Token Scopes: chat:write, channels:history, channels:read, groups:history, groups:read, im:history, im:read, im:write, users:read
3. Install to Workspace and copy the Bot User OAuth Token (xoxb-)
4. Enable Event Subscriptions: message.channels, message.groups, message.im
5. Connect in openclaw dashboard > Channels > Slack

Slack Tips

• Start with one or two test channels before expanding
• By default, OpenClaw responds in threads to keep channels clean
• Mention-only mode (@OpenClaw Agent) is recommended for busy channels

How Do You Set Up iMessage?

iMessage integration only works on Mac. Navigate to Channels > iMessage in the dashboard and grant macOS permissions.

Limitations

• Mac must stay on — if it sleeps, the agent goes offline
• Messages come from your Apple ID — no separate bot identity
• Use soul.md to control which conversations the agent responds to

How Does Cross-Channel Memory Work?

All channels route through the same Gateway. The Gateway feeds every message to the same agent instance. Knowledge in memory.md is updated from conversations on any channel. Personality in soul.md applies equally everywhere.

Practical example: You tell your agent on WhatsApp, "My meeting got moved to Thursday at 3pm." Later, on Slack, you ask, "When is my meeting?" The agent knows — because it's the same memory space.

How Do You Keep Your Channels Safe?

Best practices: rotate tokens periodically, review connected devices regularly, use soul.md guardrails (never share API keys or passwords), and don't run OpenClaw on shared machines without user isolation.

Which Channel Should You Set Up First?

Start with Telegram. Speed (under 2 minutes), no approvals needed, free and reliable, easy to test, and low stakes if something goes wrong. Once refined, move to WhatsApp for clients, Slack for your team, Discord for your community.

Common Issues and Fixes

Telegram

• Bot doesn't respond: Verify the bot token. Try regenerating via @BotFather.
• Only responds to / commands in groups: Disable privacy mode with /setprivacy.

WhatsApp

• QR code won't scan: Refresh it — they expire after ~60 seconds.
• Session disconnects: Keep phone on stable WiFi. Avoid using WhatsApp Web in a browser simultaneously.

Discord

• Bot online but doesn't respond: Verify Message Content Intent is enabled.
• Missing Permissions: Re-invite with correct permissions via new OAuth2 URL.

Slack

• Bot doesn't see messages: Verify Event Subscriptions are enabled with correct events.
• Token expired: Reinstall the app to generate a new token.

iMessage

• Agent goes offline when Mac sleeps: Adjust Energy Saver settings or use caffeinate.

FAQ

Can I connect all five channels at the same time?

Yes. OpenClaw supports running all channels simultaneously through the same Gateway.

Does the agent know which channel a message came from?

Yes. You can define platform-specific behavior in soul.md.

What happens if two people message at the same time on different channels?

The Gateway handles concurrent messages. Each conversation is processed independently but they share the same memory.

Can I disconnect a channel without affecting others?

Yes. Each channel connection is independent.

Is WhatsApp integration against WhatsApp's Terms of Service?

OpenClaw uses the WhatsApp Web protocol — a gray area. Risk of account suspension is low for personal and small-business use. For enterprise, consider the official WhatsApp Business API.

Can the agent send messages proactively?

Yes. Through skills and the scheduler, the agent can initiate messages on any connected channel.

How do I update the agent's personality across all channels?

Edit soul.md. Changes take effect immediately — no restart needed.

Can I see all messages from all channels in one place?

Yes. The OpenClaw dashboard shows a unified activity feed across all connected channels.

*Last updated: March 2026. Published by the Remote OpenClaw team at remoteopenclaw.com.*