Hướng dẫn cài đặt và triển khai Hermes Agent trên VPS Ubuntu

Trong kỷ nguyên AI Agent phát triển vượt bậc, việc sở hữu một nền tảng quản lý tác vụ thông minh, tự động hóa và có giao diện Dashboard trực quan là điều cực kỳ cần thiết. Hermes Agent (phát triển bởi Nous Research) nổi lên như một AI Agent Framework cực kỳ mạnh mẽ, hỗ trợ quản lý Agent, MCP Server, Tool Calling, Session và Dashboard Web một cách mượt mà. Bài viết này sẽ hướng dẫn chi tiết từ A-Z cách triển khai Hermes Agent trên VPS Ubuntu.

1. Tổng quan về các tính năng của Hermes Agent

Hermes Agent mang đến một hệ sinh thái toàn diện hỗ trợ đắc lực cho cả nhà phát triển lẫn người dùng cuối:

• Dashboard Web: Giao diện quản trị đồ họa cực kỳ trực quan và thân thiện.
• Tích hợp MCP: Dễ dàng kết nối Model Context Protocol (MCP) với các dịch vụ bên ngoài.
• Thực thi công cụ (Tool Execution): AI Agent tự động gọi và chạy các tool hiệu quả.
• Quản lý phiên (Session Management): Lưu trữ và tiếp tục các cuộc hội thoại dễ dàng.
• Hỗ trợ LLM linh hoạt: Tương thích tốt với cả Cloud LLM (OpenAI, Anthropic) lẫn Local LLM.

2. So sánh Hermes Agent và OpenClaw

Để giúp bạn có cái nhìn tổng quan, hãy cùng so sánh Hermes Agent với một Framework phổ biến khác là OpenClaw:

3. Kiến trúc thư mục của Hermes Agent

Mã nguồn và thư mục làm việc của Hermes Agent được cấu trúc rất khoa học:

Hermes Agent
├── Dashboard (Giao diện điều khiển Web)
├── Profiles (Cấu hình người dùng)
├── Sessions (Lịch sử phiên làm việc)
├── Models (Quản lý các mô hình LLM)
├── MCP Servers (Các cổng kết nối công cụ ngoại vi)
├── Tools (Các công cụ thực thi mã lệnh)
└── Workspace (Không gian làm việc lưu trữ file)

4. Các bước cài đặt Hermes Agent vào VPS Ubuntu

Bước 1: Tạo User mới và cấp quyền truy cập

Để đảm bảo tính bảo mật cho hệ thống, khuyến nghị tạo một user riêng (ví dụ đặt tên là luna) thay vì chạy trực tiếp bằng quyền root:

# Tạo user mới
sudo adduser luna

# Thêm user vào nhóm sudo
sudo usermod -aG sudo luna

# Chuyển sang user vừa tạo
su - luna

Bước 2: Tiến hành cài đặt Hermes Agent

Tải và thực thi script cài đặt tự động bằng câu lệnh sau:

# Chạy script cài đặt từ Nous Research
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Cài đặt công cụ CLI thông qua uv
uv tool install hermes-agent

# Kiểm tra cài đặt thành công
hermes --help

Bước 3: Khởi động Web Dashboard

Để bắt đầu sử dụng giao diện web điều khiển, hãy chạy lệnh sau trên VPS:

hermes dashboard

5. Truy cập Dashboard từ máy tính cá nhân qua SSH Tunnel

Sau khi Dashboard khởi động trên VPS, mặc định nó sẽ lắng nghe tại cổng cục bộ. Để bảo mật tối đa, bạn không nên mở port này trực tiếp ra Internet mà nên sử dụng SSH Tunnel để ánh xạ cổng về máy cá nhân:

# Chạy lệnh này trên terminal của Máy tính cá nhân (PC) của bạn:
ssh -L 9119:127.0.0.1:9119 luna@IP_CUA_VPS

(Thay thế IP_CUA_VPS bằng địa chỉ IP thật của VPS của bạn, ví dụ: 165.99.16.113)

Sau khi thiết lập kết nối SSH thành công, hãy mở trình duyệt web trên máy tính của bạn và truy cập địa chỉ:

http://localhost:9119

6. Cách mở Port 9119 trên VPS (Nếu không dùng SSH Tunnel)

Nếu bạn muốn expose cổng 9119 để truy cập trực tiếp bằng IP của VPS, hãy cấu hình tường lửa UFW:

# Cho phép kết nối TCP qua cổng 9119
sudo ufw allow 9119/tcp

# Nạp lại cấu hình tường lửa
sudo ufw reload

Để kiểm tra xem cổng 9119 đã được mở và lắng nghe chính xác chưa, sử dụng lệnh:

ss -tulpn | grep 9119

7. Một số lưu ý về Troubleshooting & Bảo mật

Kiểm tra trạng thái Dashboard

hermes dashboard --status

Kiểm tra port đang chạy trên VPS

sudo lsof -i :9119

Kiểm tra kết nối nội bộ từ VPS

curl http://127.0.0.1:9119