Cách Cài đặt và Sử dụng Hermes Agent Miễn phí: Hướng dẫn Thực hành

Hermes Agent lọt vào tầm ngắm của tôi vài tuần trước, và sau khi đào sâu vào GitHub repo (37.5k sao, giấy phép MIT, phát triển bởi Nous Research), tôi nhận ra nó làm được điều mà hầu hết AI agent khác không làm được: nó giỏi hơn khi bạn dùng nhiều hơn. Không phải theo kiểu mơ hồ "mô hình được cải thiện" — nó thực sự xây dựng kỹ năng từ các tương tác của bạn, ghi nhớ những gì hiệu quả, và tinh chỉnh những kỹ năng đó theo thời gian. Chỉ riêng điều đó đã đáng để thử.

Phần thuyết phục tôi nhất: nó chạy trên VPS giá $5. Không cần GPU trừ khi bạn muốn. Và bạn có thể kết nối nó với Telegram, Discord, Slack, WhatsApp và khoảng một chục nền tảng khác. Chúng tôi khuyên dùng LightNode làm nhà cung cấp VPS — thanh toán theo giờ bắt đầu từ $0.013/giờ, rất khó tìm được mức giá tốt hơn khi thử nghiệm AI tự host.

Mục lục

1. Hermes Agent Thực sự Làm được gì
2. Yêu cầu Hệ thống
3. Cài đặt
4. Thiết lập Nhà cung cấp Mô hình Miễn phí
5. Cấu hình
6. Chạy Phiên đầu tiên
7. Kết nối với Các Nền tảng Nhắn tin
8. Các Tính năng Đáng chú ý
9. Khắc phục Sự cố
10. Tổng kết

Hermes Agent Thực sự Làm được gì

Hầu hết AI agent đều theo một khuôn mẫu giống nhau: bạn gửi prompt, chúng chạy vài công cụ, trả về kết quả, và quên hết mọi thứ. Hermes Agent tiếp cận theo hướng khác. Nó có một vòng lặp học tập tích hợp:

1. Bạn giao cho nó một tác vụ
2. Nó xác định cần những kỹ năng gì
3. Nếu kỹ năng chưa có, nó tạo ra một kỹ năng mới
4. Nó sử dụng kỹ năng đó, đánh giá kết quả, và lưu lại những gì hiệu quả
5. Lần sau khi bạn yêu cầu something tương tự, nó gọi lại kỹ năng đã được tinh chỉnh

Điều này có nghĩa là agent thực sự cải thiện khi sử dụng, không chỉ vì mô hình nền tảng được cập nhật. Quy trình làm việc cụ thể của bạn, codebase cụ thể của bạn, thói quen cụ thể của bạn — nó học những pattern đó.

Ngoài vòng lặp học tập, Hermes Agent còn đi kèm 47 công cụ tích hợp sẵn, hỗ trợ tích hợp MCP (Model Context Protocol) để mở rộng khả năng, và có thể ủy quyền tác vụ cho các subagent. Nó cũng có bộ lập lịch cron cho các tác vụ định kỳ và chế độ giọng nói nếu bạn muốn sử dụng mà không cần tay.

Yêu cầu Hệ thống

Trước khi cài đặt, hãy đảm bảo hệ thống của bạn đáp ứng các yêu cầu cơ bản:

• Hệ điều hành: Linux (khuyên dùng Ubuntu 20.04+), macOS (12+), hoặc Windows qua WSL2
• Python: 3.10 trở lên
• RAM: tối thiểu 2GB, khuyên dùng 4GB
• Ổ đĩa: ~500MB cho bản thân agent
• Mạng: Có kết nối internet để gọi model API

Đối với người dùng Android, Termux cũng hoạt động được. Windows nguyên bản không được hỗ trợ — bạn cần WSL2.

Nếu bạn triển khai trên VPS, một máy $5/tháng với 1 vCPU và 1GB RAM xử lý tốt cho sử dụng nhẹ. Khối lượng công việc nặng hơn (nhiều nền tảng nhắn tin, cron job thường xuyên) sẽ hưởng lợi từ 2GB+.

Cài đặt

Có hai cách để cài đặt Hermes Agent. Cách nhanh sẽ xử lý mọi thứ cho bạn. Cách thủ công cho bạn nhiều quyền kiểm soát hơn.

Cách 1: Cài đặt Một Dòng Lệnh (Khuyên dùng)

Mở terminal và chạy:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Script này làm phần việc nặng: kiểm tra dependency, thiết lập môi trường ảo, clone repo, cài đặt các gói, và chạy wizard thiết lập ban đầu. Trên một máy Ubuntu mới, toàn bộ quá trình mất khoảng 2-3 phút.

Sau khi hoàn tất, xác minh cài đặt:

