Cách giữ Hermes Agent chạy trên máy chủ suốt ngày đêm

Sau khi cài Hermes Agent trên máy tính xách tay, một câu hỏi xuất hiện: ai sẽ trả lời trên Telegram và tổng hợp bản tin buổi sáng khi máy tính xách tay đóng? Tại bàn làm việc, agent chỉ hoạt động khi máy tính đang bật. Để bot luôn trực tuyến và các tác vụ theo lịch tự chạy, bạn cần chuyển agent lên máy chủ.

Dưới đây là cách cài Hermes trên một máy chủ Linux thông thường, biến gateway thành một dịch vụ chạy liên tục và tự khởi động sau khi máy chủ khởi động lại, đồng thời hạn chế quyền truy cập để người lạ không thể vào terminal. Hướng dẫn này dựa trên tài liệu chính thức.

Nếu bạn chưa cài Hermes, hãy bắt đầu với bài tổng quan riêng về agent này là gì và cách cài đặt. Hướng dẫn này giả định rằng bạn đã chạy Hermes trên máy của mình và chỉ đề cập đến việc chuyển nó lên máy chủ.

Thông tin về cách làm việc với Ailoot có trong tài liệu.

Vì sao nên chuyển Hermes Agent từ máy tính xách tay lên máy chủ?#

Trên máy tính xách tay, Hermes chỉ hoạt động khi nắp máy mở và bạn ở gần. Đóng máy lại, bot sẽ im lặng; bản tin buổi sáng sẽ không đến. Điều đó không phù hợp với một nhiệm vụ như “trả lời mọi người trên ứng dụng nhắn tin và xử lý công việc theo lịch”.

Điều làm máy chủ khác biệt là nó không bao giờ ngủ và không phụ thuộc vào thứ gì khác. Bạn cài chính Hermes đó lên máy chủ, rồi nó hoạt động mà không cần bạn: trả lời trên Telegram lúc ba giờ sáng, thu thập tin tức theo chủ đề của bạn mỗi sáng và giữ các phiên làm việc giữa những lần chạy.

Chuyển lên máy chủ là hợp lý khi agent có một nhiệm vụ liên tục: bot cho bạn hoặc nhóm của bạn, bản tin buổi sáng, trả lời tự động hoặc công việc định kỳ với tài liệu. Nếu bạn chỉ đang thử Hermes cho một dự án cụ thể và ngồi gần máy, bạn chưa cần máy chủ; đó là một bước bổ sung.

Cần chuẩn bị gì trước khi cài Hermes trên VPS?#

Hãy chuẩn bị ba thứ trước khi cài đặt.

Máy chủ. Một VPS Linux thông thường là đủ. Tài liệu xếp Linux và WSL2 vào mức hỗ trợ cơ bản, và việc kiểm thử được thực hiện trên Ubuntu mới nhất. Nếu hệ thống có glibc, systemd và cấu trúc thư mục quen thuộc, Hermes sẽ cài đặt đúng cách. Điều này quan trọng trên máy chủ vì tất cả các bước tự khởi động bên dưới đều dựa vào systemd, vốn có sẵn trên Ubuntu và Debian.

Quyền truy cập SSH. Bạn kết nối với máy chủ qua terminal bằng SSH; ở đó bạn sẽ không dùng chuột. Tất cả lệnh bên dưới được chạy trong phiên SSH này. Nếu bạn viết code theo kiểu vibe coding và chưa quen với terminal, đừng lo: chỉ có vài lệnh và bạn có thể sao chép nguyên từng lệnh.

Mô hình đã chọn. Agent không tự suy nghĩ; nó gọi một mô hình. Với máy chủ chạy khi bạn vắng mặt, điều quan trọng là quyền truy cập mô hình không hết hạn. Lựa chọn đơn giản nhất là đăng ký Nous Portal qua hermes setup --portal: đăng nhập sử dụng OAuth và token tự làm mới. API keys riêng của bạn cũng dùng được, nhưng hãy đảm bảo tài khoản còn tiền — agent headless với số dư bằng không sẽ đơn giản là im lặng. Mô hình phải có context window ít nhất 64,000 tokens, nếu không Hermes sẽ từ chối khởi chạy với mô hình đó. Tất cả mô hình đám mây trong danh sách đều đáp ứng yêu cầu này.

Cài Hermes Agent trên máy chủ bằng một lệnh như thế nào?#

