Cách kết nối Hermes Agent với Telegram và quản lý tác vụ từ điện thoại

Khi không ở gần máy tính, bạn có thể nhắn tin hoặc đọc tác vụ cho Hermes Agent qua Telegram trên điện thoại, rồi nhận kết quả ngay trong cùng cuộc trò chuyện. Kết quả của các tác vụ được lên lịch sẽ được gửi đến cuộc trò chuyện mà bạn chọn làm cuộc trò chuyện chính một lần.

Nếu chưa có Hermes, hãy bắt đầu với hướng dẫn về agent này là gì và cách cài đặt, rồi quay lại để kết nối Telegram.

Bạn có thể xem thêm hướng dẫn trong tài liệu Ailoot.

Cần những gì để kết nối Hermes Agent với Telegram?#

Lệnh hermes doctor kiểm tra bản cài đặt Hermes và kết nối mô hình. Chúng ta sẽ tạo bot trong ứng dụng Telegram; bạn cần một máy tính để chạy lệnh trong terminal.

Tạo bot qua BotFather như thế nào?#

Mỗi bot Telegram đều có một token — khóa bí mật dùng để điều khiển bot. Token này do bot chính thức của Telegram là @BotFather cấp.

1. Mở @BotFather

   Tìm @BotFather trong Telegram hoặc mở t.me/BotFather. BotFather thật có dấu xác minh màu xanh. Bắt đầu cuộc trò chuyện bằng cách nhấn “Start”.

2. Gửi lệnh /newbot

   BotFather sẽ yêu cầu hai tên. Tên đầu tiên là tên hiển thị, bạn có thể đặt tùy ý, chẳng hạn “My Agent”. Tên thứ hai là tên người dùng: tên này phải duy nhất và kết thúc bằng bot, ví dụ moy_agent_bot.

3. Lấy token

   BotFather sẽ gửi lời chúc mừng cùng một chuỗi dài theo dạng 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Đây là token của bot. Hãy sao chép toàn bộ chuỗi.

Ngoài ra còn có cách nhanh hơn, không cần trò chuyện thủ công với BotFather. Trong bảng điều khiển web Hermes (hermes dashboard) và ứng dụng máy tính, tại trang “Messaging → Telegram” có nút “Create with QR”: quét mã bằng điện thoại, Hermes sẽ tạo bot, phát hiện ID của bạn, lưu token vào phần cài đặt và khởi động lại gateway. Các bước bên dưới hướng dẫn cách làm thủ công; nếu chọn QR, hãy chuyển thẳng đến bước kiểm tra kết nối.

Tìm Telegram ID ở đâu và vì sao cần ID này?#

Tài khoản Telegram có hai định danh: tên người dùng công khai có dấu @ và ID nội bộ dạng số. Hermes dùng ID dạng số.

Phương pháp “Tạo bằng QR” nhanh chóng được mô tả ở trên tự động phát hiện ID của bạn. Hãy ghi lại cùng với token.

Cung cấp token cho Hermes Agent và khởi chạy gateway như thế nào?#

1. Chạy trình hướng dẫn thiết lập

   hermes gateway setup
   

   Chạy lệnh trên máy đã cài Hermes. Trình hướng dẫn sẽ hiển thị danh sách ứng dụng nhắn tin.

2. Chọn Telegram và nhập thông tin

   Trình hướng dẫn sẽ hỏi token của bot và các ID được phép (bạn có thể nhập nhiều ID, phân tách bằng dấu phẩy), rồi lưu mọi thứ trực tiếp vào phần cài đặt.

3. Khởi chạy gateway

   hermes gateway
   

   Gateway sẽ khởi chạy và kết nối với Telegram. Sau vài giây, hãy gửi bất kỳ tin nhắn nào cho bot từ ứng dụng: nếu Hermes trả lời thì kết nối đã sẵn sàng.

