Channels

How Channels Work

Each channel runs as a separate adapter within MoltBot. When a message arrives on WhatsApp (or Signal, iMessage), MoltBot forwards it to the OpenClaw gateway, which routes it to ClawdBot. The AI response flows back through the same path.

WhatsApp uses QR code linking via the WhatsApp Web protocol. MoltBot runs a headless WhatsApp Web client that pairs with your phone.

Setup

1. Enable WhatsApp in the EasyClaw setup wizard (or toggle it in the dashboard)
2. A QR code appears in the EasyClaw window
3. Open WhatsApp on your phone → Settings → Linked Devices → Link a Device
4. Scan the QR code
5. Done — messages to your paired number are now handled by your AI

Configuration

// openclaw.json → channels
{
  "whatsapp": {
    "enabled": true,
    "autoReply": true,
    "allowedNumbers": ["*"],
    "sessionPath": "./data/whatsapp-session"
  }
}

Set allowedNumbers to an array of phone numbers to restrict who can message your AI, or ["*"] for everyone.

Signal uses signal-cli, a command-line client that connects to Signal's servers. It requires Java (installed automatically by EasyClaw).

Prerequisites

• A phone number registered with Signal
• Java 21+ (EasyClaw installs this automatically)

Setup

1. Enable Signal in the setup wizard
2. Enter your Signal phone number
3. Complete the verification (SMS or voice call)
4. Signal is now linked — messages are forwarded to your AI

Configuration

// openclaw.json → channels
{
  "signal": {
    "enabled": true,
    "phoneNumber": "+1234567890",
    "autoReply": true,
    "trustAllIdentities": false
  }
}

iMessage integration uses BlueBubbles, which connects to the macOS Messages database. This only works on macOS with an active iMessage account.

Prerequisites

• macOS with iMessage signed in
• Full Disk Access permission for EasyClaw (prompted during setup)

Setup

1. Enable iMessage in the setup wizard
2. Grant Full Disk Access when prompted (System Settings → Privacy)
3. EasyClaw installs and configures BlueBubbles automatically
4. iMessage conversations are now connected to your AI

Configuration

// openclaw.json → channels
{
  "imessage": {
    "enabled": true,
    "autoReply": true,
    "blueBubblesPort": 1234
  }
}