Cài đặt trên máy chủ gần giống với trên máy tính xách tay, chỉ khác một điểm: agent thường không cần trình duyệt ở đó. Tự động hóa trình duyệt cũng kéo theo Chromium khá nặng. Vì vậy, bạn dùng cờ --skip-browser.

1. Kết nối với máy chủ qua SSH

   ssh root@your-server-address
   

   Chạy tất cả các lệnh tiếp theo trong phiên này, trực tiếp trên máy chủ.

2. Chạy trình cài đặt mà không cài trình duyệt

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   Script tải môi trường cần thiết và cài lệnh hermes. Cờ --skip-browser bỏ qua cài đặt tự động hóa trình duyệt; trên máy chủ không có giao diện đồ họa, phần đó chỉ chiếm dung lượng. Nếu sau này cần trình duyệt, bạn có thể cài riêng.

3. Khởi động lại shell và chọn mô hình

   source ~/.bashrc
   hermes setup --portal
   

   Dòng đầu tiên nạp PATH mới để có thể tìm thấy lệnh hermes. Dòng thứ hai mở trang đăng nhập Nous Portal: xác nhận đăng nhập, rồi agent sẽ có mô hình và dịch vụ mà không cần key riêng cho từng dịch vụ.

4. Kiểm tra cài đặt

   hermes doctor
   

   Lệnh này hiển thị những gì đã cài, những gì còn thiếu và cách khắc phục. Dấu màu xanh lá nghĩa là mọi thứ đã sẵn sàng.

Trước khi thêm bot và lịch chạy, hãy đảm bảo một cuộc trò chuyện bình thường hoạt động trực tiếp trên máy chủ: chạy hermes và giao cho nó một tác vụ đơn giản có câu trả lời kiểm chứng được. Tài liệu khuyến cáo rõ ràng không nên thêm hàng loạt tính năng trước khi cuộc trò chuyện thông thường hoạt động — đó là lời khuyên hợp lý.

Làm thế nào để giữ Hermes chạy suốt ngày đêm?#

Gateway là một tiến trình Hermes chạy nền duy nhất, duy trì kết nối với tất cả ứng dụng nhắn tin, quản lý phiên và chạy các tác vụ theo lịch. Toàn bộ hoạt động suốt ngày đêm xoay quanh nó. Mục tiêu là để tiến trình này tự khởi động và tiếp tục chạy.

Trước tiên cấu hình gateway và kết nối ứng dụng nhắn tin:

hermes gateway setup

Trình hướng dẫn thiết lập sẽ đưa bạn qua các nền tảng và giúp nhập bot token cùng danh sách truy cập. Các bước kết nối Telegram (tạo bot bằng BotFather, tìm ID của bạn và nhập token) được hướng dẫn trong hướng dẫn cài đặt chính; tôi sẽ không lặp lại ở đây.

Tiếp theo là cái bẫy mà mọi người thường quên nhất. Nếu chỉ chạy hermes gateway, tiến trình chỉ tồn tại khi phiên SSH còn mở. Đóng terminal, gateway sẽ dừng. Để giữ nó chạy liên tục, bạn cần giao tiến trình cho hệ thống quản lý. Có một lệnh cho việc đó:

hermes gateway install

Lệnh này cài gateway thành dịch vụ: trên Linux là dịch vụ systemd của người dùng; trên macOS là thông qua launchd. Hệ thống giám sát tiến trình và khởi động lại nếu nó gặp sự cố.

Trên máy chủ, thường bạn sẽ cần lựa chọn thứ hai: dịch vụ hệ thống bắt đầu chạy khi máy khởi động, trước khi bất kỳ người dùng nào đăng nhập:

sudo hermes gateway install --system

Đó chính xác là điều bạn cần cho VPS: máy chủ khởi động lại, dịch vụ tự chạy và bot trực tuyến trở lại. Quản lý bằng các lệnh đơn giản sau:

hermes gateway start     # start
hermes gateway stop      # stop
hermes gateway status    # check status

Với dịch vụ hệ thống, hãy thêm sudo và cờ --system vào các lệnh này. Nếu không, các lệnh sẽ nhắm đến dịch vụ người dùng thay vì dịch vụ khởi động cùng máy:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

Vì sao cần linger và điều gì xảy ra nếu thiếu?#

Đây là trở ngại phổ biến nhất: bạn đã cài dịch vụ nhưng bot vẫn im lặng vào ban đêm. Nguyên nhân là cách các dịch vụ người dùng Linux hoạt động.