hermes --version

Bạn sẽ thấy số phiên bản được hiển thị. Nếu bạn nhận được lỗi "command not found", hãy khởi động lại shell hoặc chạy source ~/.bashrc (hoặc ~/.zshrc nếu bạn dùng zsh).

Cách 2: Cài đặt Thủ công

Nếu bạn muốn biết chính xác những gì được cài trên máy của mình, hoặc nếu cài đặt một dòng lệnh bị lỗi vì lý do nào đó:

# Clone repo
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# Tạo và kích hoạt môi trường ảo
python3 -m venv venv
source venv/bin/activate

# Cài đặt dependencies
pip install -r requirements.txt

# Chạy wizard thiết lập
python setup.py

Wizard thiết lập sẽ hướng dẫn bạn qua việc chọn nhà cung cấp mô hình, nhập API key, và cấu hình cơ bản. Bạn luôn có thể chạy lại sau bằng lệnh hermes setup.

Thiết lập Nhà cung cấp Mô hình Miễn phí

Hermes Agent không đi kèm mô hình riêng. Nó kết nối với các nhà cung cấp bên ngoài. Tin tốt là: một số nhà cung cấp có gói miễn phí hoạt động với Hermes Agent.

Lựa chọn 1: OpenRouter (Lựa chọn Miễn phí Dễ nhất)

OpenRouter cho phép bạn truy cập hơn 200 mô hình, và một số trong số đó hoàn toàn miễn phí. Đây là lựa chọn tôi khuyên dùng để bắt đầu.

1. Tạo tài khoản tại openrouter.ai
2. Tạo API key từ dashboard của bạn
3. Tìm mô hình miễn phí — tìm các mô hình được gắn thẻ "free" trong danh mục mô hình

Các mô hình miễn phí phổ biến trên OpenRouter bao gồm các biến thể của Llama, Mistral, và Qwen. Mô hình miễn phí có sẵn xoay vòng thường xuyên, nên hãy kiểm tra danh mục hiện tại.

Trong wizard thiết lập Hermes Agent, chọn "OpenRouter" làm nhà cung cấp và dán API key khi được yêu cầu.

Lựa chọn 2: Nous Portal

Nous Research vận hành portal inference riêng. Thỉnh thoảng họ cung cấp credit miễn phí cho người dùng mới, và các mô hình có sẵn tại đó được tinh chỉnh riêng cho khối lượng công việc agent.

1. Truy cập nousresearch.com và đăng ký
2. Kiểm tra dashboard của bạn xem có credit miễn phí không
3. Sử dụng API key được cung cấp trong thiết lập Hermes Agent

Lựa chọn 3: Các Nhà cung cấp Khác

Hermes Agent cũng hỗ trợ:

• z.ai / GLM: Nền tảng AI Trung Quốc có gói miễn phí
• Kimi / Moonshot: Một lựa chọn khác với mức sử dụng miễn phí giới hạn
• MiniMax: Gói miễn phí có sẵn cho sử dụng nhẹ
• Bất kỳ endpoint tương thích OpenAI: Nếu bạn có quyền truy cập nhà cung cấp khác, bạn có thể kết nối chúng

Để cấu hình endpoint tùy chỉnh, bạn cần base URL và API key. Wizard thiết lập xử lý việc này, hoặc bạn có thể chỉnh sửa file cấu hình trực tiếp (được đề cập trong phần tiếp theo).

Cấu hình

Hermes Agent lưu cấu hình trong ~/.hermes/config.toml. Sau khi chạy wizard thiết lập, bạn sẽ thấy nội dung tương tự như sau:

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# Cấu hình các nền tảng nhắn tin tại đây
# telegram_token = ""
# discord_token = ""

Các Tùy chọn Cấu hình Quan trọng

Cài đặt mô hình: Bạn có thể chuyển đổi mô hình hoặc nhà cung cấp bất cứ lúc nào. Nếu bạn muốn thử một mô hình miễn phí khác trên OpenRouter, chỉ cần cập nhật trường model. Bạn cũng có thể thay đổi hoàn toàn nhà cung cấp — đổi provider thành "openai" hoặc "nous" và cập nhật API key tương ứng.

Bộ nhớ: Giữ memory = true. Đây là tính năng cho phép vòng lặp học tập. Agent lưu lịch sử hội thoại và các kỹ năng đã tinh chỉnh trong ~/.hermes/memory/.

Thư mục kỹ năng: Đây là nơi các kỹ năng đã học được lưu trữ. Bạn có thể duyệt ~/.hermes/skills/ để xem agent đã học được những gì. Kỹ năng được lưu dưới dạng file JSON và có thể chỉnh sửa thủ công nếu bạn muốn tinh chỉnh.

