Kết Nối Telegram Với OpenClaw Trên AgentBase - Hướng Dẫn Toàn Diện 2026 và Ứng Dụng Thực Tế

"Tại sao phải lo mấy thứ bot token làm gì?"

Bạn đã deploy được OpenClaw trên AgentBase rồi - chúc mừng! Agent đang chạy ngon lành, nhưng có một vấn đề: bạn phải mở browser vào OpenClaw Gateway mỗi lần muốn dùng.

Đôi khi đang ở ngoài, chỉ có điện thoại, muốn nhờ agent tóm tắt cái document hay nhắc deadline - nhưng không làm được vì không có đường vào.

Thế nhưng nếu agent có thể chat qua Telegram?

• Bạn đang họp, cần agent tra cứu thông tin ngay lập tức → Chat qua Telegram, 3 giây có kết quả
• Muốn agent gửi báo cáo tự động mỗi sáng 8h → Config một lần, agent tự đẩy tin nhắn
• Team cùng dùng một agent → Mọi người đều có thể chat, không cần chia sẻ tài khoản Gateway

Nghe hứa hẹn đúng không? Nhưng đây là lúc nhiều người nản --- vì phải lo "bot token", "pairing mode", "allow list"...

Đừng lo! Bài này mình sẽ hướng dẫn chi tiết từng bước, tất cả trong 10-15 phút.

Lộ trình bài viết

1. Hiểu cơ chế hoạt động --- Tại sao cần bot token?
2. STEP 1 --- Tạo bot Telegram và lấy token từ @BotFather
3. STEP 2 --- Cấu hình Telegram trên AgentBase (1-click)
4. STEP 3 --- Pairing với bot Telegram
5. STEP 4 --- Allow list --- Phân quyền cho team
6. STEP 5 --- Quản lý session cho nhiều user
7. Real-World Practice --- Case studies
8. Master Checklist --- Bookmark để làm lại

SECTION 1 - Hiểu Cơ Chế Hoạt Động

OpenClaw, AgentBase, và Telegram là gì?

OpenClaw = AI agent của bạn - có thể duyệt web, chạy lệnh, đọc file, viết code... cần kết nối với một LLM (bộ não) để hoạt động.

AgentBase = Nền tảng infrastructure giúp chạy OpenClaw trong 1 click, không cần DevOps. AgentBase quản lý runtime, credential, monitoring... cho bạn.

Telegram Bot = Cầu nối giữa bạn và OpenClaw - thay vì phải mở browser vào Gateway, bạn có thể chat qua Telegram như chat với bạn bè.

Cấu trúc kết nối

Bạn → [Telegram] → [AgentBase Gateway] → [OpenClaw Agent] → [LLM] → Trả lời qua Telegram

Hai chế độ kết nối

Telegram hỗ trợ cả 2 chế độ này - bạn sẽ học cách config ở các steps sau.

STEP 1 - Tạo Bot Telegram và Lấy Token Từ @BotFather

Tại sao cần bước này?

Telegram yêu cầu mọi bot phải đăng ký với @BotFather - bot quản lý chính thức của Telegram. BotFather sẽ cấp cho bạn một Bot Token - giống như API key để OpenClaw có thể điều khiển bot này.

Cách làm

1. Mở Telegram và tìm kiếm @BotFather (có dấu kiểm xanh màu xanh)
2. Nhấn "Start" hoặc gửi lệnh /start để bắt đầu
3. Gửi lệnh /newbot để tạo bot mới
4. BotFather sẽ hỏi:
   1. "Alright, a new bot. How are we going to call it? Please choose a name for your bot." → Nhập tên bot, ví dụ: Hana OpenClaw Assistant
   2. "Good. Now let's choose a username for your bot. It must end in bot. Like this, for example: TetrisBot or tetris_bot." → Nhập username, ví dụ: hana_openclaw_bot (phải kết thúc bằng bot)
5. Nhận Bot Token

BotFather sẽ trả về một tin nhắn chứa token:

Dãy số dài đó chính là Bot Token của bạn - copy và lưu vào nơi an toàn (password manager, encrypted file...)

Expected Result

• Success: Bạn có một bot Telegram với username @hana_openclaw_bot
• Success: Bot token đã được copy và lưu an toàn
• Error: Username đã tồn tại → Thử username khác, thêm số hoặc chữ cái
• Error: BotFather không phản hồi → Kiểm tra kết nối internet, thử lại sau