Dịch vụ systemd của người dùng mặc định gắn với phiên của bạn. Bạn kết nối qua SSH và user manager khởi động; dịch vụ chạy. Bạn đăng xuất, hệ thống xem người dùng là không hoạt động nên tắt các dịch vụ của người dùng đó cùng với gateway. Với máy chủ mà bạn đăng nhập rồi đăng xuất, đây là một lỗi: bot chỉ trực tuyến khi bạn đang ở trong SSH.

Bạn có thể khắc phục bằng chế độ linger, cho phép hệ thống giữ user manager chạy ngay cả khi người dùng đó chưa đăng nhập:

sudo loginctl enable-linger username

Sau lệnh này, dịch vụ người dùng tự chạy và khởi động khi máy chủ boot mà không cần chờ bạn đăng nhập. Nếu không có linger, hệ thống quay lại hành vi ban đầu: gateway tắt khi bạn thoát SSH và không khởi động lúc boot. Tài liệu nêu rõ điều này.

Chạy Hermes trên máy chủ bằng Docker với khả năng tự khởi động lại như thế nào?#

Docker là một cách khác để giữ agent hoạt động trên máy chủ, đặc biệt nếu bạn đã quen với container hoặc muốn cô lập agent khỏi hệ thống chính. Cấu hình một lần bằng docker run ... setup, rồi khởi động container ở chế độ nền:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Các dòng đảm bảo hoạt động suốt ngày đêm có chức năng như sau:

• -d — container chạy ở chế độ nền và không giữ terminal mở.
• --restart unless-stopped — Docker khởi động lại container sau khi máy chủ reboot hoặc gặp sự cố. Nó chỉ không khởi động lại nếu bạn đã dừng thủ công.
• -v ~/.hermes:/opt/data — cài đặt, key, phiên và bộ nhớ nằm trên máy chủ, bên ngoài container, và vẫn tồn tại khi tạo lại container.

Image bổ sung một lớp bảo vệ khác: tiến trình gateway chạy dưới bộ giám sát s6. Nếu gateway gặp sự cố, nó được khởi động lại trong vài giây mà không làm mất chính container. Đây là bảo vệ kép: Docker giữ container chạy từ bên ngoài, còn s6 giám sát tiến trình bên trong.

Hãy nhớ một điểm khác biệt của cách dùng Docker: các bản cài đặt này không được cập nhật bằng lệnh hermes update. Để cập nhật trong Docker, hãy thay image bằng image mới—tải bản mới nhất và tạo lại container.

Làm sao kiểm tra mọi thứ hoạt động và vẫn chạy sau khi reboot?#

Với dịch vụ người dùng, kiểm tra trạng thái và nhật ký như sau:

hermes gateway status
journalctl --user -u hermes-gateway -f

Với dịch vụ hệ thống được khuyên cho VPS, dùng scope hệ thống:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

Lệnh đầu kiểm đúng dịch vụ được chọn, lệnh sau theo dõi log cùng scope. Tên unit này áp dụng bản cài ~/.hermes mặc định. Hermes home khác có thể thêm hậu tố; xem đầu ra status và dùng đúng unit đó. Không theo dõi unit người dùng khi thử bản hệ thống. Nhật ký Hermes nằm trong ~/.hermes/logs/, và các bí mật tự động được ẩn khỏi nhật ký nên bạn có thể gửi chúng cho bộ phận hỗ trợ một cách an toàn.

Bây giờ hãy khởi động lại máy chủ và đảm bảo agent tự hoạt động trở lại. Đây là bài kiểm tra máy chủ chính, và thường là điều mọi người quên:

sudo reboot

Khi máy chủ truy cập được lại, nối SSH. Bản hệ thống kiểm sudo hermes gateway status --system và journal hệ thống; bản người dùng với linger kiểm hermes gateway status và journal người dùng. Sau đó nhắn bot Telegram. Nếu bot trả lời mà bạn không cần can thiệp, cấu hình tự khởi động đã chính xác. Đó là mục đích của toàn bộ việc này.

