Hermes Relay — Kết nối các Phiên bản | Easy Understand Hermes Agent

Hãy nghĩ về Hermes Relay như một bốt điện thoại gọi lại cho bạn — bạn không cần phải tiết lộ địa chỉ nhà của mình, bạn chỉ cần gọi ra một lần, và phía bên kia có thể liên lạc với bạn bất cứ lúc nào qua chính đường dây đó.

Hermes Relay là gì?

Hermes Relay là một hệ thống kết nối cho cổng kết nối Hermes Agent. Nó cho phép cổng kết nối của bạn trò chuyện với các nền tảng nhắn tin như Discord, Telegram hoặc Slack mà không cần giữ bất kỳ mã thông báo bot hoặc mật khẩu nào của họ.

Thay vào đó, một dịch vụ riêng biệt (bộ “kết nối”) sở hữu những thông tin xác thực đó. Cổng kết nối của bạn chỉ cần gọi ra bộ kết nối qua một kết nối WebSocket an toàn duy nhất — và sau đó tất cả tin nhắn sẽ luân chuyển qua lại qua một đường dây mở duy nhất đó.

Tại sao điều đó hữu ích?

Dưới đây là những lợi ích lớn, nói một cách dễ hiểu:

Không cần mở cổng mạng. Cổng kết nối của bạn hoạt động tốt ngay cả khi đứng sau bộ định tuyến gia đình hoặc tường lửa đám mây. Nó chỉ tạo các kết nối đi ra, vì vậy bạn không phải phơi bày bất cứ thứ gì ra internet.
Không có bí mật bot trên máy của bạn. Bộ kết nối giữ tất cả các mã thông báo nền tảng. Nếu cổng kết nối của bạn bị đánh cắp, kẻ tấn công sẽ không nhận được gì hữu ích.
Một cổng kết nối, nhiều nền tảng. Bộ kết nối cho cổng kết nối của bạn biết nó có thể làm gì (độ dài tin nhắn, markdown, chỉnh sửa, chuỗi hội thoại, v.v.) tại thời điểm chúng kết nối. Không có quy tắc cứng nhắc nào — nó chỉ thích nghi.

Khi nào nên sử dụng: Nếu bạn đang tự chạy bot của mình trực tiếp, hãy bỏ qua Relay và sử dụng các bộ điều hợp gốc (Telegram, Discord). Relay dành cho các thiết lập nơi một bộ kết nối dùng chung hoặc được lưu trữ quản lý phía nền tảng — như lưu trữ đa người thuê hoặc khi bạn chỉ đơn giản là không muốn có mã thông báo trên máy của mình.

Cách Đăng Ký Cổng Kết Nối Của Bạn

Việc đăng ký là một thiết lập một lần. Bạn chạy một lệnh duy nhất và Hermes sẽ lo phần còn lại.

Đầu tiên, hãy đảm bảo bạn có mã thông báo đăng ký (được tạo ra bởi nhà cung cấp bộ kết nối của bạn). Sau đó chạy:

hermes gateway enroll \
  --token <enrollment-token> \
  --connector-url wss://connector.example.com/relay

Đây là những gì xảy ra từng bước:

Hermes kiểm tra thông tin đăng nhập hiện tại của bạn (~/.hermes/auth.json) để xác minh bạn thuộc tổ chức nào.
Nếu bạn đã thiết lập nhà cung cấp danh tính của riêng mình (cho các thiết lập cách ly mạng hoặc tự lưu trữ), nó sẽ sử dụng thông tin đó thay thế.
Nó gửi mã thông báo đăng ký đến điểm cuối /relay/enroll của bộ kết nối qua TLS.
Bộ kết nối xác minh mã thông báo hợp lệ, chỉ sử dụng một lần và khớp với đối tượng thuê của bạn.
Sau đó, nó tạo ra một bí mật riêng cho cổng kết nối và một khóa giao hàng — và trả về chúng một lần duy nhất.
Hermes lưu những thứ này vào ~/.hermes/.env:

GATEWAY_RELAY_ID
GATEWAY_RELAY_SECRET
GATEWAY_RELAY_DELIVERY_KEY

Vậy là xong. Cổng kết nối của bạn giờ đã được “đăng ký” và có thể gọi ra bộ kết nối bất cứ khi nào cần.

Điều Gì Xảy Ra Tiếp Theo?

Sau khi được đăng ký, cổng kết nối của bạn sẽ:

Gọi ra URL bộ kết nối bạn đã cung cấp
Nhận một mô tả khả năng (những gì nền tảng phía trước có thể làm)
Bắt đầu trao đổi các tin nhắn và hành động được chuẩn hóa qua cùng một socket đó

Không có cổng vào, không có thông tin xác thực bổ sung, không có mã dành riêng cho nền tảng.

Tóm Tắt & Mẹo Thực Tế

Tóm tắt: Hermes Relay là một cách sạch sẽ để kết nối cổng kết nối của bạn với các nền tảng nhắn tin mà không cần sở hữu thông tin xác thực của họ hoặc mở bất kỳ cổng mạng nào. Nó hoàn hảo cho lưu trữ dùng chung, môi trường NAT hoặc bất kỳ thiết lập nào bạn muốn giữ bí mật không nằm trên máy chính của mình.

Mẹo thực tế: Luôn giữ mã thông báo đăng ký của bạn chỉ sử dụng một lần và có thời hạn ngắn. Nếu bạn cần xoay vòng thông tin xác thực, chỉ cần chạy lại lệnh đăng ký với một mã thông báo mới — và nhớ xóa GATEWAY_RELAY_SECRET cũ khỏi tệp .env của bạn trước khi cập nhật nó. Một chút vệ sinh kỹ thuật sẽ giúp ích rất nhiều.