Chuyển đổi Mô hình từ CLI

Bạn không cần phải chỉnh sửa file cấu hình mỗi lần. Hermes Agent có các lệnh tích hợp cho việc này:

# Liệt kê các mô hình có sẵn cho nhà cung cấp hiện tại
hermes model list

# Chuyển sang mô hình cụ thể
hermes model set meta-llama/llama-3.3-70b-instruct:free

# Kiểm tra mô hình bạn đang sử dụng
hermes model show

Kiểm tra Tình trạng Hệ thống

Chạy lệnh này sau khi thay đổi cấu hình để đảm bảo mọi thứ đã được kết nối đúng:

hermes doctor

Nó kiểm tra API key, tình trạng mô hình, kết nối mạng, và trạng thái hệ thống kỹ năng. Nếu có vấn đề, nó sẽ nói cho bạn biết chính xác cần sửa gì.

Chạy Phiên đầu tiên

Sau khi cấu hình xong, bắt đầu một phiên:

hermes chat

Điều này mở một REPL tương tác. Thử điều gì đó đơn giản trước:

You: Bạn có những công cụ nào?
Hermes: Tôi có quyền truy cập 47 công cụ tích hợp bao gồm:
- file_read / file_write (thao tác file)
- shell_exec (chạy lệnh shell)
- web_search / web_fetch (truy cập web)
- code_search (tìm kiếm codebase)
- calendar / reminders (lịch trình)
- ...và nhiều hơn nữa. Tôi cũng có thể sử dụng công cụ MCP nếu được cấu hình.

Sau đó giao cho nó một tác vụ thực tế:

You: Tạo một script Python theo dõi thư mục để tìm file mới và ghi tên chúng vào file có tên new_files.log

Hermes: Tôi sẽ tạo nó cho bạn.
[tạo watch_dir.py với triển khai dựa trên inotify hoặc polling]
[kiểm tra script]
Script đã sẵn sàng tại ./watch_dir.py. Chạy với python watch_dir.py /đường/dẫn/theo/dõi

Lần đầu tiên bạn yêu cầu điều gì đó, agent sẽ xây dựng kỹ năng từ đầu. Yêu cầu một tác vụ tương tự sau này, và nó sẽ sử dụng lại phiên bản đã tinh chỉnh. Bạn có thể thấy điều này bằng cách kiểm tra thư mục kỹ năng sau một vài phiên.

Kết nối với Các Nền tảng Nhắn tin

Một trong những tính năng nổi bật của Hermes Agent là hỗ trợ đa nền tảng. Bạn có thể trò chuyện với nó qua hơn 15 nền tảng nhắn tin, không chỉ qua CLI.

Thiết lập Telegram

1. Nhắn tin cho @BotFather trên Telegram để tạo bot mới
2. Sao chép bot token
3. Thêm vào cấu hình:

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

4. Khởi động gateway:

hermes gateway start telegram

Bây giờ bạn có thể chat với agent trực tiếp trên Telegram. Nó giữ nguyên bộ nhớ và kỹ năng như các phiên CLI của bạn.

Thiết lập Discord

1. Tạo bot trong Discord Developer Portal
2. Bật Message Content Intent
3. Sao chép bot token
4. Cấu hình:

hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

Các Nền tảng Khác được Hỗ trợ

Cùng một pattern áp dụng cho tất cả các nền tảng. Sử dụng hermes gateway add <platform> với thông tin xác thực cần thiết:

• Slack: Cần một Slack App với bot scopes
• WhatsApp: Sử dụng WhatsApp Business API hoặc bridge không chính thức
• Signal: Cài đặt signal-cli
• Matrix: Cần tài khoản Matrix bot
• Mattermost: Personal access token
• Email: Thông tin xác thực IMAP/SMTP
• SMS: Twilio hoặc nhà cung cấp tương tự
• DingTalk / Feishu / WeCom: Cho các nền tảng nhắn tin Trung Quốc

Chạy hermes gateway list để xem tất cả các nền tảng có sẵn và trạng thái của chúng.

Các Tính năng Đáng chú ý

Kho Kỹ năng Cộng đồng

Hermes Agent có một kho kỹ năng cộng đồng. Duyệt và cài đặt các kỹ năng mà người khác đã tạo:

# Duyệt các kỹ năng cộng đồng có sẵn
hermes skills browse

# Cài đặt một kỹ năng cụ thể
hermes skills install web-scraper

# Liệt kê các kỹ năng đã cài đặt
hermes skills list

Điều này rất hữu ích nếu bạn không muốn chờ agent học từ đầu. Có thể ai đó đã xây dựng kỹ năng cho các tác vụ phổ biến như thu thập dữ liệu web, kiểm tra API, hoặc phân tích tài liệu.