Không cần lo mất cuộc trò chuyện. Hermes ghi các phiên xuống đĩa và chúng vẫn tồn tại sau khi gateway khởi động lại. Hơn nữa, nếu gateway gặp sự cố đúng lúc đang gửi câu trả lời, nó sẽ gửi câu trả lời đó sau khi khôi phục thay vì chạy lại tác vụ. Điều này quan trọng với bot hoạt động suốt ngày đêm: một lần khởi động lại bất ngờ sẽ không làm gián đoạn cuộc trò chuyện.

Bảo vệ agent có quyền truy cập terminal trên máy chủ như thế nào?#

Agent trên máy chủ là một chương trình có quyền truy cập terminal và chạy mà không có bạn giám sát. Trước tiên hãy kiểm tra ba cài đặt này.

Đóng quyền truy cập bot. Mặc định, gateway chỉ trả lời những người trong danh sách truy cập hoặc những người đã hoàn tất liên kết bằng mã trong tin nhắn trực tiếp. Đây là hành vi phù hợp với bot có quyền truy cập terminal: người ngẫu nhiên nhắn cho bot không thể làm gì. Danh sách được thiết lập bằng ID dạng số, ví dụ với Telegram:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Xác nhận lệnh nguy hiểm. Trước khi làm điều gì có tính phá hủy, agent sẽ hỏi bạn xin phép. Có chế độ YOLO để tắt xác nhận; tốt nhất đừng bật nó trên máy chủ chạy khi bạn vắng mặt. Xác nhận được thiết kế chính xác để ngăn điều gì đó không thể đảo ngược xảy ra mà bạn không hay biết.

Sandbox để cách ly hoàn toàn. Nếu muốn agent hoàn toàn không thể nhìn thấy hệ thống chính của máy chủ, hãy chạy lệnh của nó trong container Docker:

hermes config set terminal.backend docker

Sau đó, mọi việc agent làm trong terminal đều diễn ra bên trong sandbox cách ly và không thể chạm đến máy chủ đang hoạt động. Đây là biện pháp bảo vệ hợp lý khi bạn cho phép agent tự hành động.

Nên làm gì nếu bot im lặng hoặc gateway gặp sự cố?#

Khi bot ngừng phản hồi, hãy làm theo thứ tự này. Trước hết kiểm đúng scope đã cài: sudo hermes gateway status --system cùng journal hệ thống, hoặc hermes gateway status cùng journal người dùng. Nếu gateway đang chạy nhưng tin nhắn không được chuyển đi, gần như luôn là vấn đề cấu hình nền tảng: bot token sai hoặc người đó không có trong danh sách truy cập. Chạy hermes gateway setup lại trong cùng Hermes home, rồi xem dịch vụ được chọn bằng hermes gateway status --system cho hệ thống hoặc hermes gateway status cho người dùng. Setup thành công chưa chứng minh đúng gateway đang chạy.

Nếu mô hình trả về câu trả lời trống hoặc kỳ lạ, hãy kiểm tra bằng hermes model và xác nhận nhà cung cấp cùng trạng thái đăng nhập. Trình tự khôi phục chung đưa bạn từ “mọi thứ đều hỏng” trở lại trạng thái hoạt động là: hermes doctor, hermes model, hermes setup, rồi hermes gateway status --system cho bản hệ thống hoặc hermes gateway status cho bản người dùng.

Thêm một điều cho trường hợp hiếm gặp nhưng khó chịu khi toàn bộ tiến trình bị treo mà không thực sự gặp sự cố. Dịch vụ systemd có bộ hẹn giờ watchdog: thêm dòng này vào ~/.hermes/config.yaml rồi cài lại dịch vụ.

gateway:
  systemd_watchdog_seconds: 120

# Dịch vụ hệ thống VPS, cùng Hermes home của bản cài gốc:
sudo hermes gateway install --system --force
sudo hermes gateway status --system

Với dịch vụ người dùng, chỉ tạo lại scope đó bằng hermes gateway install --force và kiểm hermes gateway status. Chọn một scope; không cài cả hai để sửa một gateway.

Sau đó gateway thường xuyên báo với hệ thống rằng “Tôi vẫn hoạt động”, và nếu tín hiệu ngừng, systemd sẽ tự động khởi động lại tiến trình. Cách này chỉ hoạt động trên Linux có systemd và chỉ dành cho trường hợp tiến trình bị treo. Bộ hẹn giờ watchdog không ảnh hưởng đến sự cố mạng thông thường giữa máy chủ và ứng dụng nhắn tin.

Mọi người còn hỏi gì về Hermes Agent trên máy chủ?#

Tìm hiểu Ailoot.