Hermes Agent có thể kết nối với nhiều nhà cung cấp mô hình AI khác nhau. Tuy nhiên, nếu muốn dễ dàng thử Claude, Gemini, GPT, DeepSeek, Kimi cùng nhiều model khác mà không phải tạo API Key riêng cho từng dịch vụ, OpenRouter là một lựa chọn khá thuận tiện. Cùng Tino tìm hiểu cách kết nối Hermes Agent với OpenRouter qua bài viết dưới đây nhé!
Vì sao nên kết nối Hermes Agent với OpenRouter?
Kết nối Hermes Agent với OpenRouter mang lại một số lợi ích đáng chú ý:
- Chỉ cần quản lý một OpenRouter API Key.
- Có thể sử dụng nhiều model AI từ nhiều nhà cung cấp.
- Dễ dàng chuyển model khi nhu cầu thay đổi.
- Có thể lựa chọn model theo giá, tốc độ hoặc khả năng xử lý.
- OpenRouter hỗ trợ cơ chế định tuyến giữa nhiều nhà cung cấp.
- Dễ theo dõi lượng sử dụng và chi phí trên OpenRouter.
- Phù hợp khi muốn thử nhiều model trước khi lựa chọn model chính.
OpenRouter cũng có thể tự chọn nhà cung cấp phía sau cùng một model dựa trên các tiêu chí như giá, độ ổn định và hiệu suất. Người dùng có thể cấu hình thêm cách định tuyến nếu cần kiểm soát sâu hơn.
Cần chuẩn bị gì trước khi kết nối Hermes Agent với OpenRouter?
Trước khi bắt đầu, bạn cần chuẩn bị:
- Hermes Agent đã được cài đặt và có thể khởi chạy.
- Máy tính, VPS hoặc máy chủ đang chạy Hermes Agent có kết nối Internet.
- Tài khoản OpenRouter.
- OpenRouter API Key.
- Số dư OpenRouter nếu sử dụng model trả phí.
Bạn không bắt buộc phải nạp tiền ngay nếu chỉ muốn thử các model miễn phí đang có trên OpenRouter. Tuy nhiên, model miễn phí thường đi kèm giới hạn request và có thể bị giới hạn mạnh hơn khi lượng truy cập tăng cao.
Hướng dẫn kết nối Hermes Agent với OpenRouter (tự cài đặt Hermes Agent trên VPS)
Bước 1: Tạo tài khoản OpenRouter và chuẩn bị API Key
Trước khi kết nối Hermes Agent với OpenRouter, bạn cần có tài khoản OpenRouter và một API Key để Hermes Agent có thể gửi yêu cầu đến các model AI thông qua nền tảng này.
Quy trình chuẩn bị khá đơn giản:
- Đăng ký hoặc đăng nhập tài khoản OpenRouter.
- Truy cập khu vực quản lý API Keys.
- Tạo một API Key mới.
- Sao chép và lưu API Key tại nơi an toàn để sử dụng ở bước tiếp theo.
- Nếu sử dụng model trả phí, hãy kiểm tra số dư tài khoản OpenRouter trước khi kết nối.
API Key thường có dạng:
sk-or-v1-xxxxxxxxxxxxxxxxNếu chưa từng sử dụng OpenRouter hoặc chưa biết cách đăng ký tài khoản, tạo API Key và chọn model, bạn có thể tham khảo bài hướng dẫn chi tiết: OpenRouter là gì? Hướng dẫn sử dụng OpenRouter từ A-Z
Lưu ý: Không chia sẻ OpenRouter API Key công khai, không chèn key vào ảnh hướng dẫn và không lưu key trong repository GitHub public. Nếu nghi ngờ API Key đã bị lộ, hãy thu hồi key cũ và tạo key mới.
Bước 2: Truy cập VPS hoặc máy đang chạy Hermes Agent
Nếu Hermes Agent được cài trên VPS, hãy SSH vào VPS bằng Xshell, Terminal hoặc công cụ SSH đang sử dụng.
Tại Terminal, nhập:
hermes modelHermes Agent sẽ mở trình lựa chọn provider và model. Lệnh hermes model hiện được Hermes sử dụng để:
- Thêm provider mới.
- Nhập hoặc cập nhật API Key.
- Thực hiện đăng nhập OAuth với provider hỗ trợ.
- Chọn model.
- Lưu provider và model mặc định.
Bước 3: Chọn OpenRouter
Trong danh sách provider, tìm và chọn trực tiếp OpenRouter.
Lưu ý: Không cần chọn Custom Endpoint nếu mục tiêu chỉ là kết nối trực tiếp với OpenRouter. Hermes Agent đã có OpenRouter dưới dạng provider được hỗ trợ sẵn.
Bước 4: Nhập OpenRouter API Key
Khi Hermes Agent yêu cầu API Key, dán key đã tạo ở bước trước.
Sau khi xác nhận, Hermes Agent sẽ lưu thông tin xác thực OpenRouter.
Bước 5: Chọn model AI muốn sử dụng
Sau khi API Key hợp lệ, Hermes Agent sẽ hiển thị danh sách model OpenRouter có thể lựa chọn. Bạn chỉ cần chọn model phù hợp với nhu cầu.
Danh sách này có thể thay đổi theo thời gian. Hermes Agent hiện hỗ trợ tải catalog model từ xa, nhờ vậy nhà phát triển có thể cập nhật danh sách model gợi ý mà không cần chờ một phiên bản Hermes Agent mới.
Khi lựa chọn model cho AI Agent, nên ưu tiên các yếu tố:
- Hỗ trợ tool calling tốt.
- Context window đủ lớn.
- Chi phí phù hợp.
- Tốc độ phản hồi ổn định.
- Khả năng reasoning phù hợp với công việc.
- Có provider hoạt động ổn định trên OpenRouter.
Hermes Agent khuyến nghị ưu tiên model có context khoảng 64K token trở lên cho các cấu hình agent phổ biến. Model có context quá nhỏ có thể gặp khó khăn khi Hermes phải mang theo system prompt, lịch sử hội thoại và thông tin tool trong cùng request.
Lưu ý: Không nên sao chép một model ID cũ từ bài hướng dẫn trên Internet nếu model đã được đổi tên hoặc ngừng cung cấp. Cách an toàn hơn là chọn trực tiếp từ danh sách mà hermes model đang hiển thị.
Bước 6: Kiểm tra kết nối Hermes Agent với OpenRouter
Sau khi lưu model, chạy lệnh:
hermes
Sau đó gửi một câu hỏi thử, chẳng hạn:
Hãy giới thiệu ngắn gọn về Hermes Agent.
Nếu Hermes Agent trả lời bình thường, quá trình kết nối đã thành công.
Nếu muốn ép một phiên làm việc sử dụng OpenRouter, Hermes cũng hỗ trợ lệnh:
hermes chat --provider openrouter --model <model-id>Ví dụ <model-id> cần được thay bằng model thực tế đang có trên OpenRouter.
Cách đổi model OpenRouter trong Hermes Agent
Sau khi OpenRouter đã được thiết lập, bạn không cần nhập lại API Key mỗi lần muốn đổi model.
Trong phiên chat Hermes Agent, nhập:
/modelHermes sẽ hiển thị những model và provider đã được cấu hình.
Nếu biết chính xác model ID, bạn cũng có thể chuyển trực tiếp theo cú pháp tương ứng.
Điểm cần phân biệt:
- hermes model được chạy ngoài Terminal và dùng để thêm provider, xác thực API Key hoặc thiết lập provider mới.
- /model được nhập bên trong phiên chat và chủ yếu dùng để chuyển giữa những provider/model đã được thiết lập.
Nếu muốn lựa chọn mới trở thành mặc định cho những phiên sau, Hermes hiện hỗ trợ tùy chọn –global khi chuyển model trong phiên chat.
Cách kết nối Hermes Agent với OpenRouter trên VPS Hermes của Tino
Nếu đang sử dụng VPS cài sẵn Hermes Agent của Tino, bạn không cần SSH vào VPS. Toàn bộ quá trình thêm OpenRouter API Key và chọn model có thể thực hiện trực tiếp trên giao diện quản trị.
Bước 1: Đăng nhập trang quản lý dịch vụ VPS Hermes của Tino. Tại dịch vụ cần cấu hình, chọn tab Hermes Agent → Cấu hình AI.
Tại đây, bạn có thể quản lý API Key, Provider và model đang được Hermes Agent sử dụng.
Bước 2: Kéo xuống phần Quản lý API Key và thực hiện:
- Tại Target (env var), chọn OpenRouter — OPENROUTER_API_KEY.
- Dán OpenRouter API Key vào ô API Key.
- Có thể nhấn Kiểm tra để kiểm tra key trước.
Nhấn Lưu API Key để hoàn tất.
Sau khi lưu thành công, OpenRouter sẽ xuất hiện trong khu vực API Key đã cấu hình.
Bước 3: Quay lại khu vực Đổi Provider / Model. Tại mục Provider, chọn OpenRouter.
Hermes Agent sẽ hiển thị danh sách model OpenRouter đang được hệ thống hỗ trợ.
Tại mục Model, chọn model muốn sử dụng, chẳng hạn:
- anthropic/claude-sonnet-4.6
- openai/gpt-5.2
- google/gemini-2.5-pro
- meta-llama/llama-4-maverick
- deepseek/deepseek-v4
Danh sách model có thể thay đổi theo từng thời điểm, vì vậy bạn nên chọn trực tiếp từ danh sách hiển thị trên trang quản lý.
Sau khi chọn Provider và model, nhấn Áp dụng. Mỗi lần cần thay đổi model, bạn cũng thực hiện tương tự.
Nếu cấu hình thành công, phía trên trang sẽ hiển thị:
- Provider hiện tại: OpenRouter.
- Model hiện tại: model bạn vừa chọn.
Bước 6: Cuối cùng, hãy gửi một tin nhắn thử cho Hermes Agent trên kênh đã kết nối như Telegram, Slack, Discord hoặc giao diện chat đang sử dụng.
Nếu Hermes Agent trả về đúng model và provider OpenRouter vừa cấu hình, quá trình kết nối đã hoàn tất.
Mẹo sử dụng OpenRouter với Hermes Agent hiệu quả
Để sử dụng lâu dài và hạn chế chi phí không cần thiết, bạn nên:
- Bắt đầu bằng một model ổn định trước khi cấu hình thêm gateway, cron hoặc workflow phức tạp.
- Chọn model có context đủ lớn.
- Theo dõi chi phí thường xuyên trên OpenRouter.
- Không sử dụng model mạnh nhất cho mọi tác vụ nhỏ.
- Giữ API Key riêng tư.
- Xóa hoặc thu hồi API Key ngay khi nghi ngờ bị lộ.
- Sử dụng /model để thử nhiều model trước khi đặt model mặc định.
- Kiểm tra lại provider khi Hermes phản hồi khác với mong đợi.
- Chỉ cấu hình routing và fallback sau khi một phiên chat cơ bản đã hoạt động ổn định.
Xem thêm: Hướng dẫn dùng miễn phí API LLM trên OpenRouter
Kết luận
Tóm lại, kết nối Hermes Agent với OpenRouter khá đơn giản và không đòi hỏi kiến thức lập trình chuyên sâu, đặc biệt là khi sử dụng VPS Hermes của Tino Hãy bắt đầu với một model quen thuộc, theo dõi mức sử dụng qua Activity Dashboard của OpenRouter, sau đó dần khám phá các tính năng nâng cao như định tuyến nhà cung cấp hay chuỗi dự phòng để tối ưu cả hiệu suất lẫn chi phí vận hành lâu dài.
Những câu hỏi thường gặp
Chi phí sử dụng Hermes Agent qua OpenRouter được tính như thế nào?
Chi phí được tính dựa trên số token đầu vào và đầu ra theo đơn giá riêng của từng model, hiển thị chi tiết tại trang openrouter.ai/models và có thể theo dõi trực tiếp qua Activity Dashboard.
Có thể dùng OpenRouter miễn phí với Hermes Agent không?
Có thể nếu chọn model miễn phí đang được OpenRouter cung cấp. Tuy nhiên, nhóm model này thường có giới hạn request và khả năng truy cập có thể thay đổi theo thời điểm. Với nhu cầu chạy AI Agent thường xuyên, model trả phí thường ổn định hơn.
Một OpenRouter API Key có thể dùng nhiều model không?
Có. Đây là một trong những lợi ích chính của OpenRouter. Một API Key có thể truy cập nhiều model được tài khoản OpenRouter hỗ trợ mà không cần tạo key riêng cho từng hãng AI.
Vì sao OpenRouter đã kết nối nhưng Hermes Agent không phản hồi?
Bạn nên kiểm tra lần lượt API Key, credit, model ID, rate limit, context window và khả năng tool calling của model. Có thể chạy hermes model để chọn lại provider/model và hermes config show để kiểm tra cấu hình hiện tại.