Lập lịch Cron

Thiết lập các tác vụ định kỳ mà không cần cron bên ngoài:

hermes cron add "0 9 * * *" "Tóm tắt các git commit ngày hôm qua và đăng lên #dev-channel"

Agent xử lý việc lập lịch nội bộ và sử dụng kỹ năng của mình để thực thi tác vụ.

Chế độ Giọng nói

Nếu bạn muốn sử dụng mà không cần tay:

hermes chat --voice

Tính năng này sử dụng micro và loa của hệ thống. Hoạt động tốt nhất với các mô hình xử lý âm thanh đầu vào, mặc dù nó cũng có thể sử dụng lớp speech-to-text cục bộ.

Ủy quyền cho Subagent

Đối với các tác vụ phức tạp nhiều bước, Hermes Agent có thể tạo ra các subagent:

You: Nghiên cứu top 5 nhà cung cấp VPS, so sánh giá của họ, và tạo tài liệu tóm tắt

Hermes: Tôi sẽ ủy quyền việc này cho các subagent để nghiên cứu song song.
[tạo subagent cho mỗi nhà cung cấp]
[thu thập kết quả]
[tạo tài liệu so sánh]

Các subagent chia sẻ bộ nhớ và hệ thống kỹ năng của agent cha, nên chúng được hưởng lợi từ mọi thứ mà agent chính đã học được.

Khắc phục Sự cố

"command not found: hermes"

Script cài đặt thêm Hermes vào PATH của bạn, nhưng shell hiện tại có thể chưa nhận được. Cách sửa:

source ~/.bashrc  # hoặc ~/.zshrc

Nếu vẫn không được, kiểm tra xem ~/.local/bin/hermes có tồn tại không và thêm thủ công vào PATH:

export PATH="$HOME/.local/bin:$PATH"

Lỗi API Key

Chạy hermes doctor trước. Nó sẽ cho bạn biết nếu API key không hợp lệ, hết hạn, hoặc nếu mô hình bạn chọn không có sẵn. Các cách sửa phổ biến:

• Đối với OpenRouter: Kiểm tra key của bạn tại openrouter.ai/keys
• Mô hình miễn phí đôi khi có giới hạn tốc độ — thử một mô hình miễn phí khác
• Đảm bảo không có khoảng trắng thừa ở cuối API key

Mô hình Không Phản hồi

Các mô hình gói miễn phí có giới hạn sử dụng. Nếu bạn vượt quá:

hermes model list    # xem những gì có sẵn
hermes model set <mô-hình-miễn-phí-khác>  # chuyển đổi

Sử dụng Bộ nhớ Cao

Nếu bộ nhớ của agent phát triển quá lớn (kiểm tra bằng du -sh ~/.hermes/memory/), bạn có thể xóa các mục cũ:

hermes memory prune --older-than 30d

Điều này giữ lại các tương tác và kỹ năng gần đây nhưng xóa các log hội thoại cũ hơn 30 ngày.

Vấn đề Kết nối Gateway

Đối với các nền tảng nhắn tin, đảm bảo quy trình gateway đang chạy:

hermes gateway status

Nếu gateway liên tục ngắt kết nối, kiểm tra mạng của bạn và khởi động lại:

hermes gateway restart telegram

Tổng kết

Hermes Agent làm được điều mà tôi chưa thấy AI agent mã nguồn mở nào làm tốt: nó thực sự học từ các pattern sử dụng của bạn và giỏi hơn theo thời gian, mà không yêu cầu bạn phải định nghĩa quy trình làm việc thủ công hay viết plugin tùy chỉnh. Hệ thống kỹ năng chính là điểm khác biệt — tác vụ mất 10 phút lần đầu tiên sẽ chỉ mất 30 giây ở lần thứ năm.

Việc nó chạy trên phần cứng giá rẻ và kết nối với các nhà cung cấp mô hình miễn phí có nghĩa là bạn có thể có một AI agent cá nhân chạy 24/7 với chi phí gần bằng không. Kết nối nó với Telegram hoặc Discord, và bạn đã có một trợ lý luôn sẵn sàng, ghi nhớ sở thích, codebase và quy trình làm việc của bạn.

Để bắt đầu:

1. Chọn một VPS (hoặc sử dụng máy cục bộ) — LightNode hoạt động tốt cho việc này
2. Chạy trình cài đặt một dòng lệnh
3. Đăng ký OpenRouter và lấy một mô hình miễn phí
4. Bắt đầu chat

GitHub repo có tài liệu chi tiết, và cộng đồng rất tích cực nếu bạn gặp vấn đề. Dành ra một cuối tuần — đến thứ Hai, bạn sẽ có một agent đã bắt đầu xây dựng các kỹ năng riêng cho công việc của mình.