Thiết lập Bot Telegram
Hướng dẫn từng bước kết nối Claw Buff agent với Telegram
Kết nối AI Agent Claw Buff với Telegram để người dùng có thể trò chuyện qua tin nhắn trực tiếp hoặc trong nhóm chat. Quá trình thiết lập mất khoảng 5 phút.
Yêu cầu trước khi bắt đầu
- Tài khoản Telegram
- Agent Claw Buff đã được triển khai (Bắt đầu sử dụng)
Bước 1: Tạo Bot với BotFather
Mở BotFather
Mở Telegram và tìm @BotFather (nhận dạng bằng dấu tích xanh xác minh). Đây là bot chính thức của Telegram dùng để tạo và quản lý bot.
Tạo bot
Gửi lệnh /newbot cho BotFather và làm theo hướng dẫn:
- Tên bot — Tên hiển thị cho bot của bạn (ví dụ: "My AI Assistant")
- Username — Phải kết thúc bằng
bot(ví dụ:my_claw_bot)
Lưu Bot Token
BotFather sẽ trả về một Bot Token có dạng:
123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
Sao chép token này — bạn sẽ cần nó ở bước tiếp theo.
Giữ bí mật Bot Token của bạn. Bất kỳ ai có token đều có thể điều khiển bot. Tuyệt đối không chia sẻ trong nhóm chat công khai hay commit lên Git.
Bước 2: Kết nối với Claw Buff
- Mở Bảng điều khiển Claw Buff → trang Kênh liên lạc
- Tìm thẻ Telegram và nhấn Connect
- Dán Bot Token từ Bước 1
- Nhấn Save & Activate
Agent sẽ kết nối với Telegram trong vài giây. Bạn sẽ thấy trạng thái chuyển sang Connected.
Bước 3: Cấp quyền truy cập
Mặc định, bot sử dụng chế độ ghép nối — người dùng mới cần được phê duyệt trước khi có thể trò chuyện. Khi ai đó nhắn tin cho bot lần đầu, họ sẽ thấy:
OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234
Phê duyệt qua Yêu cầu chờ xử lý
Vào Bảng điều khiển Claw Buff → Kênh liên lạc. Khi có người yêu cầu truy cập, mục Pending Pairing Requests sẽ tự động xuất hiện với mã chờ xử lý. Nhấn Approve bên cạnh yêu cầu.
Mã ghép nối hết hạn sau 1 giờ. Nếu hết hạn, người dùng chỉ cần nhắn lại cho bot để nhận mã mới.
Quản lý người dùng được cấp quyền
Bạn cũng có thể quản lý quyền truy cập trực tiếp. Nhấn Manage trên thẻ kênh Telegram để:
- Xem tất cả người dùng đã được cấp quyền
- Thêm người dùng bằng cách nhập Telegram user ID (cấp quyền chủ động)
- Xóa người dùng để thu hồi quyền truy cập
Bước 4: Bắt đầu trò chuyện
Mở Telegram, tìm bot theo username và gửi tin nhắn. AI Agent sẽ phản hồi ngay!
Thiết lập nhóm chat
Để sử dụng bot trong nhóm Telegram:
- Thêm bot vào nhóm
- Bot sẽ phản hồi khi được @mention theo mặc định
Trong nhóm, bot chỉ phản hồi khi được nhắc đến (ví dụ: @my_claw_bot thời tiết hôm nay thế nào?). Điều này tránh việc bot phản hồi mọi tin nhắn trong các nhóm hoạt động sôi nổi.
Tính năng
| Tính năng | Hỗ trợ |
|---|---|
| Tin nhắn trực tiếp | Có |
| Nhóm chat | Có (cần mention) |
| Phản hồi trực tuyến | Có (gõ theo thời gian thực) |
| Định dạng phong phú | Có (HTML/Markdown) |
| Chủ đề Forum | Có |
| Tệp đính kèm | Có |
Câu hỏi thường gặp
1. Bot không phản hồi?
- Kiểm tra token — Đảm bảo bạn đã dán đầy đủ token, không có khoảng trắng thừa
- Kiểm tra Bảng điều khiển — Trang Kênh liên lạc hiển thị trạng thái kết nối và nhật ký lỗi
- Sự cố mạng — Agent cần quyền truy cập ra ngoài tới
api.telegram.orgtrên cổng 443
2. Bot phản hồi chậm?
Tính năng streaming được bật mặc định. Bot chỉnh sửa tin nhắn theo thời gian thực khi AI tạo phản hồi. Nếu bạn thấy chậm trễ, hãy kiểm tra cấu hình mô hình trong Bảng điều khiển → Agent → Model.
3. "Forbidden: bot was blocked by the user"?
Người dùng đã chặn bot trên Telegram. Họ cần bỏ chặn và gửi lại /start.