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

# Lấy Bot Token và Pairing

> Tài liệu này hướng dẫn lấy bot token và pairing để kết nối kênh chat với OpenClaw trên AgentBase. Nếu bạn chưa triển khai OpenClaw, xem trước: [Triển khai và Quản lý OpenClaw](/vn/ai-stack/agent-base/agent-runtime/openclaw/trien-khai-openclaw-1-click.md).

## Phần 1 — Lấy Bot Token từ Telegram

### Bước 1: Tạo bot mới trên BotFather

1. Mở Telegram, tìm và chat với **@BotFather** (có dấu kiểm xanh chính thức).
2. Gửi lệnh `/newbot`.
3. Nhập **tên hiển thị** của bot (ví dụ: `My OpenClaw Bot`).
4. Nhập **username** — bắt buộc kết thúc bằng `bot` (ví dụ: `my_openclaw_bot`).

<figure><img src="/files/QrOo2th0QN6vZHdYjiVI" alt=""><figcaption></figcaption></figure>

### Bước 2: Lấy Bot Token

Sau khi tạo xong, BotFather trả về tin nhắn chứa token có dạng:

```
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
```

Sao chép token này và lưu vào nơi an toàn — bạn sẽ cần dùng khi cấu hình kênh Telegram trong AgentBase.

> **Lưu ý:** Token là thông tin bí mật, không chia sẻ công khai.

***

## Phần 2 — Pairing tài khoản Telegram với OpenClaw

### Bước 1: Lấy Pairing Code

<figure><img src="/files/fMffcPtKoXuTrZHeKxoc" alt=""><figcaption></figcaption></figure>

1. Mở Telegram, tìm bot bạn vừa tạo (ví dụ: `@my_openclaw_bot`).
2. Nhấn **Start** hoặc gửi `/start`.
3. Bot phản hồi một **pairing code**, ví dụ:

```
Your pairing code is: ABC123DEF456

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

### Bước 2: Approve Pairing trong OpenClaw Gateway

Truy cập **OpenClaw Gateway Dashboard** → tìm ô chat, sau đó nhập:

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

Thay `<pairing_code>` bằng code nhận được ở Bước 1.

### Kết quả

* Pairing thành công → bot bắt đầu nhận và trả lời tin nhắn của bạn trên Telegram.
* Nếu code hết hạn → gửi lại `/start` trên Telegram để lấy code mới.

<figure><img src="/files/d2rCOE88WiohZfBc2m09" alt=""><figcaption></figcaption></figure>

***

## Phần 3 — Lấy Bot Token từ Zalo

> **Lưu ý:** Zalo channel hiện đang ở trạng thái **Experimental**. Direct Message (DM) hoạt động đầy đủ; tính năng group và media có thể không ổn định.

### Bước 1: Tạo bot trên Zalo Platform

1. Truy cập <https://bot.zaloplatforms.com> và đăng nhập bằng tài khoản Zalo.
2. Tạo bot mới, đặt tên (ví dụ: `Hana OpenClaw Bot`) và cấu hình thông tin cơ bản.
3. Sau khi tạo xong, vào **bot settings** và sao chép **Bot Token**.

<figure><img src="/files/f3oDA9AoxOB1IHMTCvuE" alt=""><figcaption></figcaption></figure>

### Bước 2: Lấy Bot Token

Token Zalo có dạng `numeric_id:secret`, ví dụ:

```
1234567890123456789:abcXYZexampleTokenSecretKey123
```

Sao chép **toàn bộ** token (bao gồm cả phần sau dấu `:`) và lưu vào nơi an toàn.

<figure><img src="/files/aG9D1jiGVCTqvFHwlbY4" alt=""><figcaption></figcaption></figure>

> **Lưu ý:** Token Zalo thường dài hơn Telegram — đảm bảo copy đầy đủ, không bỏ sót phần `:secret`.

***

## Phần 4 — Pairing tài khoản Zalo với OpenClaw

### Bước 1: Lấy Pairing Code

1. Mở Zalo, tìm và nhắn tin cho bot vừa tạo.
2. Gửi `/start` hoặc `Xin chào`.
3. Bot phản hồi một **pairing code** (8 ký tự), ví dụ: `EXMP1234`. Code có hiệu lực trong **1 giờ**.

<figure><img src="/files/YaFYslk3djRNeYSItqb8" alt=""><figcaption></figcaption></figure>

### Bước 2: Approve Pairing trong OpenClaw Gateway

Truy cập **OpenClaw Gateway Dashboard** → tìm ô chat, sau đó nhập:

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

Thay `<pairing_code>` bằng code nhận được ở Bước 1.

### Kết quả

* Pairing thành công → bot bắt đầu nhận và trả lời tin nhắn của bạn trên Zalo.
* Nếu code hết hạn → nhắn `/start` lại trên Zalo để lấy code mới.