Cách cài đặt Hermes Agent: Hướng dẫn thiết lập cho người mới

Hermes Agent là tác tử AI mã nguồn mở của Nous Research, chạy từ terminal, kết nối với nhiều nhà cung cấp mô hình, ghi nhớ ngữ cảnh hữu ích giữa các phiên và có thể mở rộng bằng công cụ, kỹ năng, cổng nhắn tin và 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 Python hoặc Node.js khi dùng 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 sẽ xử lý các phần phụ thuộc chính cho bạn.

Hermes Agent là phần mềm ưu tiên terminal, vì vậy bạn sẽ cài đặt bằng dòng lệnh. Hãy chọn phần phù hợp với máy tính của bạn:

• macOS: mở Terminal từ Ứng dụng > Tiện ích > Terminal, hoặc nhấn Command + Space rồi tìm kiếm "Terminal."

• Windows: trước tiên hãy cài WSL2, mở terminal của bản phân phối Linux, rồi làm theo lệnh dành cho Linux.

Bạn cũng cần Git. Hãy kiểm tra xem Git đã được cài đặt chưa:

Kết quả mong đợi:

Nếu thấy git: command not found, hãy cài đặt Git trước:

Nếu chưa có Homebrew trên macOS, hãy cài Git từ Apple Command Line Tools bằng cách chạy:

Trong terminal, sao chép và dán lệnh cài đặt chính thức:

Trình cài đặt tải xuống Hermes Agent, chuẩn bị môi trường Python, cài đặt các phần phụ thuộc cần thiết và thêm lệnh hermes vào biến PATH của shell. Với cài đặt người dùng thông thường, dữ liệu Hermes được lưu trong ~/.hermes/.

Khi lệnh hoàn tất, hãy tải lại shell của bạn:

Nếu dùng Zsh, thường gặp 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 đã khả dụ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.

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 một nhà cung cấp như Kimi/Moonshot. Đừng cấu hình định tuyến, dự phòng, gateway hoặc cron cho đến khi cuộc trò chuyện cơ bản hoạt động.

Chọn mô hình mặc định. Kimi K3 là mô hình đầu bảng mới nhất của Kimi; nếu chủ yếu muốn lập trình, kimi-k2.7-code là lựa chọn phù hợp hơn.

Nếu đã biết giá trị muốn đặt, bạn có thể dùng hermes config set. Ví dụ:

Trước khi sử dụng Kimi API với Hermes Agent, hãy kích hoạt Kimi API Key trên Kimi Platform. Chúng tôi khuyến nghị nạp từ $20 trở lên để mở khóa quyền truy cập Tier 2, giúp giảm độ trễ và duy trì hiệu năng ổn định hơn cho các tác vụ phức tạp, nhiều bước

Vào mục API Keys trong Kimi Platform và nhấp vào Create API Key. Hãy nhớ sao chép API key và lưu trữ an toàn, vì khóa này chỉ hiển thị một lần khi tạo.

Dán Kimi API key rồi kết nối Hermes Agent.

Sau khi cấu hình mô hình, hãy khởi động CLI cổ điển:

Hoặc thử giao diện người dùng 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 đã chọn. Hãy thử bằng một yêu cầu đơn giản:

Khi thành công, kết quả sẽ như sau:

Nếu Hermes Agent mở được nhưng trả về lỗi mô hình hoặc xác thực, hãy chạy:

Sau đó chọn lại nhà cung cấp và kiểm tra API key hoặc thông tin đăng nhập OAuth.

Giống 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 trò chuyện của bạn:

Sau khi thiết lập, hãy kiểm tra trạng thái gateway:

Chỉ 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 tất một cuộc trò chuyện cơ bản, bot thường cũng sẽ thất bại vì cùng lý do.

Nguyên nhân: terminal của bạn chưa tải lại thay đổi PATH.

Cách khắc phục:

Hoặc:

Sau đó thử:

Nguyên nhân: thiếu Git.

Cách khắc phục trên Ubuntu, Debian hoặc WSL2:

Cách khắc phục trên macOS bằng Homebrew:

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 thông tin đăng nhập.

Cách khắc phục:

Hoặc tự thiết lập khóa:

Nguyên nhân: tệp cấu hình có thể chưa đầy đủ sau khi cập nhật.

Cách khắc phục:

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: trước tiên hãy kiểm tra endpoint bằng một client riêng, xác nhận endpoint tương thích với 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 Hermes Agent thông thường.

Cách dễ nhất để cài đặt Hermes Agent là dùng trình cài đặt chính thức chỉ với một dòng lệnh, tải lại shell, chạy hermes model và xác minh thiết lập bằng một cuộc trò chuyện thực tế cùng hermes doctor. Hãy giữ thiết lập ban đầu đơn giản: một máy, một nhà cung cấp, một cuộc trò chuyện hoạt động tốt. Khi trợ lý Hermes Agent cơ bản đã ổn định, bạn có thể an tâm mở rộng với khả năng cô lập Docker, bot gateway, kỹ năng, tính năng tự động hóa theo lịch và các nhà cung cấp mô hình tùy chỉnh.