[Screenshot: Tin nhắn từ BotFather với token, highlight dòng token để người dùng biết cần copy phần nào]

STEP 2 - Cấu Hình Telegram Trên AgentBase Khi Deploy

Tại sao cần bước này?

AgentBase cần Bot Token của bạn để điều khiển bot Telegram và kết nối nó với OpenClaw instance.

Cách làm

Cấu hình ngay khi deploy OpenClaw (1-click setup)

1. Truy cập Agent Marketplace trên AgentBase
2. Click "Deploy OpenClaw With 1 Click!"
3. Ở phần "Cấu hình Channel (Tùy chọn)":
   1. Chọn "Telegram"
   2. Điền Bot Token: Paste token từ Step 1 (VD: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)
4. Click "Deploy"

AgentBase sẽ tự động:

• Tạo OpenClaw instance
• Kết nối bot Telegram với instance
• Cấu hình webhook để bot nhận tin nhắn

Expected Result

• Success: Deploy thành công, instance status "Online"
• Success: Nhận được URL truy cập OpenClaw Gateway
• Success: Bot Telegram hiện trạng thái "online" (có thể test ngay)
• Error: "Invalid bot token" → Kiểm tra lại token, đảm bảo copy đầy đủ, không có khoảng trắng
• Error: Deploy failed → Kiểm tra log trong AgentBase Dashboard, thử lại

Tip: Sau khi deploy thành công, bot đã hoạt động! Bạn có thể test ngay bằng cách start bot trên Telegram - bot sẽ gửi pairing code để bạn kết nối.

STEP 3 - Pairing Với Bot Telegram

Tại sao cần Pairing?

Sau khi deploy, bot đã hoạt động nhưng chưa kết nối với user nào cả. Bạn cần pairing để "đăng ký" tài khoản Telegram của mình với OpenClaw.

Quy trình Pairing

1. Mở Telegram, tìm bot bạn vừa tạo (@hana_openclaw_bot)
2. Nhấn "Start" hoặc nhắn /start
3. Bot sẽ gửi pairing code:

Your pairing code is: ABC123DEF456

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

4. Mở OpenClaw Gateway Dashboard:
   1. Truy cập từ My Agents Dashboard trên AgentBase
   2. Click "Open" để vào Gateway của instance bạn vừa deploy
5. Chat trực tiếp trên Dashboard để approve pairing:

Cách 1: Chat trong Dashboard Interface (Đơn giản nhất)

1. Tìm ô chat trên Dashboard (giống chat với AI)
2. Gõ: openclaw pairing approve telegram ABC123DEF456
3. Enter và đợi xác nhận

Cách 2: Dùng Console/Terminal

1. Vào section "Console" hoặc "Terminal"
2. Gõ: openclaw pairing approve telegram ABC123DEF456
3. Xác nhận pairing thành công:
4. Thử chat ngay trên Telegram:

"Xin chào, bạn là ai?"

Bot sẽ trả lời ngay lập tức!

Expected Result

• Success: Bot trả lời tin nhắn của bạn trên Telegram
• Success: Dashboard hiển thị user của bạn trong danh sách "Connected Users"
• Success: Chat 2 chiều hoạt động tốt
• Error: "Pairing code expired" → Lấy pairing code mới bằng cách /start lại trên Telegram
• Error: "Invalid pairing code" → Kiểm tra lại code, đảm bảo copy chính xác không có khoảng trắng
• Error: Bot không trả lời → Kiểm tra trong Dashboard xem instance đã online chưa

Tip: Sau khi pairing thành công, bạn có thể chat với OpenClaw từ bất cứ đâu --- chỉ cần mở Telegram và nhắn tin cho bot!

STEP 4 - Allow List Mode - Phân Quyền Cho Team

Tại sao cần Allow List?

Sau khi đã connect được cho chính mình, bạn muốn team cùng dùng. Nếu bạn muốn:

• Team của bạn (5-10 người) cùng dùng một OpenClaw agent
• Không muốn mỗi người phải pairing riêng lẻ
• Quản lý tập trung ai được phép chat

→ Allow list là giải pháp. User có ID trong danh sách sẽ chat được mà không cần pairing.

