Skip to main content

Channels & Integrations

OpenClaw can communicate through 50+ platforms. Each connection is called a channel.

Supported Channels​

Messaging Platforms​

ChannelStatusAuth Method
WhatsAppStableQR code scan
TelegramStableBot token
DiscordStableBot token
SlackStableOAuth app
SignalStablePhone number link
iMessagemacOS onlySystem integration
Microsoft TeamsStableAzure AD app
Google ChatStableService account
MatrixStableAccess token
WebChatBuilt-inGateway URL

Service Integrations​

IntegrationCapabilities
GmailRead, send, search, label emails
GitHubIssues, PRs, notifications, code review
SpotifyPlayback control, playlist management
ObsidianRead/write notes, search vault
HueSmart light control
CalendarGoogle Calendar, Outlook events
Twitter/XRead timeline, post tweets
BrowserFull Chromium automation

Adding a Channel​

# Interactive setup
openclaw channel add <channel-name>

# Examples
openclaw channel add whatsapp
openclaw channel add telegram
openclaw channel add discord
openclaw channel add gmail

Each channel walks you through authentication specific to that platform.

Channel Configuration​

~/.openclaw/config.yml
channels:
  whatsapp:
    enabled: true
    auto_reply: true
    allowed_contacts: []  # Empty = all contacts

  telegram:
    enabled: true
    bot_token: "${TELEGRAM_BOT_TOKEN}"
    allowed_chat_ids: []

  discord:
    enabled: true
    bot_token: "${DISCORD_BOT_TOKEN}"
    allowed_guild_ids: []
    allowed_channel_ids: []

  gmail:
    enabled: true
    credentials_path: "~/.openclaw/gmail-credentials.json"
    scopes:
      - "read"
      - "send"
      - "labels"

Channel Permissions​

Control what OpenClaw can do per channel:

channels:
  whatsapp:
    permissions:
      read: true
      reply: true
      initiate: false    # Can't start conversations
      send_media: false  # Can't send images/files

Multi-Channel Routing​

OpenClaw can route between channels:

You (WhatsApp): "Forward today's urgent emails to my Slack"
OpenClaw: Checks Gmail → Finds 3 urgent emails → Posts summaries to Slack

Managing Channels​

# List active channels
openclaw channel list

# Check channel status
openclaw channel status whatsapp

# Disconnect a channel
openclaw channel remove telegram

# Reconnect after auth expires
openclaw channel reconnect discord
warning

Security note: Each connected channel is an attack surface. A compromised WhatsApp contact could send prompt injection via message. See Security Hardening for mitigation strategies.

See Also​