Bài này hướng dẫn từng bước cách tích hợp Telegram channel vào OpenClaw. Ở phần này, mình làm hai việc cốt lõi ngay từ đầu:

Tạo bot Telegram bằng BotFather
Cấu hình Telegram channel trong OpenClaw

Mục tiêu là sau khi đọc xong bài này, bạn đã có bot Telegram, có bot token, và đã khai báo đúng cấu hình để chuẩn bị chạy Gateway ở bước tiếp theo.

1) Telegram channel trong OpenClaw hoạt động như thế nào?

OpenClaw hỗ trợ Telegram qua Bot API. Theo tài liệu hiện tại:

Telegram dùng Bot API
Hỗ trợ tốt cho DM và group
Long polling là chế độ mặc định
Telegram không dùng openclaw channels login telegram
Cách đúng là: tạo bot, lấy token, đưa token vào config, rồi chạy gateway

Nói ngắn gọn: muốn dùng Telegram với OpenClaw, bạn không đăng nhập kiểu QR hay OAuth, mà dùng bot token do Telegram cấp qua BotFather.

2) Chuẩn bị trước khi bắt đầu

Trước khi cấu hình Telegram cho OpenClaw, cần có:

OpenClaw đã được cài xong
Máy đang chạy được OpenClaw
Có quyền chỉnh file config của OpenClaw
Có tài khoản Telegram để tạo bot

File cấu hình thường dùng của OpenClaw:

~/.openclaw/openclaw.json

OpenClaw dùng JSON5, nên bạn có thể dùng comment và dấu phẩy cuối.

3) Bước 1: Tạo bot Telegram bằng BotFather

Bot chính thức để tạo bot mới trên Telegram là @BotFather.

Cần kiểm tra đúng handle:

@BotFather

Các bước thực hiện

Mở Telegram
Tìm @BotFather
Mở cuộc trò chuyện với bot này
Gõ lệnh:

/newbot

BotFather sẽ yêu cầu bạn nhập:
- Tên bot: tên hiển thị
- Username bot: phải duy nhất, thường kết thúc bằng bot

Ví dụ:

Tên bot: OpenClaw Assistant
Username bot: my_openclaw_helper_bot

Sau khi hoàn tất, BotFather sẽ trả về cho bạn một bot token có dạng:

123456789:AA...

Lưu ý bảo mật

Không chia sẻ token cho người khác
Ai có token thì có thể điều khiển bot
Nên lưu lại token ở nơi an toàn

Hình minh họa

Tạo bot với BotFather

Chú thích: Giao diện tạo bot mới với BotFather trên Telegram.

4) Cấu hình Telegram channel trong OpenClaw

Ngay sau khi có bot token, bạn có thể cấu hình Telegram trong OpenClaw luôn.

Mở file:

~/.openclaw/openclaw.json

Thêm cấu hình cơ bản:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: {
        "*": { requireMention: true }
      }
    }
  }
}

Giải thích từng dòng

enabled: true
- bật Telegram channel trong OpenClaw
botToken: "123:abc"
- token lấy từ BotFather
- phải thay bằng token thật của bạn
dmPolicy: "pairing"
- khi người đầu tiên nhắn bot trong DM, OpenClaw sẽ yêu cầu pairing approval
groups: { "*": { requireMention: true } }
- trong group, bot chỉ phản hồi khi được mention

5) `dmPolicy` là gì và nên chọn gì?

OpenClaw kiểm soát quyền DM qua channels.telegram.dmPolicy.

Các giá trị chính:

pairing: người lạ nhắn lần đầu sẽ tạo mã pairing để admin approve
allowlist: chỉ user trong allowFrom mới được dùng bot
open: mở cho tất cả, nhưng cần allowFrom: ["*"]
disabled: tắt DM hoàn toàn

Khuyến nghị thực tế

Nếu đang thiết lập ban đầu, nên dùng:

dmPolicy: "pairing"

Nếu bot chỉ phục vụ đúng một người hoặc một nhóm rất nhỏ, về lâu dài có thể chuyển sang:

dmPolicy: "allowlist"

6) Có thể dùng biến môi trường thay cho `botToken` không?

Có. OpenClaw hỗ trợ fallback:

TELEGRAM_BOT_TOKEN=...

Nhưng thực tế triển khai ổn định thì cấu hình trong file thường rõ ràng hơn, đặc biệt khi bạn muốn kiểm soát chính xác account nào đang dùng token nào.

7) Kết luận

Sau bài này, bạn đã có:

bot Telegram được tạo bằng BotFather
bot token hợp lệ
cấu hình Telegram cơ bản trong OpenClaw

Ở bước tiếp theo, có thể làm tiếp:

chạy openclaw gateway
nhắn thử cho bot
xem pairing request
approve pairing
thêm bot vào group
xử lý privacy mode và mention

Nếu bạn đang làm theo từng bước, hãy kiểm tra lại token và file config trước khi sang bước tiếp theo.