Cách làm thủ công thay cho trình hướng dẫn như sau: mở tệp ~/.hermes/.env và thêm hai dòng, thay token bằng token từ BotFather và ID dạng số bằng ID Telegram của bạn:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Dòng thứ hai cho phép những người đó ở chat riêng và nhóm; cấp quyền chat nhóm riêng cũng có thể mở truy cập. Phân tách nhiều người bằng dấu phẩy. Sau khi lưu tệp, hãy khởi chạy gateway bằng lệnh hermes gateway như trên.

Nếu bot im lặng ngay cả trong cuộc trò chuyện riêng, hãy xem nhật ký gateway trong cùng terminal và trước tiên xác minh token cùng ID của bạn trong danh sách truy cập; các lỗi khác được trình bày trong bảng ở cuối bài viết.

Bot Telegram có thể làm gì trên điện thoại?#

Có năm khả năng bạn sẽ thường cần dùng nhất trên điện thoại.

Tin nhắn văn bản và tin nhắn thoại. Viết tác vụ bằng lời hoặc đọc thành tin nhắn thoại — nếu đã cấu hình nhận dạng giọng nói, Hermes sẽ chuyển lời nói thành văn bản và hiểu nội dung. Với nhà cung cấp cục bộ, bạn không cần khóa; mọi thứ được xử lý trên máy đang chạy agent.

Tệp và hình ảnh. Bạn có thể chuyển tiếp tài liệu, bảng tính hoặc ảnh chụp màn hình cho bot — agent sẽ nhận chúng dưới dạng tệp đính kèm. Agent cũng có thể gửi lại các tệp đã tạo: yêu cầu một báo cáo và agent sẽ gửi báo cáo dưới dạng tệp trong cuộc trò chuyện.

Xác nhận trước các hành động nguy hiểm. Khi agent sắp thực hiện việc có rủi ro, chẳng hạn xóa tệp, agent sẽ hỏi trong cuộc trò chuyện trước: trả lời “yes” hoặc “y” để thực hiện; trả lời “no” hoặc “n” để hủy.

Nhấn nút thay vì nhập câu trả lời. Khi agent cần làm rõ, agent sẽ gửi câu hỏi kèm các nút tùy chọn nội tuyến — nhấn một lựa chọn để agent tiếp tục làm việc. Lệnh /model không có tham số sẽ hiển thị menu chọn mô hình với các nút tương tự.

Thông báo yên lặng. Theo mặc định, điện thoại chỉ đổ chuông khi có câu trả lời cuối cùng, yêu cầu xác nhận và xác nhận lệnh. Các thông báo dịch vụ như “calling a tool” và “compressing context” được gửi im lặng, vì vậy điện thoại không đổ chuông ở mọi bước. Nếu muốn có âm thanh thông báo ở mọi bước, hãy đổi chế độ trong phần cài đặt.

Nhận kết quả của tác vụ chạy nền trong cuộc trò chuyện như thế nào?#

Cuộc trò chuyện chính cho tác vụ được lên lịch. Hermes hỗ trợ tác vụ được lên lịch, chẳng hạn “mỗi sáng lúc 7:43, tổng hợp cho tôi một bản tóm tắt”. Kết quả sẽ được gửi đến cuộc trò chuyện chính, được bạn chỉ định một lần bằng cách gửi lệnh /sethome trực tiếp trong cuộc trò chuyện với bot. Khi gateway còn chạy, bản tóm tắt sẽ tự động được gửi đến.

Tác vụ nền. Bạn có thể gửi một tác vụ dài để chạy trong nền rồi tiếp tục ngày của mình: bot sẽ nhắn khi hoàn tất. Tác vụ bắt đầu từ một chủ đề sẽ gửi câu trả lời lại chính chủ đề đó, để không thất lạc nội dung.

