Hermes Agent là gì? Hướng dẫn cài đặt và sử dụng

Hermes Agent là gì?

Hermes Agent là một AI agent mã nguồn mở, được phát triển bởi Nous Research. Khác với một chatbot thông thường chỉ trả lời trong khung chat, Hermes có thể trực tiếp thao tác với hệ thống: đọc/sửa file, chạy lệnh terminal, tìm kiếm thông tin trên web, gọi API, thiết lập tác vụ chạy theo lịch, và gửi kết quả về Telegram hay Discord.

Có thể hiểu đơn giản: model AI là “bộ não” xử lý suy luận, còn Hermes là lớp điều phối bao quanh model đó — quyết định agent được dùng công cụ (tool) nào, được truy cập thư mục nào, lưu trữ phiên làm việc ra sao, khi nào cần con người xác nhận trước khi thực thi, và gửi kết quả về đâu.

Hai tính năng nổi bật nhất của Hermes là:

• Skills: cho phép agent lưu lại một quy trình đã thực hiện tốt để tái sử dụng về sau.
• Memory: giúp agent ghi nhớ những thông tin ổn định về người dùng xuyên suốt nhiều phiên làm việc khác nhau.

So với Hermes, một agent tự host khác cùng dòng là OpenClaw có cách tổ chức hơi khác, có thể tham khảo thêm để so sánh phương pháp cài đặt và vận hành.

So sánh nhanh Hermes Agent với chatbot thông thường

Các thành phần chính của Hermes Agent

Model & provider: Hermes không ràng buộc người dùng vào một nhà cung cấp model duy nhất. Có thể đăng nhập qua Nous Portal, OpenAI Codex, hoặc tự cấu hình API key của OpenRouter, Anthropic, Google, DeepSeek và các endpoint tương thích chuẩn OpenAI.

Tools & Toolsets: Tool là một hành động cụ thể (đọc file, chạy lệnh, tìm web, tạo ảnh…). Toolset là một nhóm các tool có cùng mục đích. Việc tắt bớt các toolset không cần dùng sẽ giúp giảm dung lượng schema đưa vào prompt, đồng thời thu hẹp phạm vi quyền hạn của agent.

Skills: là các tài liệu Markdown mô tả cách thực hiện một loại công việc nhất định — gồm các bước, câu lệnh, lỗi hay gặp và cách kiểm tra kết quả. Đây thực chất là “bộ nhớ về quy trình” chứ không phải plugin thực thi tùy ý, nên rất dễ đọc, dễ kiểm tra và có thể tương thích với các agent khác theo chuẩn agentskills.io.

Memory & session: Hermes lưu các phiên làm việc bằng SQLite kèm công cụ tìm kiếm toàn văn FTS5. Memory dùng để lưu các thông tin bền vững (cách xưng hô, quy ước dự án, đặc điểm môi trường…), còn các chi tiết chỉ liên quan tới một tác vụ tạm thời nên để trong session, tránh nhồi nhét hết vào bộ nhớ dài hạn.

Phân biệt các lớp lưu trữ thông tin:

Gateway, cron, MCP: Gateway kết nối Hermes với các nền tảng nhắn tin như Telegram, Discord, Slack, WhatsApp. Cron cho phép chạy tác vụ theo lịch trong một phiên mới. MCP giúp mở rộng khả năng của Hermes thông qua các server công cụ bên ngoài.

Nên chạy Hermes Agent ở môi trường nào?

Nếu cần một máy chủ chạy liên tục để nhận tin nhắn và xử lý cron, một VPS Linux là lựa chọn hợp lý, miễn là được cấu hình user riêng, tường lửa và backup đầy đủ.

Cài đặt Hermes Agent

Cấu hình khuyến nghị

Trên Linux, macOS, WSL2

Installer chính thức sẽ tự động chuẩn bị uv, Python, môi trường ảo và các phụ thuộc cần thiết:

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