Pairing Mode + AllowFrom hoạt động cùng nhau

User trong allowFrom:

• Chat được ngay lập tức, không cần code pairing
• Đã được "pre-approved" (phê duyệt trước)
• Không bị yêu cầu code nữa

User KHÔNG có trong allowFrom:

• Cần code pairing lần đầu
• Sau khi approve → tự động thêm vào allowFrom
• Lần sau chat không cần code nữa

Cách thêm user vào Allow List

Cách 1: Chat với OpenClaw để request thêm (Đơn giản nhất!)

1. Mở OpenClaw Gateway Dashboard hoặc chat trực tiếp với bot trên Telegram
2. Gửi lệnh request thêm user:

Trên Dashboard hoặc Telegram, chat:

3. OpenClaw sẽ tự động:
   1. Kiểm tra user ID có tồn tại không
   2. Thêm vào allow list config
   3. Save và restart gateway
   4. Thông báo kết quả

Cách 2: Tự edit config trong Dashboard

1. Lấy User ID của người dùng:
   1. Trong OpenClaw Gateway, xem "Incoming Messages" → mỗi tin nhắn có kèm user ID
2. Vào OpenClaw Gateway → Settings → Config
3. Tìm section telegram → allowFrom, thêm user ID

4. Nhấn "Save & Restart Gateway"

Thông báo cho team

Sau khi đã thêm vào allow list, mỗi người chỉ cần:

• Tìm bot @hana_openclaw_bot trên Telegram
• Nhấn "Start" hoặc nhắn /start
• Chat ngay --- không cần pairing!

Expected Result

• Success: Mọi người trong allow list đều chat được với bot ngay
• Success: Người không trong list nhắn tin nhưng bot không phản hồi
• Success: OpenClaw tự động thêm user và restart gateway (Cách 1)
• Success: Allowlist hiện tại hiển thị đầy đủ user
• Error: User trong list vẫn không chat được → Kiểm tra lại user ID
• Error: OpenClaw báo "Không tìm thấy user" → Kiểm tra lại user ID
• Error: Gateway không restart → Kiểm tra log trong Dashboard

Tip: Cách 1 (chat với OpenClaw) nhanh hơn nhiều! OpenClaw tự động thêm và restart, bạn không cần lo syntax JSON.

Warning: Allow list chỉ nên dùng cho team nhỏ (<20 người). Nếu lớn hơn, cân nhắc tạo nhiều bot instance.

STEP 5 - Quản Lý Session Cho Nhiều User

Tại sao cần hiểu về Session?

Khi bạn đã thêm nhiều user vào allow list, mỗi người có session riêng biệt. Điều này quan trọng vì:

• Mỗi user có chat history riêng - Không bị trộn lẫn
• Admin có thể xem tất cả - Để monitor và hỗ trợ
• Session isolation - User không thấy chat của người khác

Quy trình hoạt động

1. User A (Hana) chat:

Session: telegram:66...
History: "Nhiệt độ hiện tại ở TP HCM..."

2. User B (Nguyen B) chat:

Session: telegram:103...
History: "Tóm tắt và giải thích đoạn văn..."

3. Admin xem trên Dashboard:

Sessions Tab:
telegram:66.. (Hana)
Last: "nhiệt độ hiện tại ở TP HCM..."
Status: running

telegram:103.. (Nguyen B)
Last: "tóm tắt và giải thích đoạn..."
Status: running

Xem Session trên Dashboard

Cách 1: Dùng Sessions Tab

1. Mở OpenClaw Gateway Dashboard
2. Chọn tab "Sessions"
3. Thấy danh sách tất cả user đang active
4. Click vào session để xem chat history của user đó

Cách 2: Dùng Console

# Liệt kê tất cả sessions
openclaw sessions list

# Xem chi tiết một session
openclaw sessions get telegram:1034442564

Quyền hạn

Expected Result

• Success: Mỗi user có session riêng, chat không bị trộn
• Success: Admin xem được tất cả sessions trên Dashboard
• Success: Filter sessions theo user, theo thời gian
• Error: Không thấy session của user mới → User chưa chat lần nào
• Error: Session không hoạt động → Kiểm tra user có trong allow list không

Tip: Session rất hữu ích khi admin cần hỗ trợ user! Bạn có thể xem chính xác user đang hỏi gì, OpenClaw đã trả lời gì.

