Skip to main content
SimpleClaw supports a wide range of messaging platforms, allowing you to chat with your AI assistant from any channel you prefer.

​
Core Channels

WhatsApp

Connect via WhatsApp Web with QR code authentication

Telegram

Integrate using Telegram bot tokens with full bot API support

Discord

Deploy as a Discord bot with server and channel support

Slack

Add to Slack workspaces with Socket Mode integration

Signal

Private messaging via signal-cli integration

iMessage

Native Apple Messages support on macOS

​
Channel Capabilities

ChannelDirect MessagesGroup ChatsThreadsMediaPollsReactions
WhatsApp✓✓—✓✓✓
Telegram✓✓✓✓✓✓
Discord✓✓✓✓✓✓
Slack✓✓✓✓—✓
Signal✓✓—✓—✓
iMessage✓✓—✓——

​
Extension Channels

Additional messaging platforms are available as extensions. Learn more about extension channels.

Matrix

Decentralized chat protocol

Microsoft Teams

Enterprise collaboration platform

Google Chat

Google Workspace messaging

Mattermost

Open-source team communication

IRC

Classic internet relay chat

LINE

Popular messaging app in Asia

​
Getting Started

1

Choose Your Channel

Select the messaging platform you want to connect. Each channel has different setup requirements.
2

Configure Authentication

Follow the channel-specific setup guide to obtain necessary credentials (bot tokens, API keys, etc.).
3

Test Connection

Use simpleclaw channels status to verify your channel is configured correctly.
4

Set Security Policies

Configure DM policies and allowlists to control who can interact with your assistant.

​
Multi-Channel Support

You can connect multiple channels simultaneously. SimpleClaw will route messages from all configured channels to your AI assistant. 
channels:
  telegram:
    enabled: true
    botToken: "your-telegram-token"
  
  discord:
    enabled: true
    token: "your-discord-token"
  
  signal:
    enabled: true
    httpUrl: "http://localhost:8080"

​
Security Best Practices

Set dmPolicy to pairing or allowlist to control who can send direct messages to your assistant.
channels:
  telegram:
    dmPolicy: pairing  # Users must be approved first
    allowFrom:
      - "123456789"  # Trusted user IDs
Use groupPolicy to control behavior in group chats:
  • allowlist: Only specified groups can trigger the bot
  • open: Any group can trigger (mention-gated)
  • off: Disable group functionality
Store sensitive tokens in environment variables or separate files:
channels:
  telegram:
    tokenFile: "/path/to/telegram-token.txt"

​
Next Steps

Configuration Reference

Detailed configuration options for all channels

Security Policies

Learn about DM policies, allowlists, and pairing

Build docs developers (and LLMs) love

Get started for freeTalk to us