> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elkapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenClaw Manager — Telegram Channel Setup

> Step-by-step guide on creating and configuring a Telegram bot in OpenClaw Manager, including BotFather bot creation, credential setup, and pairing code binding.

## Introduction

This tutorial guides you through creating and configuring a Telegram bot in OpenClaw Manager. Once complete, your Telegram Bot will be powered by ElkAPI's AI models for intelligent conversations.

<Note>
  **Prerequisites:** Please ensure you have completed the [OpenClaw Manager deployment](/en/integrations/platform/openclaw-manager) and the Manager is running with the management UI accessible.
</Note>

## Step 1: Create a Bot on Telegram

1. Open Telegram, search for [@BotFather](https://t.me/BotFather) and start a conversation

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/telegram/botfather-search.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=63320eeb5130eaea975495553576c905" alt="Search BotFather" width="1221" height="948" data-path="images/integrations/openclaw-manager/telegram/botfather-search.png" />
</Frame>

2. Send the `/newbot` command

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/telegram/botfather-newbot.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=9daa1fab7fd6d89ff6203a9c032a92fc" alt="Send /newbot command" width="765" height="924" data-path="images/integrations/openclaw-manager/telegram/botfather-newbot.png" />
</Frame>

<caption>*Send /newbot to start creating a bot*</caption>

3. Enter your bot's **display name** as prompted (e.g. `My AI Bot`)

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/telegram/botfather-name.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=d6c755aad5869306c2df791af6f7dc75" alt="Enter bot name" width="779" height="299" data-path="images/integrations/openclaw-manager/telegram/botfather-name.png" data-path="images/integrations/openclaw-manager/telegram/botfather-name.png" />
</Frame>

<caption>*Enter the bot's display name*</caption>

4. Enter the bot's **username** (must end with `bot`, e.g. `my_ai_chatbot`)

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/telegram/botfather-username.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=99d3eeff5ec1c2d7f60597123c898c54" alt="Enter bot username" width="760" height="444" data-path="images/integrations/openclaw-manager/telegram/botfather-username.png" data-path="images/integrations/openclaw-manager/telegram/botfather-username.png" />
</Frame>

<caption>*Enter the bot's username (must end with bot)*</caption>

5. BotFather will return a **Bot Token** (format: `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`), copy and save it

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/telegram/botfather-token.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=ccb0d6e4a36baafe77bae4152cb253c2" alt="Get Bot Token" width="777" height="938" data-path="images/integrations/openclaw-manager/telegram/botfather-token.png" data-path="images/integrations/openclaw-manager/telegram/botfather-token.png" />
</Frame>

<caption>*Bot Token returned by BotFather*</caption>

<Warning>
  **Keep your Bot Token secure** and do not share it. If the token is compromised, use the `/revoke` command in BotFather to regenerate it.
</Warning>

## Step 2: Create Instance in Manager

1. Open the OpenClaw Manager UI (`http://127.0.0.1:51942`)

2. Click **+ New Instance**

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/manager/new-instance.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=f8ce08b7a5ff98c4ec954b4eeae5a9a5" alt="New Instance" width="1911" height="948" data-path="images/integrations/openclaw-manager/manager/new-instance.png" />
</Frame>

3. **Enter instance name** — e.g. `my-telegram-bot` (letters, numbers, underscores, hyphens only)

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/manager/step-name.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=940ab7cfe9efde5fd476f43cc7904074" alt="Enter instance name" width="1911" height="948" data-path="images/integrations/openclaw-manager/manager/step-name.png" />
</Frame>

4. **Select AI model** — Choose the model you want to use

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/manager/step-model.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=010f34ffb9ccd05046bcd8d8432a2ecc" alt="Select model" width="1905" height="860" data-path="images/integrations/openclaw-manager/manager/step-model.png" data-path="images/integrations/openclaw-manager/manager/step-model.png" />
</Frame>

5. **Enter ElkAPI API Key** — Enter your API key starting with `sk-`

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/manager/step-key.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=bb8c5aa494bc674523b18fe68cc1a26e" alt="Enter API Key" width="1905" height="948" data-path="images/integrations/openclaw-manager/manager/step-key.png" data-path="images/integrations/openclaw-manager/manager/step-key.png" />
</Frame>

6. **Select channel** — Choose **Telegram**

7. **Paste Bot Token** — Paste the Bot Token obtained in Step 1

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/telegram/step-channel.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=18fc367a8d7a3e8e92711cff675f10a1" alt="Configure Telegram channel" width="1896" height="941" data-path="images/integrations/openclaw-manager/telegram/step-channel.png" />
</Frame>

<caption>*Paste Telegram Bot Token*</caption>

8. Click **Create** to complete instance creation

## Step 3: Pairing Code Binding

After the instance is created and started, complete user authorization via pairing code:

1. Search for your bot's username in Telegram

2. Send any message (e.g. "Hello")

3. The bot will reply with an **8-digit pairing code** (e.g. `DFE62DTD`)

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/telegram/pairing-code.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=9b6366303362f07e934977d1b8f1f388" alt="Get pairing code" width="425" height="327" data-path="images/integrations/openclaw-manager/telegram/pairing-code.png" data-path="images/integrations/openclaw-manager/telegram/pairing-code.png" />
</Frame>

<caption>*Pairing code returned by the bot*</caption>

4. Return to the Manager's new instance wizard, enter the pairing code in the "**Enter Pairing Code**" step and click "**Approve**"

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/telegram/pairing-input.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=7df57e6d48c00d2394d8f3edb7cc664c" alt="Enter pairing code" width="3072" height="3072" data-path="images/integrations/openclaw-manager/telegram/pairing-input.png" />
</Frame>

<caption>*Enter pairing code and approve in the wizard*</caption>

5. After the code is approved, click "**Done**"

<Frame>
  <img src="https://mintcdn.com/apicore/LGVVJQGJwbbJu2RM/images/integrations/openclaw-manager/telegram/pairing-success.png?fit=max&auto=format&n=LGVVJQGJwbbJu2RM&q=85&s=b2f6f2219d2a09de769e388405c631db" alt="Pairing approved" width="1902" height="942" data-path="images/integrations/openclaw-manager/telegram/pairing-success.png" />
</Frame>

<caption>*Pairing code approved, click Done*</caption>

6. Return to Telegram, send another message, and the bot will respond with AI-generated content

<Frame>
  <img src="https://mintcdn.com/fuhu/rGvMBqASJ4r9KbNS/images/integrations/openclaw-manager/telegram/chat-demo.png?fit=max&auto=format&n=rGvMBqASJ4r9KbNS&q=85&s=0c89423fed3cdafee86124baa8f27e62" alt="Chat with bot" width="774" height="915" data-path="images/integrations/openclaw-manager/telegram/chat-demo.png" data-path="images/integrations/openclaw-manager/telegram/chat-demo.png" />
</Frame>

<caption>*Chat with the AI bot after successful binding*</caption>

<Note>
  **Tip:** Pairing codes are stored in Gateway memory and expire after Gateway restart. If a code expires, simply have the user send a new message to get a fresh code.
</Note>

## FAQ

### Q1: Bot created successfully but not responding?

**Solutions:**

1. Confirm the instance status is "**Running**" in Manager
2. Confirm Bot Token is entered correctly
3. Check Gateway logs: `~/.openclaw-<instance-name>/logs/gateway.log`

### Q2: Pairing code approval failed?

**Solutions:**

* Confirm Gateway is running
* Pairing codes are case-sensitive, double check carefully
* Codes expire after Gateway restart, have the user send a new message

***

<Card title="Back to OpenClaw Manager Deployment Guide" icon="arrow-left" href="/en/integrations/platform/openclaw-manager">
  View the complete guide for Manager installation, deployment and instance management
</Card>