Muốn thử nghiệm nhanh mà chưa chạy wizard cấu hình:

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

Sau khi cài xong, dữ liệu chính nằm trong thư mục Hermes Home, mặc định là ~/.hermes/: file config.yaml chứa cấu hình, .env chứa biến môi trường/API key, còn sessions, skills, logs, cron có thư mục riêng.

Trên Windows native

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Nếu quy trình làm việc cần công cụ Linux hoặc Docker, WSL2 vẫn là lựa chọn dễ đồng bộ hơn với VPS; nếu chủ yếu dùng giao diện Desktop và PowerShell thì cài native sẽ gọn hơn.

Thiết lập model và chạy phiên đầu tiên

Chạy wizard cấu hình đầy đủ:

hermes setup

Chạy wizard cấu hình đầy đủ:

hermes setup

Dùng Nous Portal (một tài khoản có thể cung cấp cả model lẫn nhóm Tool Gateway):

hermes setup --portal

Đổi provider/model sau này, hoặc kiểm tra credential:

hermes model
hermes auth
hermes doctor

hermes doctor sẽ kiểm tra phiên bản Python, các package, cấu hình, symlink lệnh, cũng như các tool/credential còn thiếu. Nên xử lý từng cảnh báo rồi chạy lại lệnh này để xác nhận.

Mở giao diện chat:

hermes

Hoặc gửi một câu lệnh không cần tương tác:

hermes chat -q "Kiểm tra thư mục hiện tại và cho biết dự án dùng ngôn ngữ gì"

Các lệnh nên biết khi dùng hàng ngày

Sau khi bật/tắt một toolset, nên dùng lệnh /reset trong chat hoặc mở lại Hermes để thay đổi có hiệu lực — điều này giữ system prompt ổn định, tránh làm hỏng prompt cache đang dùng.

Quản lý Skills

hermes skills search docker
hermes skills inspect <skill-id>
hermes skills install <skill-id>
hermes skills check
hermes skills update

Vì Skill được đưa thẳng vào ngữ cảnh của agent, chỉ nên cài từ nguồn tin cậy, xem trước nội dung bằng hermes skills inspect và kiểm tra kỹ các script/lệnh đi kèm trước khi dùng.

Dùng Profile khi cần nhiều agent riêng biệt

Profile giúp tách cấu hình, model, session, skill và memory cho từng mục đích khác nhau, ví dụ một profile cho công việc và một profile để thử nghiệm:

hermes profile create work
hermes --profile work

Web Dashboard

hermes dashboard
hermes dashboard --status
hermes dashboard --no-open

Mặc định Dashboard chỉ bind vào 127.0.0.1:9119. Không nên public cổng này ra ngoài; nếu cần truy cập từ xa hãy dùng SSH tunnel, VPN hoặc Tailscale. Khi bind ra địa chỉ không phải loopback, Hermes hiện bắt buộc phải có nhà cung cấp xác thực đi kèm.

Kết nối Telegram và Discord

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Với Telegram, cần tạo bot qua BotFather và giới hạn người dùng được phép truy cập bằng allowlist hoặc DM pairing. Với Discord, cần tạo application, lấy bot token và bật Message Content Intent trong Developer Portal — đây thường là nguyên nhân khiến bot có mặt trong server nhưng không phản hồi.

Vì bot gateway có thể gọi tool và truy cập hệ thống trong phạm vi được cấp quyền, tuyệt đối không nên để bot mở công khai; nên dùng allowlist/pairing, giới hạn toolset, và tách riêng user Linux cho dịch vụ này.

Sau khi sửa cấu hình gateway, dùng hermes gateway restart; log lưu tại ~/.hermes/logs/.

Tự động hóa bằng cron

hermes cron create "0 7 * * *" "Đọc log lỗi 24 giờ qua, chỉ gửi cảnh báo mới và kèm nguồn" --name bao-cao-loi --deliver telegram
hermes cron list
hermes cron status

