Cài đặt Hermes Agent trên Ubuntu thực ra chỉ là một lệnh curl ... | bash, phần khó nằm ở chuẩn bị môi trường và cấu hình sau đó. Nếu agent đang chạy trên laptop, tắt máy là chết tiến trình, webhook không tới, cron không kích hoạt. Bài này dựng lại toàn bộ quy trình trên Ubuntu thật, từ chọn cấu hình máy chủ tới xử lý lỗi, để bạn triển khai một lần rồi để InterData lo phần hạ tầng.
NỘI DUNG BÀI VIẾT
- Hermes Agent là gì và vì sao nên cài trên Ubuntu thay vì laptop?
- Cần cấu hình VPS bao nhiêu để cài đặt Hermes Agent trên Ubuntu?
- Chuẩn bị Ubuntu trước khi cài đặt Hermes Agent
- Hướng dẫn cài đặt Hermes Agent trên Ubuntu từng bước
- Cấu hình Hermes Agent sau khi cài đặt: model, API key, tools
- Chạy Hermes Agent nền 24/7 và kết nối Telegram, Discord
- Lỗi thường gặp khi cài Hermes Agent trên Ubuntu và cách xử lý
- Cập nhật và gỡ cài đặt Hermes Agent trên Ubuntu
- Câu hỏi thường gặp
Hermes Agent Là Gì Và Vì Sao Nên Cài Đặt Hermes Agent Trên Ubuntu Thay Vì Laptop?
Hermes Agent là một AI Agent mã nguồn mở do Nous Research phát triển, giấy phép MIT. Điểm khác biệt so với một chatbot thông thường: Hermes Agent có vòng lặp tự học, tự tạo và cải tiến skill từ trải nghiệm thực tế, và có khả năng tìm lại ngữ cảnh từ các hội thoại cũ thay vì bắt đầu lại từ đầu mỗi phiên.
Agent không gắn cứng với model của Nous. Bạn trỏ nó tới bất kỳ endpoint tương thích nào qua lệnh hermes model, kể cả OpenRouter hoặc Nous Portal. Về mặt kết nối, Hermes Agent nói chuyện được với nhiều nền tảng nhắn tin qua một gateway chung: Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Teams, Google Chat. Muốn hiểu sâu cơ chế hoạt động, đọc thêm Hermes Agent là gì và cách hoạt động.
Vấn đề nằm ở chỗ agent cần chạy liên tục để nhận webhook, xử lý cron và giữ ngữ cảnh hội thoại. Laptop tắt máy, ngủ đông, đổi IP mạng nhà là agent chết hoặc mất kết nối gateway. Cài đặt Hermes Agent trên Ubuntu ở một VPS giải quyết đúng bài toán này: máy chạy 24/7, IP tĩnh, quyền root đầy đủ để agent tự cài dependency và chạy tiến trình nền.
Hermes Agent Và OpenClaw Khác Nhau Ở Đâu?
Cả hai đều là AI Agent tự host chạy trên VPS Ubuntu, nhưng khác cách tiếp cận: Hermes Agent tập trung vào vòng lặp tự học skill và đa nền tảng nhắn tin qua gateway chung, còn OpenClaw thiên về điều khiển trình duyệt và tác vụ automation trực tiếp. Nếu bạn đã thử OpenClaw, tham khảo thêm hướng dẫn cài đặt OpenClaw trên VPS Ubuntu để so sánh quy trình cài đặt và yêu cầu tài nguyên.
Cần Cấu Hình VPS Bao Nhiêu Để Cài Đặt Hermes Agent Trên Ubuntu?
Nous Research không công bố thông số phần cứng tối thiểu chính thức. Cấu hình dưới đây là ước lượng theo kịch bản sử dụng thực tế, không phải khuyến nghị từ nhà phát triển. Nếu chỉ chạy chat và cron, 2 vCPU / 4GB RAM là điểm khởi đầu hợp lý. Bật browser automation thì Chromium ăn RAM đáng kể, nên tăng lên 8GB trở lên.
| Kịch bản sử dụng | CPU / RAM ước lượng | Ghi chú |
|---|---|---|
| Chat + cron, không browser | 2 vCPU / 4GB RAM | Cài với cờ --skip-browser, phù hợp VPS headless |
| Bot Telegram/Discord + vài skill nhẹ | 2-4 vCPU / 6-8GB RAM | Tính thêm RAM cho Node.js và Python venv chạy song song |
| Bật browser automation (Playwright/Chromium) | 4 vCPU / 8-16GB RAM | Chromium headless có thể chiếm 1-2GB mỗi phiên đang mở |
| Nhiều agent/nhiều người dùng chung gateway | 6 vCPU trở lên / 16GB RAM trở lên | Nên tách sang Cloud Server để tăng tài nguyên nhanh khi cần |
Về dung lượng ổ đĩa, code nằm ở ~/.hermes/hermes-agent/ (chế độ per-user) hoặc /usr/local/lib/hermes-agent/ (chế độ root), cộng thêm Node.js v22, Python 3.11 qua uv, ripgrep, ffmpeg do installer tự cài. 20GB SSD trở lên là đủ thoải mái cho dữ liệu, log và cache.
Nên Cài Trên Máy Cá Nhân Hay VPS Ubuntu?
| Tiêu chí | Máy cá nhân | VPS Ubuntu |
|---|---|---|
| Chạy liên tục 24/7 | Không, tắt máy là agent dừng | Có, máy chủ chạy nền độc lập với máy cá nhân |
| Nhận webhook từ Telegram/Discord | Cần cấu hình reverse tunnel, IP hay đổi | IP tĩnh, cấu hình gateway một lần là ổn định |
| Quyền hệ thống | Thường không có quyền root, dễ vướng permission | Toàn quyền root, cài dependency không giới hạn |
| Phù hợp giai đoạn | Test nhanh, học cú pháp lệnh | Triển khai thật, dùng lâu dài |
Đây cũng là lý do Shared Hosting không phù hợp cho việc này: agent cần quyền root và tiến trình chạy nền liên tục, trong khi Shared Hosting phù hợp cho website tĩnh giai đoạn nhỏ hơn. Muốn hiểu rõ nền tảng hệ điều hành đang chạy dịch vụ, xem thêm Ubuntu Server là gì.
Lưu ý: Các con số CPU/RAM trên là ước lượng dựa theo kịch bản sử dụng thực tế, không phải thông số chính thức từ Nous Research. Workload thật của bạn (số skill kích hoạt, tần suất request, số phiên browser mở song song) có thể khiến mức tiêu thụ tài nguyên khác đi.
Trước khi chốt gói, xem qua deal VPS và Cloud Server mới nhất tại Canh Me để không trả giá niêm yết.
Chuẩn Bị Ubuntu Trước Khi Cài Đặt Hermes Agent
Trước khi chạy installer, bạn cần kết nối được vào VPS và có sẵn hai gói bắt buộc: Git và các tiện ích dòng lệnh liên quan. Phần này làm đúng thì bước cài đặt ở mục sau chạy trôi chảy, không dừng giữa chừng vì thiếu dependency.
Bước 1: Kết Nối VPS Qua SSH
Nếu chưa quen thao tác từ xa, xem cách truy cập VPS Linux bằng SSH trước. Sau khi vào được terminal của VPS, mọi lệnh trong bài này chạy trực tiếp trên đó, không phải trên máy tính cá nhân.
Bước 2: Cài Git, Curl Và Xz-utils
Prerequisite thật sự bắt buộc của Hermes Agent là Git. Trên Linux, bạn cần thêm curl và xz-utils để installer tải và giải nén các gói phụ thuộc. Nếu định dùng Hermes Desktop (giao diện đồ họa) thay vì chỉ CLI, cài thêm build-essential.
sudo apt update && sudo apt install -y git curl xz-utils
Lệnh trên cập nhật danh sách gói rồi cài đủ ba thành phần bắt buộc trong một lần chạy. Nếu bạn cần Hermes Desktop, chạy thêm:
sudo apt install -y build-essential
Kiểm tra lại phiên bản Git đã có trên máy bằng git --version. Nếu bạn muốn hiểu rõ hơn quy trình cài Git độc lập hoặc gặp lỗi, tham khảo cài đặt Git trên VPS Ubuntu.
Bước 3: Làm Quen Vài Lệnh Terminal Cơ Bản
Bạn sẽ thao tác nhiều với terminal trong suốt bài: kiểm tra thư mục, xem log, sửa file cấu hình. Nếu chưa quen, ôn lại các câu lệnh Linux cơ bản trước khi vào bước cài đặt chính.
Checklist trước khi chạy install.sh
- ☑ Đã SSH vào được VPS Ubuntu với user có quyền sudo
- ☑ Đã cài Git, curl, xz-utils (và build-essential nếu dùng Hermes Desktop)
- ☑ Đã xác định chạy per-user hay root-mode
- ☑ Nếu là service user không có sudo, admin đã chạy trước
sudo npx playwright install-deps chromium - ☑ Đã chuẩn bị sẵn API key (OpenRouter hoặc Nous Portal) để cấu hình ở bước sau
Cảnh báo bảo mật: Pipe một script từ internet thẳng vào bash là thói quen rủi ro. Trước khi chạy curl ... | bash, mở URL bằng trình duyệt hoặc curl -fsSL <url> | less để đọc qua nội dung install.sh, nhất là khi chạy với quyền root.
Hướng Dẫn Cài Đặt Hermes Agent Trên Ubuntu Từng Bước
Cài đặt Hermes Agent trên Ubuntu dùng chung một installer cho Linux, macOS, WSL2 và Termux. Installer tự lo phần còn lại: uv, Python 3.11, Node.js v22, ripgrep, ffmpeg. Bạn không cần cài tay bất kỳ thành phần nào trong số này.
Bước 1: Chạy Lệnh Cài Đặt
Trên VPS Ubuntu có giao diện đồ họa hoặc muốn dùng luôn trình duyệt tích hợp, chạy lệnh mặc định:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Với VPS headless (không desktop, là trường hợp phổ biến nhất khi thuê VPS Ubuntu), bỏ qua bước cài trình duyệt để tránh installer treo khi cố tải Chromium không cần thiết:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
Kết quả mong đợi: installer tải uv, dựng Python 3.11 venv, cài Node.js v22, ripgrep, ffmpeg, rồi tạo symlink binary. Toàn bộ quá trình mất vài phút tùy tốc độ mạng của VPS.
Bước 2: Xác Nhận Layout Cài Đặt
Layout phụ thuộc bạn chạy installer với quyền gì. Chạy với user thường (per-user), code và data nằm trong thư mục cá nhân. Chạy với root, mọi thứ chuyển sang thư mục hệ thống.
| Thành phần | Per-user | Root-mode |
|---|---|---|
| Code | ~/.hermes/hermes-agent/ |
/usr/local/lib/hermes-agent/ |
| Binary symlink | ~/.local/bin/hermes |
/usr/local/bin/hermes |
| Data | ~/.hermes/ |
/root/.hermes/ (hoặc theo biến $HERMES_HOME) |
Bước 3: Nạp Lại Shell Và Kiểm Tra
Sau khi installer chạy xong, nạp lại cấu hình shell để PATH nhận binary mới, rồi gõ lệnh khởi động agent:
source ~/.bashrc hermes
Nếu terminal nhận diện được lệnh hermes và mở đúng giao diện, quá trình cài đặt Hermes Agent trên Ubuntu đã hoàn tất. Muốn kiểm tra sức khỏe cấu hình bất kỳ lúc nào, chạy:
hermes doctor
Lệnh này rà soát dependency, PATH và config hiện tại, báo ra chỗ nào chưa ổn thay vì để bạn đoán mò qua log lỗi.
Trường hợp riêng: nếu bạn cài cho một service user không có quyền sudo (ví dụ user chạy riêng cho bot), admin cần chạy trước sudo npx playwright install-deps chromium, sau đó user thường mới chạy installer bình thường. Thiếu bước này, phần browser automation sẽ lỗi dù installer báo cài thành công.
Cấu Hình Hermes Agent Sau Khi Cài Đặt: Model, API Key, Tools
Cài xong chưa dùng được ngay, agent cần biết gọi model nào và bằng API key nào. Đây là phần quyết định trải nghiệm thực tế, và cũng là chỗ nhiều người bỏ qua rồi thắc mắc vì sao agent không phản hồi.
Gắn Model Provider Và API Key
Chạy lệnh sau để chọn hoặc đổi model provider bất kỳ lúc nào:
hermes model
Nếu muốn gắn thẳng API key qua dòng lệnh (ví dụ dùng OpenRouter), dùng:
hermes config set OPENROUTER_API_KEY your_key hermes config get OPENROUTER_API_KEY
Lệnh đầu ghi key vào config, lệnh sau đọc lại để xác nhận đã lưu đúng. Nếu muốn dùng một subscription cho nhiều model kèm Tool Gateway có sẵn (web search, sinh ảnh, TTS, cloud browser) mà không cần tự quản từng API key riêng lẻ, chạy portal setup:
hermes setup --portal
Bật Tool Và Gateway Nhắn Tin
Để agent dùng được các công cụ (tìm kiếm web, đọc file, chạy skill), chạy lệnh quản lý tools:
hermes tools
Để kết nối nền tảng nhắn tin (Telegram, Discord…), khởi tạo gateway riêng:
hermes gateway setup
Nếu bạn muốn thao tác trên giao diện TUI thay vì gõ từng lệnh rời rạc, dùng chế độ giao diện:
hermes --tui
Còn nếu VPS có desktop và bạn muốn dùng Hermes Desktop thay vì thuần CLI (nhớ đã cài build-essential ở bước chuẩn bị), gọi:
hermes desktop
Chạy Hermes Agent Nền 24/7 Và Kết Nối Telegram, Discord Sau Khi Cài Trên Ubuntu
Đây là lý do chính khiến bạn chuyển từ laptop sang VPS: agent phải sống được sau khi bạn đóng phiên SSH. Hermes Agent tự nó không có daemon nền tích hợp sẵn, nên bạn cần một lớp quản lý tiến trình bên ngoài.
Giữ Tiến Trình Sống Khi Đóng SSH
Cách nhanh nhất là chạy trong một phiên terminal ảo giữ được khi bạn ngắt SSH, ví dụ tmux hoặc screen:
tmux new -s hermes hermes
Bấm Ctrl+B rồi D để thoát khỏi phiên tmux mà không dừng tiến trình bên trong. Đóng SSH lúc này agent vẫn chạy, bạn gắn lại phiên bằng tmux attach -t hermes khi cần xem log.
Với môi trường production, cách bền hơn là để systemd quản lý, tự khởi động lại khi crash và chạy cùng lúc máy chủ boot. Tạo unit file trỏ đúng đường dẫn binary theo layout đã cài (per-user hoặc root-mode):
sudo nano /etc/systemd/system/hermes.service
[Unit] Description=Hermes Agent After=network.target [Service] Type=simple User=your_user ExecStart=/home/your_user/.local/bin/hermes Restart=on-failure [Install] WantedBy=multi-user.target
Thay your_user và đường dẫn binary theo đúng layout cài đặt của bạn (root-mode thì binary ở /usr/local/bin/hermes). Kích hoạt service bằng lệnh systemd chuẩn sudo systemctl enable --now hermes.
Kết Nối Telegram Và Discord
Sau khi agent chạy nền ổn định, quay lại hermes gateway setup để đăng ký bot token và kích hoạt kênh Telegram hoặc Discord. Vì gateway dùng chung một cơ chế cho nhiều nền tảng nhắn tin, cấu hình xong Telegram thì thêm Discord chỉ là lặp lại bước đăng ký token tương ứng.
Checklist chạy nền 24/7
- ☑ Đã kiểm tra
hermes doctorkhông báo lỗi trước khi để chạy nền dài hạn - ☑ Đã chọn tmux/screen (thử nghiệm) hoặc systemd (production)
- ☑ Đã chạy
hermes gateway setupcho từng nền tảng nhắn tin cần dùng - ☑ Đã giới hạn quyền truy cập SSH, không để mật khẩu yếu hoặc port mặc định mở tràn lan
Bảo mật: agent chạy 24/7 nghĩa là VPS của bạn cũng là mục tiêu tấn công dài hạn. API key tuyệt đối không commit lên Git, không dán lên nhóm chat chung. Đồng thời siết lại truy cập SSH theo hướng dẫn bảo mật SSH cho VPS trước khi để agent chạy không giám sát trong thời gian dài.
Lỗi Thường Gặp Khi Cài Hermes Agent Trên Ubuntu Và Cách Xử Lý
Phần lớn lỗi khi cài đặt Hermes Agent trên Ubuntu xoay quanh PATH, API key chưa gắn, hoặc gọi nhầm file thực thi. Bảng dưới liệt kê theo đúng cấu trúc triệu chứng, nguyên nhân, cách xử lý và cách kiểm tra lại.
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
hermes: command not found |
Shell chưa nạp lại PATH mới, hoặc ~/.local/bin chưa nằm trong PATH |
Chạy source ~/.bashrc. Nếu vẫn lỗi, thêm thủ công: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc rồi source ~/.bashrc lại |
| Báo API key not set | Chưa gắn key cho model provider đang chọn | Chạy hermes model để chọn lại provider, hoặc hermes config set OPENROUTER_API_KEY your_key |
| Mất config sau khi update | Format config đổi giữa các phiên bản | Chạy hermes config check để rà soát, sau đó hermes config migrate để chuyển đổi |
ModuleNotFoundError: No module named 'dotenv' |
Đang gọi nhầm file source ~/.hermes/hermes-agent/hermes thay vì launcher trong venv |
Gọi đúng launcher: ~/.hermes/hermes-agent/venv/bin/hermes, hoặc dùng lại symlink hermes đã có sẵn trong PATH |
Với mọi trường hợp còn nghi ngờ, chạy lại hermes doctor sau khi sửa để xác nhận môi trường đã sạch trước khi tiếp tục thao tác khác.
Cập Nhật Và Gỡ Cài Đặt Hermes Agent Trên Ubuntu
Cập nhật Hermes Agent lên bản mới không cần chạy lại installer từ đầu. Có sẵn lệnh riêng cho việc này:
hermes update
Sau khi update, nếu thấy config cũ không nhận đúng, quay lại quy trình hermes config check rồi hermes config migrate đã nói ở mục lỗi thường gặp.
Tài liệu chính thức chưa công bố lệnh gỡ cài đặt riêng cho Hermes Agent. Muốn gỡ hoàn toàn, xóa thủ công theo đúng layout đã cài: xóa thư mục code và data (~/.hermes/ ở chế độ per-user, hoặc /usr/local/lib/hermes-agent/ và /root/.hermes/ ở chế độ root), xóa symlink binary (~/.local/bin/hermes hoặc /usr/local/bin/hermes), rồi bỏ dòng export PATH đã thêm trong ~/.bashrc nếu có.
Lưu ý: đây là quy trình gỡ thủ công dựa theo layout thư mục chính thức, không phải một lệnh hermes uninstall được tài liệu hóa. Sao lưu file cấu hình trong ~/.hermes/ trước khi xóa nếu bạn định cài lại sau này.
Câu Hỏi Thường Gặp Về Cài Đặt Hermes Agent Trên Ubuntu
Hermes Agent có miễn phí không?
Bản thân Hermes Agent là phần mềm mã nguồn mở, giấy phép MIT, không tốn phí sử dụng. Chi phí thực tế phát sinh từ hai chỗ: hạ tầng VPS/Cloud Server để chạy 24/7, và chi phí gọi model qua API key (OpenRouter, Nous Portal hoặc provider khác) mà bạn tự đăng ký.
Nên cài Hermes Agent trên Ubuntu bản nào?
Installer hỗ trợ chung cho Linux nên chạy được trên nhiều bản Ubuntu còn được hỗ trợ. Ưu tiên bản LTS mới nhất đang phổ biến ở các nhà cung cấp VPS Việt Nam để đảm bảo tương thích gói apt và kernel ổn định lâu dài.
Cần cấu hình VPS bao nhiêu để cài đặt Hermes Agent trên Ubuntu?
Không có con số chính thức từ Nous Research. Ước lượng thực tế: 2 vCPU/4GB RAM đủ cho chat và cron, còn bật browser automation nên có từ 8GB RAM trở lên vì Chromium tiêu tốn RAM đáng kể mỗi phiên chạy song song.
Có bắt buộc dùng model của Nous Research không?
Không. Hermes Agent không gắn cứng với model nào của Nous. Bạn trỏ tới endpoint tương thích bất kỳ qua lệnh hermes model, dùng OpenRouter hoặc provider khác đều được, miễn endpoint tương thích với cấu trúc mà Hermes Agent yêu cầu.
Làm sao để Hermes Agent chạy tiếp khi đóng SSH?
Chạy agent trong phiên tmux hoặc screen để giữ tiến trình sống sau khi ngắt SSH, phù hợp thử nghiệm nhanh. Với môi trường dùng lâu dài, cấu hình chạy qua systemd để agent tự khởi động lại khi crash và chạy cùng lúc máy chủ boot.
Tổng Kết: Cài Đặt Hermes Agent Trên Ubuntu Không Khó, Khó Ở Khâu Duy Trì
Về mặt lệnh, cài đặt Hermes Agent trên Ubuntu chỉ là một dòng curl | bash. Phần quyết định trải nghiệm nằm ở ba việc: chọn đúng cấu hình VPS theo kịch bản sử dụng, cấu hình model/API key sau cài đặt, và giữ tiến trình chạy nền ổn định qua tmux hoặc systemd. Bỏ qua bất kỳ phần nào trong ba việc này, bạn sẽ quay lại đúng vấn đề ban đầu: agent chết khi đóng máy, webhook không tới.
Dựng VPS Ubuntu để chạy Hermes Agent ổn định ngay hôm nay
Chọn gói phù hợp kịch bản của bạn, cài một lần và để agent chạy nền lâu dài.
Nội dung trong bài mang tính tham khảo kỹ thuật, tổng hợp theo tài liệu chính thức của Hermes Agent tại thời điểm biên soạn. Lệnh, đường dẫn file và cấu hình có thể thay đổi theo phiên bản Ubuntu, phiên bản Hermes Agent và môi trường triển khai thực tế của bạn. Trước khi áp dụng cho hệ thống production, hãy kiểm thử trên môi trường riêng, sao lưu dữ liệu cấu hình và tự đánh giá rủi ro bảo mật phù hợp với nhu cầu sử dụng.
