Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wednesdayai.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Channel setup

WednesdayAI connects to messaging platforms through channels. Each channel is a plugin that handles incoming messages, outgoing replies, and account pairing.

​
Available channels

WhatsApp

Personal and business WhatsApp via linked-device protocol

Telegram

Telegram bot — full Bot API support

iMessage

iMessage via Bluebubbles or native macOS

Signal

Signal via signal-cli

Slack

Slack bot via Events API

Discord

Discord bot via Gateway API

Microsoft Teams

Teams via Bot Framework

Matrix

Matrix/Element via matrix-js-sdk
Also available: LINE, Zalo, Web chat (built-in), Voice call.

​
General setup flow

Every channel follows the same pattern:
  1. Install the channel plugin (if not bundled)
  2. Run the login wizard to authenticate
  3. Configure access policies (who can talk to the bot)
  4. Pair the channel to your agent
  5. Test with a message
openclaw channels list                        # see installed channels
openclaw channels login --channel <name>      # authenticate
openclaw channels status --channel <name>     # check connectivity

​
Access policies

After connecting a channel, configure who can interact with the agent: 
{
  agents: {
    list: [
      {
        id: "default",
        dmPolicy: "allowlist",     // allowlist | ask | disabled
        channels: {
          whatsapp: {
            allowFrom: ["+15555550123"],
          },
          telegram: {
            allowFrom: ["@yourusername"],
          },
        },
      },
    ],
  },
}
See Security hardening for policy options and their implications.

​
Pairing

Most channels require pairing a specific account to the agent. After login, the channel issues a pairing code or QR to link the account: 
openclaw channels login --channel whatsapp    # shows QR in terminal
For subsequent startups, the gateway reconnects automatically using stored credentials.

​
Relinking

If a channel disconnects or credentials expire: 
openclaw channels logout --channel <name>
openclaw channels login --channel <name>

​
Channel logs

openclaw channels logs --channel <name> --follow
Channel-specific setup guides (WhatsApp, Telegram, iMessage, etc.) are being written. In the meantime, run openclaw channels login --channel <name> --verbose for guided setup, or check the source docs in the WednesdayAI repository.