Fix: OpenClaw "Channel Telegram Does Not Support Pairing" Error

TL;DR: Telegram doesn't use pairing codes like WhatsApp. You need to approve the bot via the Telegram channel directly.

The Error

Failed to start CLI: Error: Channel telegram does not support pairing

You might also see:

Error: Pairing is not available for channel 'telegram'

openclaw channel telegram pair
Error: This channel type does not support the pair command

Why This Happens

WhatsApp and Telegram connect to OpenClaw in fundamentally different ways:

• WhatsApp uses device pairing — you scan a QR code or enter a pairing code to link your phone as a "linked device." That's why openclaw channel whatsapp pair exists.
• Telegram uses a bot token from BotFather. There's no pairing step. The bot is created on Telegram's side, and OpenClaw connects to it using the token.

The confusion comes from users who set up WhatsApp first (where pair is the natural next step) and then try the same flow for Telegram. Or from older documentation that referenced moltbot pairing approve — a command from a previous version that no longer exists.

(GitHub #3793)

How to Fix It

Step 1: Create a Telegram bot (if you haven't already)

Open Telegram and message @BotFather:

1. Send /newbot
2. Choose a display name (e.g., "My AI Assistant")
3. Choose a username (must end in bot, e.g., my_ai_assistant_bot)
4. BotFather will give you a token like: 7123456789:AAHx-some-long-string-here

Save this token. You'll need it in the next step.

Step 2: Configure the Telegram channel

Add the bot token to your OpenClaw config. Edit clawdbot.json:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "7123456789:AAHx-some-long-string-here"
    }
  }
}

Or use the environment variable:

export TELEGRAM_BOT_TOKEN="7123456789:AAHx-some-long-string-here"

Step 3: Restart the gateway

openclaw gateway restart

Step 4: Verify the connection

openclaw channel telegram status

You should see connected or running. Now open Telegram, find your bot by its username, and send it a message. It should respond.

Step 5: Configure bot settings (optional but recommended)

Back in BotFather, you can customize your bot:

• /setdescription — What users see before starting a chat
• /setuserpic — Give it an avatar
• /setcommands — Add command shortcuts
• /setprivacy — Set to "Disable" if you want the bot to see all messages in group chats (not just commands)

Important for group chats: If you want your bot to respond to messages in groups (not just /commands), you must disable privacy mode:

1. Message BotFather: /setprivacy
2. Select your bot
3. Choose Disable

How to Prevent It

• Remember the rule: WhatsApp = pairing, Telegram = bot token, Discord = bot token + application ID. Each channel has its own connection method.
• Use openclaw channel <name> --help to see which commands are available for each channel type.
• Don't mix up old and new commands. If you're following a guide that mentions moltbot, it's outdated — the project was renamed to clawdbot and then to openclaw.

The Easy Way

lobsterfarm is a managed hosting service for OpenClaw — deployment, updates, and support handled for you.

Get started with lobsterfarm →