> For the complete documentation index, see [llms.txt](https://docs.vngcloud.vn/vng-cloud-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/agent-runtime/openclaw/get-bot-token-and-pairing.md).

# Get Bot Token & Pairing

> This guide covers how to get a bot token and complete pairing to connect a chat channel with OpenClaw on AgentBase. If you haven't deployed OpenClaw yet, see: [Deploy & Manage OpenClaw](/vng-cloud-document/ai-stack/agent-base/agent-runtime/openclaw/deploy-and-manage-openclaw.md).

## Part 1 — Get a Bot Token from Telegram

### Step 1: Create a new bot on BotFather

1. Open Telegram and search for **@BotFather** (official blue checkmark).
2. Send the command `/newbot`.
3. Enter a **display name** for your bot (e.g. `My OpenClaw Bot`).
4. Enter a **username** — must end with `bot` (e.g. `my_openclaw_bot`).

### Step 2: Copy the Bot Token

After creation, BotFather returns a message containing a token in this format:

```
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```

Copy this token and store it somewhere safe — you will need it when configuring the Telegram channel in AgentBase.

> **Note:** The token is a secret — do not share it publicly.

***

## Part 2 — Pair your Telegram account with OpenClaw

### Step 1: Get the Pairing Code

1. Open Telegram and find the bot you just created (e.g. `@my_openclaw_bot`).
2. Tap **Start** or send `/start`.
3. The bot replies with a **pairing code**, for example:

```
Your pairing code is: ABC123DEF456

Please run this command in OpenClaw:
openclaw pairing approve telegram ABC123DEF456
```

### Step 2: Approve Pairing in OpenClaw Gateway

Go to **OpenClaw Gateway Dashboard** → find the chat box and enter:

```
openclaw pairing approve telegram <pairing_code>
```

Replace `<pairing_code>` with the code from Step 1.

### Result

* Pairing successful → the bot starts receiving and replying to your messages on Telegram.
* If the code expires → send `/start` again on Telegram to get a new code.

***

## Part 3 — Get a Bot Token from Zalo

> **Note:** The Zalo channel is currently **Experimental**. Direct Messages (DM) are fully supported; group and media features may be unstable.

### Step 1: Create a bot on Zalo Platform

1. Go to <https://bot.zaloplatforms.com> and log in with your Zalo account.
2. Create a new bot, set a name (e.g. `Hana OpenClaw Bot`), and fill in the basic info.
3. Once created, open **bot settings** and copy the **Bot Token**.

### Step 2: Copy the Bot Token

Zalo tokens follow the format `numeric_id:secret`, for example:

```
1234567890123456789:abcXYZexampleTokenSecretKey123
```

Copy the **full token** (including everything after the `:`).

> **Note:** Zalo tokens are longer than Telegram tokens — make sure you copy the complete `:secret` part.

***

## Part 4 — Pair your Zalo account with OpenClaw

### Step 1: Get the Pairing Code

1. Open Zalo and send a message to the bot you just created.
2. Send `/start` or `Hello`.
3. The bot replies with an 8-character **pairing code** (e.g. `EXMP1234`). The code is valid for **1 hour**.

### Step 2: Approve Pairing in OpenClaw Gateway

Go to **OpenClaw Gateway Dashboard** → find the chat box and enter:

```
openclaw pairing approve zalo <pairing_code>
```

Replace `<pairing_code>` with the code from Step 1.

### Result

* Pairing successful → the bot starts receiving and replying to your messages on Zalo.
* If the code expires → send `/start` again on Zalo to get a new code.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/agent-runtime/openclaw/get-bot-token-and-pairing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.