Real-World Practice - Case Studies

Case 1: BA dùng Telegram để tóm tắt email mỗi sáng

"Tôi mất 30 phút mỗi sáng để đọc email và highlight action item cho team."

Cách setup

1. Kết nối OpenClaw với Telegram (theo các Step ở trên)
2. Tạo skill trong OpenClaw:
   1. Tên: Email Morning Summary
   2. Trigger: Mỗi sáng 8h
   3. Action: Đọc email mới → Tóm tắt → Gửi qua Telegram group
3. Thêm toàn bộ team vào allow list bằng cách chat với OpenClaw: "Thêm 5 user ID 666410277, 1034442564, 123456789, 987654321, 456789123 vào Telegram allow list"

Kết quả

• Team nhận tóm tắt email 8h sáng --- không cần đọc từng cái
• Action item được highlight --- ai làm gì rõ ràng
• BA không phải làm thủ công nữa

Time saved: 30 phút/ngày × 5 ngày = 2.5 giờ/tuần

Case 2: Team dev dùng Telegram để monitor production

"Team dev phải check logs thủ công, rất mất thời gian."

Cách setup

1. Kết nối OpenClaw với Telegram
2. Tạo skill monitoring:
   1. Đọc logs từ production server
   2. Phát hiện lỗi, warning
   3. Gửi alert qua Telegram khi có issue
3. Thêm team dev (5 người) vào allow list

Kết quả

• Team nhận alert real-time khi có lỗi
• Không cần check logs thủ công liên tục
• Response time giảm từ 30 phút → 2 phút

Time saved: 2-3 giờ/ngày cho cả team

Additional Resources

Tips & Tricks

1. Lưu bot token vào nơi an toàn

Đừng bao giờ lưu token trong file công khai (GitHub, Google Docs public). Dùng:

• Password manager: 1Password / LastPass / Bitwarden
• File local trên máy, encrypted
• Environment variable (nếu bạn dev)

2. Test pairing mode trước khi dùng allow list

Đừng ngay lập tức setup allow list cho cả team. Hãy:

1. Test pairing cho chính bạn trước
2. Cho 1-2 đồng nghiệp test
3. Khi mọi thứ OK → mới setup allow list cho tất cả

3. Quản lý session và monitor users

Sau khi kết nối Telegram:

• Xem Sessions tab → Theo dõi user đang chat
• Kiểm tra chat history → Xem user đang hỏi gì
• Filter theo user → Tìm session cụ thể
• Monitor activity → Biết ai đang active, ai cần hỗ trợ

Điều này giúp bạn:

• Hỗ trợ user khi gặp vấn đề
• Audit chat history nếu cần
• Optimise performance dựa trên usage

4. Dùng chat với OpenClaw để quản lý allow list

Thay vì edit config thủ công, hãy chat trực tiếp với OpenClaw:

• "Thêm user ID 123456789 vào Telegram allow list" → OpenClaw tự động thêm
• "Cho tôi xem danh sách allow list" → OpenClaw hiển thị tất cả user

Nhanh hơn, ít lỗi hơn, và không cần lo syntax JSON!

5. Backup cấu hình channel

Nếu mất token:

• Telegram: Dùng lệnh /token trong @BotFather để regenerate

Master Checklist --- Bookmark Để Làm Lại

TELEGRAM SETUP

•  Tạo bot với @BotFather
• Copy bot token và lưu an toàn
• Deploy OpenClaw trên AgentBase với bot token
• Start bot trên Telegram (/start)
• Nhận pairing code từ bot
• Mở OpenClaw Gateway Dashboard
• Chat trên Dashboard để approve pairing code
• Chat thử với bot qua Telegram
• (Optional) Thêm team vào allow list: Chat "Thêm user ID 123456789 vào Telegram allow list"
• Thông báo team start bot và chat ngay (không cần pairing)
• (Optional) Kiểm tra Sessions tab → Xem user đang chat

BEST PRACTICES

• Lưu token vào password manager
• Test pairing trước allow list
• Monitor sessions trong AgentBase Dashboard (Sessions tab)
• Xem chat history để hỗ trợ user khi cần
• Thêm user vào allow list bằng cách chat với OpenClaw (đơn giản nhất!)
• Backup cấu hình channel (token)