Mỗi lần chạy, cron sẽ tạo một session mới nên không có ký ức về cuộc trò chuyện hiện tại. Vì vậy, prompt cần ghi rõ nguồn dữ liệu, định dạng đầu ra, múi giờ, nơi gửi kết quả, điều kiện im lặng và tiêu chí dừng. Nếu tác vụ liên quan đến một repository, thêm --workdir /duong-dan-tuyet-doi để Hermes nạp đúng context và chạy tool trong đúng thư mục.

Trước khi để lịch chạy thật, nên kích hoạt thử một lần:

hermes cron run <job-id>

Nên bắt đầu với các tác vụ chỉ đọc (tổng hợp tin, kiểm tra dung lượng, báo cáo log…), theo dõi vài lần chạy ổn định rồi mới cân nhắc cấp quyền ghi.

Cấu hình bảo mật trước khi chạy 24/7

1. Chạy Hermes bằng user Linux riêng, tránh dùng root nếu không thật sự cần thiết.
2. Bật tính năng ẩn thông tin nhạy cảm (secret redaction) và lưu khóa API trong ~/.hermes/.env.
3. Dùng chế độ duyệt lệnh manual hoặc smart cho các lệnh có rủi ro.
4. Chỉ bật những toolset thực sự cần dùng.
5. Dùng pairing hoặc allowlist cho Telegram/Discord và các kênh khác.
6. Không mount Docker socket vào container nếu chưa hiểu rõ rủi ro về quyền root tương đương.
7. Backup thư mục ~/.hermes/ và kiểm tra quyền file định kỳ.

hermes config set approvals.mode smart
hermes config set security.redact_secrets true
hermes doctor

Chế độ approvals.mode: off hoặc cờ --yolo sẽ bỏ qua bước duyệt lệnh — chỉ nên dùng trong môi trường sandbox dùng một lần, và không thể thay thế cho backup hay phân quyền.

Nếu muốn cô lập lệnh terminal trong Docker, có thể cấu hình qua wizard:

hermes setup terminal

Cập nhật, backup và rollback

hermes update --check
hermes backup --quick --label truoc-cap-nhat
hermes update --backup
hermes config check
hermes config migrate
hermes doctor

Lệnh backup lưu cấu hình, Skills, sessions và dữ liệu Hermes, nhưng không sao lưu codebase. Sau khi cập nhật, nên chạy lại doctor, kiểm tra trạng thái gateway và thử một tác vụ chỉ đọc để xác nhận mọi thứ vẫn hoạt động bình thường.

Với công việc liên quan đến sửa repository, nên khởi động chat kèm checkpoint để có thể rollback nếu thay đổi không đúng ý:

hermes chat --checkpoints

Lưu ý file backup có thể chứa cả .env, thông tin xác thực và dữ liệu session — cần lưu ở nơi riêng tư, giới hạn quyền đọc, tuyệt đối không đưa lên repository công khai.

Một số lỗi thường gặp

• Thiếu xz-utils trên Ubuntu minimal: installer tải Node.js dạng .tar.xz nhưng hệ thống chưa có công cụ giải nén. Cách khắc phục: apt-get install -y curl git ca-certificates xz-utils rồi chạy lại installer.
• Không tìm thấy lệnh hermes: mở terminal mới, kiểm tra biến PATH, hoặc chạy hermes doctor --fix để sửa symlink.
• Cấu hình cũ sau khi cập nhật: chạy hermes config check rồi hermes config migrate.
• Bot Discord không phản hồi: kiểm tra Message Content Intent, token, allowlist, trạng thái gateway rồi restart gateway.
• Tool không xuất hiện trong phiên hiện tại: kiểm tra bằng hermes tools list; nếu vừa bật toolset mới, cần tạo session mới bằng /reset.

Ba workflow thực tế để bắt đầu

