← Back to tutorials

Tutorial

Channel Connection

Learn how to connect WhatsApp, Telegram, Discord, Slack, or Signal to one Zaki agent.

Connect one messaging channel to one agent. Most channels use credentials pasted into Playground → Channels. WhatsApp is different: it pairs a live device session. If a bot, app, or phone number is already attached elsewhere, disconnect it there first so routing stays clear.

Telegram

Telegram needs a BotFather bot token. In Zakified, this goes in the botToken field.

  1. Step 1 — Open BotFather on Telegram

    Search for @BotFather in Telegram and start a conversation.

    Open @BotFather →
  2. Step 2 — Create a new bot

    Start a chat and type /newbot.

  3. Step 3 — Name your bot

    Follow the prompts to name your bot and choose a username.

  4. Step 4 — Copy the bot token

    BotFather will send you a message with your bot token. Copy the entire token. It usually looks like 123456789:AA....

  5. Step 5 — Paste the token into Playground → Channels

    Open the tentacle that should own this connection, enable Telegram in Playground → Channels, paste the token into botToken, then save.

  6. Step 6 — Send the bot its first message

    Open the bot in Telegram and send /start or any first message to confirm the channel is live.

WhatsApp

WhatsApp does not use a pasted token. Pair the device in the dashboard and scan the QR code from your phone.

  1. Step 1 — Open Playground → Channels

    Open the tentacle that should own the WhatsApp connection.

  2. Step 2 — Enable WhatsApp and click Pair Device

    Zakified starts the pairing flow on the tentacle for you.

  3. Step 3 — Wait for the QR code

    The QR code should appear directly inside the channel settings.

  4. Step 4 — Scan with your phone

    Open WhatsApp → Linked Devices → Link a Device, then point your camera at the QR code.

  5. Step 5 — You're connected

    When the paired credentials are stored on the tentacle, the channel status becomes Connected. Send a message to test it.

If something goes wrong

  • Unable to connect: On your phone, go to WhatsApp → Linked Devices, delete the failed device, then click Pair Device again.
  • Pair button unavailable: Your OpenClaw version may be too old. In that case, use terminal fallback: openclaw channels login --channel whatsapp

Discord

Discord uses a bot token from the Discord Developer Portal. In Zakified, this goes in the token field. OpenClaw also supports DM pairing and optional guild allowlisting. Command flags such as commands.native are separate global OpenClaw settings, not channel fields.

  1. Step 1 — Create a Discord app and bot

    Use the Discord Developer Portal to create an application, add a bot, enable the needed intents, and copy its token.

  2. Step 2 — Invite the bot to your server

    Add the bot to the Discord server or channel where you want this agent to respond.

  3. Step 3 — Configure Discord in Playground → Channels

    Enable Discord, paste the token into token, then choose the DM policy and optional server IDs if you want to restrict where the bot responds. You can also set a media size limit in MB.

  4. Step 4 — Test DM pairing or server replies

    With DM pairing enabled, unknown users get a pairing code first. In servers, mention the bot if you kept require-mention enabled.

Slack

Slack needs two credentials: a bot token and an app token. In Zakified, these are botToken and appToken.

  1. Step 1 — Create the Slack app

    Turn on Socket Mode and copy the required credentials.

  2. Step 2 — Collect both tokens

    botToken should start with xoxb-. appToken should start with xapp-.

  3. Step 3 — Install the app to your workspace

    Add it to the workspace and target channels before testing.

  4. Step 4 — Paste both values into Playground → Channels

    Enable Slack, fill both token fields, then save.

Signal

Signal currently starts with one required field: account, which should be the phone number in international format such as +15551234567.

  1. Step 1 — Choose the Signal number for this agent

    Use a dedicated number if you want clean, one-agent routing.

  2. Step 2 — Paste the number into Playground → Channels

    Enable Signal, paste the phone number into account, then save.

  3. Step 3 — Finish any Signal-specific registration

    The exact registration flow depends on your tentacle setup, but the current Zakified UI starts with the account number.