Channel Setup

Connect OpenClaw to your favorite messaging platforms. Chat with your AI assistant from Telegram, Discord, WhatsApp, and more.

Supported Channels

Channel	Type	Features
Telegram	Bot	Full support, inline buttons, media
Discord	Bot	Servers, DMs, reactions, threads
WhatsApp	Link	Personal account linking
Slack	Bot	Workspaces, channels, threads
Signal	Link	End-to-end encrypted
iMessage	Bridge	macOS only

Telegram Setup

Telegram is the easiest way to get started with OpenClaw.

Step 1: Create a Bot

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the prompts
3. Copy the bot token (looks like 123456789:ABCdefGHI...)

Step 2: Configure OpenClaw

channels:
  telegram:
    enabled: true
    token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
    allowedUsers:
      - 123456789  # Your Telegram user ID
    features:
      inlineButtons: true
      voiceMessages: true

Step 3: Get Your User ID

Send a message to @userinfobot to get your Telegram user ID.

Discord Setup

Connect OpenClaw to Discord servers and direct messages.

Step 1: Create a Discord Application

1. Go to the Discord Developer Portal
2. Click "New Application" and give it a name
3. Go to "Bot" section and click "Add Bot"
4. Copy the bot token

Step 2: Set Bot Permissions

Under OAuth2 > URL Generator, select these scopes:

• bot
• applications.commands

And these bot permissions:

• Send Messages
• Read Message History
• Add Reactions
• Attach Files

Step 3: Configure OpenClaw

channels:
  discord:
    enabled: true
    token: "your-discord-bot-token"
    allowedGuilds:
      - "guild-id-1"
      - "guild-id-2"
    allowedUsers:
      - "user-id-1"
    prefix: "!"  # Optional command prefix

WhatsApp Setup

Link your personal WhatsApp account to OpenClaw.

Step 1: Enable WhatsApp Channel

channels:
  whatsapp:
    enabled: true
    dataPath: ~/.openclaw/whatsapp

Step 2: Link Your Account

1. Run openclaw gateway start
2. A QR code will appear in the terminal
3. Open WhatsApp on your phone
4. Go to Settings > Linked Devices > Link a Device
5. Scan the QR code

Slack Setup

Add OpenClaw to your Slack workspace.

Step 1: Create a Slack App

1. Go to Slack API
2. Click "Create New App" > "From scratch"
3. Add bot scopes under OAuth & Permissions:
   • chat:write
   • channels:history
   • im:history
4. Install the app to your workspace
5. Copy the Bot User OAuth Token

Step 2: Configure OpenClaw

channels:
  slack:
    enabled: true
    botToken: "xoxb-your-bot-token"
    appToken: "xapp-your-app-token"  # For Socket Mode
    allowedChannels:
      - "C01234567"

Multiple Channels

You can enable multiple channels simultaneously:

channels:
  telegram:
    enabled: true
    token: "telegram-token"
  discord:
    enabled: true
    token: "discord-token"
  slack:
    enabled: true
    botToken: "slack-token"

Channel-Specific Settings

Configure different behaviors per channel:

channels:
  telegram:
    enabled: true
    token: "token"
    settings:
      responseDelay: 500      # ms delay before responding
      maxMessageLength: 4096  # Telegram limit
      typingIndicator: true   # Show typing...
  discord:
    enabled: true
    token: "token"
    settings:
      responseDelay: 1000
      maxMessageLength: 2000  # Discord limit
      useEmbeds: true         # Rich embeds