1. Tóm tắt log hệ thống mỗi sáng: viết một script chỉ đọc log cần theo dõi, in phần thay đổi ra stdout, rồi dùng cron gửi báo cáo — cách này an toàn hơn để agent tự quét toàn bộ máy vì nguồn dữ liệu và quyền hạn đã được giới hạn sẵn.
2. Trợ lý nghiên cứu qua Telegram: bật tool web, kết nối Telegram bằng pairing, yêu cầu Hermes lưu kèm nguồn/URL; nên dùng session riêng cho từng chủ đề để dễ tìm lại về sau.
3. Trợ lý dự án với Skills riêng: tạo một profile cho từng dự án, đặt đúng working directory, và viết skill cho quy trình kiểm thử hay phát hành — kết hợp thêm Git branch/worktree/checkpoint để luôn có đường lui khi cần.

Câu hỏi thường gặp

Hermes Agent có miễn phí không? Hermes Agent là phần mềm mã nguồn mở theo giấy phép MIT, tuy vậy vẫn có thể phát sinh chi phí cho model API, VPS, lưu trữ, băng thông hoặc phần cứng nếu chạy model local.

Hermes Agent có chạy trên Windows không? Có, Hermes hỗ trợ installer Windows native và ứng dụng Desktop; WSL2 vẫn hữu ích nếu cần môi trường Linux.

Có cần Docker để dùng Hermes không? Không bắt buộc. Hermes chạy trực tiếp được trên Linux, macOS, Windows. Docker chỉ hữu ích khi cần sandbox hóa lệnh terminal.

Hermes có dùng được model chạy local không? Có, bằng cách cấu hình custom endpoint tương thích OpenAI như Ollama, LM Studio hay vLLM.

Nên bắt đầu với Telegram hay Discord? Telegram thường nhanh và đơn giản hơn cho một bot cá nhân; Discord phù hợp hơn khi cần dùng theo server/nhóm nhưng đòi hỏi cấu hình quyền bot kỹ hơn.

Tổng kết

Cách bắt đầu gọn gàng nhất là: cài Hermes bằng installer chính thức, chạy hermes setup, chọn một provider, kiểm tra bằng hermes doctor, rồi thử một tác vụ chỉ đọc trước khi bật thêm gateway, cron, browser hoặc quyền ghi file.

Khi triển khai trên VPS, nên xem Hermes như một tiến trình có quyền thực sự trên hệ thống: dùng user riêng, giới hạn tool, bật chế độ duyệt lệnh, giữ tính năng ẩn thông tin nhạy cảm, và backup thư mục ~/.hermes/ thường xuyên. Việc này mất thêm vài phút thiết lập ban đầu nhưng giảm đáng kể rủi ro khi để agent tự động xử lý công việc.

Đỗ Trung Quân

CÔNG TÁC TẠI AZDIGI

Với kinh nghiệm thực chiến từ việc tiếp xúc hàng ngày với vô vàn vấn đề về Website, Hosting, VPS, Server tại Phòng Kỹ thuật AZDIGI, mình luôn ấp ủ niềm đam mê chia sẻ kiến thức.

Mình xây dựng các blog không chỉ để tự trau dồi kỹ năng mà còn để cung cấp những tài liệu, hướng dẫn hữu ích nhất đến cộng đồng. Rất mong nhận được sự quan tâm của các bạn!

Hỗ Trợ Hosting / VPS / WordPress Hỗ Trợ Xử Lý Mã Độc

Đăng ký tư vấn miễn phí

Để lại thông tin, mình sẽ phản hồi ngay.

Họ và tên

Số điện thoại

TƯ VẤN MIỄN PHÍ Chọn dịch vụ Xử lý mã độc WordPress Thiết kế website Quản trị VPS/Server Dịch vụ WordPress (Quản trị/Fix lỗi/Nâng cấp) Tư vấn & Triển khain (Server - Hosting - Email)

GỬI YÊU CẦU TƯ VẤN