Lấy Telegram Bot Token và kết nối bot với OpenClaw
Tạo bot bằng BotFather, lưu token an toàn, kết nối Telegram và duyệt pairing trước khi trò chuyện với agent.

Telegram Bot Token là bí mật mà BotFather cấp để một ứng dụng điều khiển bot Telegram. OpenClaw dùng token đó để nhận và gửi tin nhắn. Quy trình gồm tạo bot, nhận token, cấu hình kênh Telegram và chỉ cho phép tài khoản được duyệt tương tác với agent.
Bot Token xác thực bot với Telegram; nó khác API key dùng để gọi model AI. Vì vậy bạn cần cấu hình cả hai phần: kênh Telegram và provider/model của OpenClaw. Nếu muốn dùng Slack thay Telegram, xem hai loại token Slack.
Cách lấy API Token Telegram để kết nối với OpenClaw
Các bước bên dưới giữ riêng việc tạo danh tính bot và việc cho bot kết nối vào agent. Hãy chuẩn bị tài khoản Telegram của bạn và quyền quản trị instance OpenClaw.
Bước 1: Khởi tạo bot mới trên Telegram
- Mở Telegram hoặc Telegram Web, tìm đúng @BotFather.
- Kiểm tra tài khoản chính thức có dấu xác minh để tránh trao quyền cho tài khoản giả.
- Bấm Start nếu cần rồi gửi /newbot để tạo bot mới.

Bước 2: Thiết lập tên hiển thị
Khi BotFather hỏi tên hiển thị, nhập tên mô tả vai trò của bot, ví dụ “Giang AI Assistant”. Tên này là nhãn người dùng nhìn thấy, chưa phải username để tìm kiếm.

Bước 3: Thiết lập tên người dùng
Chọn username chưa có người sử dụng và kết thúc bằng bot hoặc _bot, ví dụ giang_api_demo_bot. Theo quy tắc BotFather, username phải đáp ứng giới hạn ký tự và độ dài của Telegram; nếu tên đã tồn tại, chọn tên khác rồi gửi lại.

Bước 4: Sao chép mã Token
BotFather sẽ xác nhận bot đã được tạo và đưa ra token dùng cho HTTP API. Sao chép đúng chuỗi token và lưu trong trình quản lý bí mật, không lưu bằng ảnh chụp màn hình.

Ai nắm token có thể điều khiển bot. Nếu nghi token đã bị lộ, mở BotFather để thu hồi/thay token, rồi cập nhật cấu hình OpenClaw. Không đưa token vào bài viết, kho mã hoặc tin nhắn gửi người khác.
Bước 5: Kết nối vào OpenClaw
- Mở cấu hình kênh Telegram trong instance OpenClaw mà bạn quản trị.
- Bật kênh Telegram và nhập Bot Token vừa nhận; nếu giao diện có lựa chọn chính sách tin nhắn, ưu tiên pairing hoặc allowlist.
- Lưu cấu hình và áp dụng theo phiên bản đang chạy. Tên mục trên Control UI hoặc bảng điều khiển của đơn vị hosting có thể khác nhau.
Một trạng thái kết nối thành công chỉ xác nhận hệ thống đã nhận token và liên lạc được với Telegram; nó chưa chứng minh người dùng đã được cấp quyền hay model AI hoạt động.
Với bản cài trực tiếp, bạn có thể thêm kênh bằng CLI. Sau khi nhắn bot lần đầu, liệt kê và duyệt yêu cầu pairing của chính mình theo Telegram setup của OpenClaw:
openclaw channels add --channel telegram --token <bot-token>
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>Bước 6: Kiểm tra thực tế
Tìm username bot vừa tạo, mở cuộc chat và nhấn Start. Hãy bảo đảm model và thông tin xác thực đã được cấu hình trước khi kiểm tra khả năng trả lời.

Gửi một câu ngắn sau khi pairing được duyệt. Nếu không có phản hồi, kiểm tra trạng thái kênh và log Gateway thay vì liên tục gửi thêm tin.

Bạn có thể đối chiếu tin nhắn trong Telegram với phiên hoặc log tương ứng ở Gateway. Việc agent tự nói tên model chỉ mang tính tham khảo; kiểm tra cấu hình và trạng thái model để xác nhận chính xác.

Khi bot đã nhận và trả lời ổn định, mới bổ sung tác vụ định kỳ hoặc công cụ. Chỉ cho phép tài khoản đáng tin ra lệnh và rà quyền trước khi giao tác vụ có thể sửa dữ liệu.
Các bài viết liên quan:
- Đổi provider, model và API key trong OpenClaw
- Lấy token Slack để nối với OpenClaw
- Kết nối ChatGPT/Codex bằng OAuth
- API key và OAuth khác nhau thế nào?
Kết luận
Tạo bot thành công mới là nửa đầu của quá trình. Phần còn lại là giữ kín token, cấu hình đúng kênh, duyệt người dùng và kiểm tra một lượt gọi model thật. Làm đủ các bước này giúp bot hoạt động và hạn chế người lạ dùng agent của bạn.
Những câu hỏi thường gặp
API Token Telegram có hết hạn không?
Bot token thường tiếp tục hoạt động cho đến khi bị thu hồi hoặc thay mới, thay vì có thời hạn ngắn như access token OAuth. Hãy quản lý và thay token qua BotFather khi có rủi ro lộ bí mật.
Một token Telegram dùng chung cho OpenClaw và n8n được không?
Không nên để hai ứng dụng cùng nhận cập nhật cho một bot. Long polling hoặc webhook có thể xung đột và làm mất luồng xử lý mong đợi. Tạo bot riêng cho OpenClaw và n8n sẽ dễ vận hành hơn.
Vì sao bot đã kết nối nhưng không trả lời?
Kiểm tra lần lượt: token còn hợp lệ, Gateway đang chạy, yêu cầu pairing đã được duyệt, model/provider có thông tin xác thực và còn hạn mức. Dùng openclaw pairing list telegram để xem người dùng đang chờ.
Có cần mở cổng trên VPS để bot Telegram hoạt động không?
Ở chế độ long polling mặc định, Gateway chủ động kết nối ra Telegram nên thường không cần mở cổng inbound riêng cho Telegram. Nếu bạn chọn webhook thì phải đáp ứng thêm yêu cầu endpoint HTTPS của chế độ đó.