Hermes Agent là một agent AI mã nguồn mở của Nous Research chạy từ terminal của bạn, kết nối với nhiều nhà cung cấp mô hình khác nhau, ghi nhớ ngữ cảnh hữu ích qua các phiên làm việc, và có thể mở rộng bằng công cụ, skill, gateway nhắn tin cùng tự động hóa. Hướng dẫn này giúp bạn biết cách cài đặt Hermes. Bạn không cần tự cài đặt Python hay Node.js cho trình cài đặt tiêu chuẩn trên macOS hoặc Windows vì trình cài đặt chính thức đã xử lý các phụ thuộc chính cho bạn.
Trước Khi Cài Đặt Hermes Agent
Hermes Agent là phần mềm ưu tiên terminal, vì vậy bạn sẽ cài đặt nó từ dòng lệnh. Chọn phần phù hợp với máy tính của bạn:
macOS: mở Terminal từ Applications > Utilities > Terminal, hoặc nhấn Command + Space và tìm "Terminal."
Windows: cài WSL2 trước, mở terminal bản phân phối Linux của bạn, rồi làm theo lệnh Linux.
Bạn cũng cần Git. Kiểm tra xem Git đã được cài đặt chưa:
Kết quả mong đợi:
Nếu bạn thấy git: command not found, hãy cài đặt Git trước:
Nếu bạn không có Homebrew trên macOS, hãy cài đặt Git từ Apple Command Line Tools bằng cách chạy:
Bước 1: Cài Đặt Hermes Agent Trên macOS Hoặc Windows
Trong terminal của bạn, sao chép và dán lệnh cài đặt chính thức:
Trình cài đặt tải Hermes Agent xuống, chuẩn bị môi trường Python của nó, cài đặt các phụ thuộc cần thiết, và thêm lệnh hermes vào đường dẫn shell của bạn. Với cài đặt người dùng thông thường, dữ liệu Hermes được lưu dưới ~/.hermes/.
Khi lệnh hoàn tất, tải lại shell của bạn:
Nếu bạn dùng Zsh, phổ biến trên macOS, hãy chạy:
Kết quả mong đợi:
Bây giờ hãy xác nhận lệnh Hermes Agent đã sẵn sàng:
Kết quả mong đợi:
Số phiên bản chính xác có thể thay đổi khi Hermes Agent được cập nhật.
Bước 2: Cấu Hình Nhà Cung Cấp Mô Hình Của Bạn
Hermes Agent cần một nhà cung cấp mô hình trước khi có thể trả lời hoặc sử dụng công cụ. Cách thiết lập dễ nhất cho người mới là dùng chế độ tương tác:
Trình hướng dẫn cho phép bạn chọn nhà cung cấp như Kimi/Moonshot. Đừng cấu hình routing, fallback, gateway hay cron cho đến khi việc trò chuyện cơ bản đã hoạt động.
Chọn mô hình mặc định. kimi-k2.6 là mô hình tiên tiến nhất của Kimi tính đến nay.
Nếu bạn đã biết giá trị muốn thiết lập, bạn có thể dùng hermes config set. Ví dụ:
Nếu bạn chưa có api-key, Kimi có thể là một lựa chọn hay.
Bước 1: Kích hoạt Kimi API của bạn
Trước khi sử dụng Kimi API với Hermes Agent, hãy kích hoạt Kimi API Key của bạn trên Kimi Platform. Chúng tôi khuyến nghị nạp từ 20 USD trở lên để mở khóa quyền truy cập Tier 2, giúp giảm độ trễ và hỗ trợ hiệu suất ổn định hơn cho các tác vụ phức tạp, nhiều bước
Bước 2: Tạo Kimi API Key của bạn
Vào mục API Keys trên Kimi Platform và nhấp Create API Key. Nhớ sao chép API key của bạn và lưu trữ an toàn, vì key chỉ được hiển thị một lần duy nhất khi tạo.
Bước 3: Nhập API key của bạn
Dán Kimi API key của bạn vào và kết nối với Hermes Agent.
Bước 3: Khởi động Hermes Agent
Sau khi cấu hình mô hình xong, khởi động CLI cổ điển:
Hoặc thử giao diện terminal mới hơn:
Bạn sẽ thấy màn hình chào mừng hoặc prompt hiển thị nhà cung cấp/mô hình bạn đã chọn. Hãy thử bằng một yêu cầu đơn giản:
Kết quả thành công sẽ trông như thế này:
Nếu Hermes Agent mở lên nhưng trả lời bằng lỗi mô hình hoặc xác thực, hãy chạy:
Sau đó chọn lại nhà cung cấp của bạn và kiểm tra API key hoặc đăng nhập OAuth.
Bước 4: Biến Hermes Agent thành Bot
Giống như OpenClaw, Hermes Agent cũng có thể hoạt động như một bot và kết nối với các ứng dụng chat của bạn:
Sau khi thiết lập, kiểm tra trạng thái gateway:
Chỉ nên sử dụng gateway sau khi nhà cung cấp mô hình của bạn đã hoạt động trong terminal. Nếu CLI không thể hoàn thành một cuộc trò chuyện cơ bản, bot thường sẽ gặp lỗi vì cùng lý do đó.
Các vấn đề thường gặp khi cài đặt Hermes Agent
hermes: command not found
Nguyên nhân: terminal của bạn chưa nạp lại thay đổi PATH.
Cách khắc phục:
Hoặc:
Sau đó thử:
git: command not found
Nguyên nhân: Chưa cài Git.
Khắc phục trên Ubuntu, Debian hoặc WSL2:
Khắc phục trên macOS bằng Homebrew:
Chưa Thiết Lập API Key
Nguyên nhân: Hermes Agent đã được cài đặt, nhưng chưa cấu hình khóa nhà cung cấp hoặc đăng nhập.
Cách khắc phục:
Hoặc thiết lập khóa thủ công:
hermes doctor Báo Cấu Hình Bị Thiếu Hoặc Lỗi Thời
Nguyên nhân: file cấu hình của bạn có thể chưa đầy đủ sau khi cập nhật.
Cách khắc phục:
Endpoint Tùy Chỉnh Kết Nối Được Nhưng Trả Lời Sai
Nguyên nhân: URL cơ sở, tên mô hình, hoặc độ dài ngữ cảnh không đúng.
Cách khắc phục: hãy kiểm tra endpoint bằng một client riêng trước, xác nhận nó tương thích OpenAI, và đảm bảo mô hình hỗ trợ ít nhất 64K ngữ cảnh cho các quy trình làm việc thông thường của Hermes Agent.
Bảng Tra Cứu Lệnh Nhanh
Kết Luận
Cách cài đặt Hermes Agent dễ nhất là dùng trình cài đặt chính thức một dòng lệnh, khởi động lại shell, chạy hermes model, và kiểm tra thiết lập bằng một cuộc trò chuyện thực tế cùng hermes doctor. Hãy giữ lần thiết lập đầu tiên đơn giản: một máy, một nhà cung cấp, một cuộc trò chuyện hoạt động ổn. Khi trợ lý Hermes Agent cơ bản đã ổn định, bạn có thể yên tâm mở rộng thêm với cách ly Docker, gateway bot, kỹ năng (skills), tự động hóa theo lịch, và các nhà cung cấp mô hình tùy chỉnh.
Câu hỏi thường gặp
~/.hermes/, và có thể mở rộng bằng skill, bộ nhớ, tác vụ theo lịch, cùng các gateway nhắn tin.hermes model, chọn một nhà cung cấp, ví dụ Kimi, khởi động hermes, thử một cuộc trò chuyện thông thường, chạy hermes doctor, và xác nhận hermes --continue khôi phục lại phiên làm việc của bạn. Sau đó, thêm cô lập Docker, skill, máy chủ MCP, giọng nói, cron, hoặc gateway nhắn tin khi cần.