Giới hạn quan trọng: bot chỉ trả lời khi gateway đang chạy. Nếu tắt hoặc cho máy tính chạy Hermes vào chế độ ngủ, bot sẽ không trả lời cho đến khi máy hoạt động trở lại. Để giữ bot trực tuyến mọi lúc, hãy chuyển agent sang máy chủ: chúng tôi có hướng dẫn riêng về cách giữ Hermes Agent chạy liên tục. Theo mặc định, gateway thăm dò Telegram để tìm tin nhắn mới; với nền tảng đám mây chuyển sang chế độ ngủ khi không có lưu lượng đến, tài liệu hướng dẫn có chế độ webhook, đảo chiều kết nối để chính Telegram gửi yêu cầu đến bot.

Ngăn người lạ sử dụng bot như thế nào?#

Người khác có thể tìm thấy bot của bạn trên Telegram bằng tên người dùng, vì vậy việc bảo vệ dựa vào hai điều: danh sách truy cập và giữ bí mật token.

Trước hết cấu hình người gửi bằng TELEGRAM_ALLOWED_USERS. Với nhóm, xem thêm TELEGRAM_GROUP_ALLOWED_CHATS: liệt kê chat ở đó cho phép mọi thành viên dù ID không ở allowlist cá nhân. Riêng danh sách cá nhân rỗng chưa chứng minh mọi nhóm đóng.

Thứ hai là token. Không được để token xuất hiện trong ảnh chụp màn hình, tin nhắn chuyển tiếp hoặc kho lưu trữ. Nếu token bị lộ, hãy thu hồi bằng lệnh /revoke trong BotFather. Sau đó nhập token mới vào phần cài đặt và khởi động lại gateway.

Quyền người gửi và quyền chat khác nhau. Thành viên nhóm được phép qua TELEGRAM_GROUP_ALLOWED_CHATS dùng được bot dù ID không có ở TELEGRAM_ALLOWED_USERS. Nếu chỉ cho cá nhân, không cấp toàn nhóm; cấu hình và kiểm giới hạn người gửi của phiên bản đã cài. Nếu muốn bot chỉ trả lời trong nhóm khi được gọi, có một cài đặt telegram.require_mention — khi đó bot phản hồi khi được nhắc tên @, khi có người trả lời tin nhắn của bot, khi có lệnh như /command@yourbot và khi nội dung khớp với các mẫu trong telegram.mention_patterns; bot sẽ bỏ qua tin nhắn nhóm thông thường.

Vì sao bot im lặng trong nhóm và cách khắc phục?#

Bot Telegram mới mặc định bật chế độ riêng tư; tài liệu Hermes mô tả đây là nguyên nhân gây nhầm lẫn phổ biến nhất khi dùng bot trong nhóm. Ở chế độ này, bot chỉ nhận tin nhắn bắt đầu bằng lệnh /, câu trả lời cho tin nhắn của chính bot và thông báo dịch vụ. Bot đơn giản là không nhận tin nhắn nhóm thông thường — Telegram không gửi những tin nhắn đó cho bot, và không có cài đặt nào của agent khắc phục được điều này.

Cách khắc phục:

1. Mở @BotFather và gửi /mybots.
2. Chọn bot của bạn.
3. Mở “Bot Settings” → “Group Privacy” → “Turn off”.
4. Xóa bot khỏi nhóm rồi thêm lại.

Rất dễ bỏ sót bước thứ tư, khiến bot “vẫn im lặng”. Telegram ghi nhớ cài đặt riêng tư tại thời điểm bot tham gia nhóm và không cập nhật cho đến khi bot được xóa khỏi nhóm rồi thêm lại.

Nếu không muốn tắt quyền riêng tư trên toàn hệ thống, còn có lựa chọn thứ hai: đặt bot làm quản trị viên nhóm. Bot quản trị viên nhận được mọi tin nhắn ở mọi chế độ riêng tư.

Lỗi kết nối thường gặp và cách xử lý#

Mọi người còn hỏi gì về Hermes Agent trên Telegram?#

Khi sẵn sàng, hãy tìm hiểu về Ailoot.