Để kết nối Hermes Agent với OpenRouter, tạo một OpenRouter API key, chạy hermes model, chọn provider OpenRouter, dán key rồi chọn model GPT hoặc Claude; sau đó đổi qua lại giữa hai dòng model bằng /model ngay trong phiên chat. Một API key dùng được cả GPT của OpenAI lẫn Claude của Anthropic.
Bài thuộc cụm chọn LLM cho Hermes Agent của chuyên mục Hermes Agent. Bạn muốn Hermes Agent dùng model mạnh nhưng ngại mở nhiều tài khoản, nạp tiền và quản lý API key riêng cho từng hãng? Cùng Tino xem cách kết nối Hermes Agent với OpenRouter để dùng GPT và Claude dưới đây.
Hermes Agent dùng GPT và Claude qua OpenRouter như thế nào?
OpenRouter đứng giữa Hermes Agent và các model: Hermes gửi yêu cầu tới OpenRouter, OpenRouter chuyển tới model GPT hoặc Claude bạn chọn rồi trả kết quả về. Bạn chỉ quản lý một API key và đổi model bằng model ID.
Luồng xử lý: Bạn → Hermes Agent → OpenRouter → GPT hoặc Claude → Hermes Agent → kết quả.
Thay vì tạo riêng API key OpenAI rồi thêm API key Anthropic, bạn dùng một OpenRouter API key và chọn model bằng model ID tương ứng. Hermes Agent hỗ trợ OpenRouter trực tiếp. Model mặc định được lưu trong cấu hình Hermes Agent (~/.hermes/config.yaml) thay vì khai báo bằng LLM_MODEL trong file .env như một số phiên bản cũ.
Nên chọn GPT hay Claude cho Hermes Agent?
GPT và Claude đều chạy được qua OpenRouter và đều hỗ trợ gọi tool. Thay vì cố định một model cho mọi việc, hãy chọn theo độ phức tạp, tốc độ và chi phí: model tầm trung cho phần lớn việc hằng ngày, model cao cấp khi tác vụ thật sự cần suy luận sâu, model nhỏ cho việc phụ.
Một số model GPT có thể dùng trên OpenRouter
Ngày 26/10/2026, OpenRouter có nhiều model OpenAI. Bốn lựa chọn dễ phân biệt:
Model Model ID Giá input / output Phù hợp GPT-6 Astra openai/gpt-6-astra10 / 50 USD Công việc phức tạp, suy luận, code, nghiên cứu và workflow agent dài GPT-6 Sol openai/gpt-6-sol2 / 10 USD Cân bằng chất lượng và chi phí cho việc hằng ngày GPT-6 Luna openai/gpt-6-luna0,10 / 0,50 USD Chat, tác vụ thường xuyên, việc phụ, ưu tiên chi phí GPT-5.6 Luna openai/gpt-5.6-luna0,20 / 1,20 USD Bản thế hệ trước dùng trong ảnh minh hoạ
Các model GPT-6 trong bảng có context khoảng 1,05 triệu token và hỗ trợ tool; prompt trên 272 nghìn token tính giá cao hơn với GPT-6 Sol và GPT-6 Luna.
Một số model Claude có thể dùng trên OpenRouter
Bạn cũng có thể chọn các model Anthropic:
Model Model ID Giá input / output Phù hợp Claude Opus 5.5 anthropic/claude-opus-5.54 / 20 USD Suy luận phức tạp, code, phân tích chuyên sâu, agent chạy nhiều bước Claude Sonnet 5.5 anthropic/claude-sonnet-5.52 / 10 USD Cân bằng hiệu năng, tốc độ và chi phí Claude Sonnet 5 anthropic/claude-sonnet-52 / 10 USD Thế hệ liền trước Sonnet 5.5 Claude Haiku 5.5 anthropic/claude-haiku-5.50,10 / 0,50 USD Việc phụ, tóm tắt, cron
Các model Claude trong bảng đều có context 1 triệu token và hỗ trợ tool. Với phần lớn nhu cầu agent thông thường, model nhóm cân bằng như GPT-6 Sol hoặc Claude Sonnet 5.5 dễ kiểm soát chi phí hơn; model cao cấp hợp khi tác vụ cần suy luận mạnh hoặc quy trình dài.
Lưu ý: danh sách model OpenRouter thay đổi nhanh. Hãy kiểm model ID đang có trên OpenRouter trước khi cấu hình thay vì chép một ID cũ từ tài liệu lâu ngày.
Hướng dẫn kết nối Hermes Agent với OpenRouter để dùng GPT và Claude
Phần này áp dụng cho Hermes Agent tự cài trên VPS, máy chủ hoặc máy tính cá nhân: chuẩn bị API key, chạy hermes model, chọn OpenRouter, chọn model GPT, đổi sang Claude bằng /model và lưu model mặc định bằng --global.
Ảnh chụp cuối tháng 9/2026 trên Hermes v0.20.4; bản hiện hành là v0.22.5 (23/10/2026). Danh sách provider, model và giá trong ảnh có thể khác hiện tại, thao tác giữ nguyên.
Bước 1: Chuẩn bị OpenRouter API Key
Nếu OpenRouter đã được kết nối từ trước, bỏ qua bước này. Nếu chưa, tạo OpenRouter API key và lưu ở nơi an toàn; nên đặt giới hạn credit cho key ngay khi tạo.
Xem thêm: OpenRouter là gì? Hướng dẫn cách lấy API Key của OpenRouter A-Z
Bước 2: Mở trình cấu hình model của Hermes Agent
SSH vào VPS hoặc mở Terminal tại máy đang chạy Hermes Agent. Nhập:
hermes model
Đây là trình cấu hình provider và model của Hermes Agent. Lệnh hermes model dùng để:
- Thêm provider.
- Nhập API Key.
- Cập nhật thông tin xác thực.
- Chọn model.
- Thiết lập model mặc định.
Bước 3: Chọn OpenRouter làm Provider
Trong danh sách provider, chọn OpenRouter.

Nếu OpenRouter chưa từng được cấu hình, Hermes Agent yêu cầu nhập OpenRouter API key. Dán API key đã chuẩn bị rồi tiếp tục.
Lưu ý: không cần chọn Custom Endpoint vì OpenRouter đã được Hermes Agent hỗ trợ trực tiếp.
Bước 4: Chọn GPT làm model cho Hermes Agent (hoặc chọn Claude trước cũng được)
Sau khi chọn OpenRouter, Hermes Agent hiển thị danh sách model có thể dùng, kèm giá input, output và cache cho mỗi triệu token.

Chọn model OpenAI có trong danh sách, ví dụ:
openai/gpt-6-astra
Sau khi hoàn tất, khởi chạy Hermes Agent:
hermes
Quan sát phía trước ô nhập câu hỏi, bạn sẽ thấy model GPT đã chọn.

Bước 5: Chuyển từ GPT sang Claude
Không cần tạo thêm Anthropic API key nếu Claude được gọi qua OpenRouter. Trong phiên chat Hermes Agent, nhập:
/model
Sau đó chọn OpenRouter.

Danh sách model OpenRouter hiện ra. Nhấn Enter để chọn model Claude.

Muốn chuyển thẳng sang Claude Opus 5.5, dùng lệnh:
/model anthropic/claude-opus-5.5

Bước 6: Đặt GPT hoặc Claude làm model mặc định
Lệnh /model chỉ đổi model trong phiên hiện tại. Mở phiên khác, Hermes Agent quay về model mặc định đã lưu. Muốn lưu lựa chọn mới làm mặc định, thêm:
--global
Ví dụ:
/model anthropic/claude-opus-5.5 --global

Từ các phiên mới sau đó, Hermes Agent dùng cấu hình đã lưu. Tuỳ chọn --global ghi thay đổi vào config.yaml (Hermes Agent: CLI commands).

Cách dùng GPT và Claude trên VPS Hermes của Tino
Trên VPS Hermes của Tino, OpenRouter API key và model được quản lý trong giao diện web, nên không cần chỉnh file .env hay gõ lệnh Terminal. Cả quá trình gồm bốn bước: đăng nhập trang quản lý, mở Cấu hình AI, lưu API key, chọn provider và model.
Bước 1: Đăng nhập trang quản lý VPS Hermes của Tino.
Bước 2: Chọn VPS cần cấu hình, sau đó vào Hermes Agent → Cấu hình AI.

Bước 3: Trong phần Quản lý API Key, chọn OpenRouter — OPENROUTER_API_KEY. Dán OpenRouter API key, nhấn Kiểm tra nếu giao diện có tuỳ chọn này, rồi chọn Lưu API Key.

Bước 4: Quay lại khu vực Đổi Provider / Model.
- Tại Provider, chọn OpenRouter.
- Tại Model, chọn GPT hoặc Claude có trong danh sách.
Sau đó nhấn Áp dụng.

Nếu một model OpenRouter mới phát hành chưa có trong danh sách của trang quản lý, không nên nhập một model ID bất kỳ khi giao diện chưa hỗ trợ. Ưu tiên model đang có trong danh sách hoặc kiểm lại phiên bản và catalog trước.
Lỗi thường gặp khi dùng Hermes Agent với OpenRouter
Phần lớn lỗi khi Hermes gọi OpenRouter đến từ API key, số dư credit, model ID hoặc giới hạn tốc độ. Kiểm theo thứ tự trong bảng, từ key và số dư tới lỗi do chọn model; hermes config show cho biết provider và model đang cấu hình.
Hiện tượng Nguyên nhân thường gặp Cách xử lý Báo lỗi xác thực (401) Key sai, có khoảng trắng thừa, key đã bị xoá Tạo key mới, chạy lại hermes model để nhậpBáo hết credit (402) Số dư hết hoặc key chạm giới hạn credit đã đặt Nạp thêm credit hoặc nâng giới hạn của key Không tìm thấy model Model ID cũ hoặc gõ sai Chọn lại trong danh sách hermes model hoặc trang Models của OpenRouterBị giới hạn tốc độ (429) Gọi quá nhanh, đặc biệt với model :freeGiảm tần suất, đổi model trả phí, đặt model dự phòng Agent không gọi được tool Model không hỗ trợ tool hoặc context dưới 64K Chọn model có hỗ trợ tool, context từ 64.000 token
Cách tối ưu chi phí khi dùng Hermes Agent với OpenRouter
Khi chạy Hermes Agent thường xuyên, chi phí LLM tăng nhanh hơn chat AI thông thường vì một tác vụ agent có thể đi qua nhiều bước và mỗi bước gửi lại phần prompt cố định. Cách giữ chi phí là chia model theo độ khó và theo dõi mức dùng:
- Dùng GPT-6 Luna, Claude Haiku 5.5 hoặc model tiết kiệm tương đương cho chat và tác vụ nhẹ.
- Chuyển sang Claude Sonnet 5.5 hoặc GPT-6 Sol khi cần khả năng agent, code hoặc context dài hơn.
- Chỉ dùng GPT-6 Astra, Claude Opus 5.5 khi công việc thật sự cần mức suy luận cao.
- Theo dõi trang Activity trong tài khoản OpenRouter để phát hiện workflow tiêu thụ token bất thường.
- Không đưa toàn bộ lịch sử hội thoại vào những tác vụ không cần; hạn chế vòng lặp tool không tạo thêm giá trị.
- Kiểm giá model trước khi đặt làm model mặc định.
Cách bật prompt caching qua OpenRouter xem bài tối ưu chi phí API cho Hermes Agent; danh sách model giá thấp xem LLM giá rẻ cho Hermes Agent.
Khi nào không nên dùng OpenRouter cho Hermes Agent?
OpenRouter tiện khi muốn thử nhiều model bằng một key, nhưng nó là một bên trung gian thêm vào đường đi của prompt, thêm một chính sách dữ liệu và một chỗ có thể lỗi. Ba trường hợp nên cân nhắc nối thẳng tới hãng:
- Dữ liệu nhạy cảm cần hợp đồng xử lý dữ liệu trực tiếp với hãng model; OpenRouter ghi mỗi nhà cung cấp có chính sách lưu dữ liệu riêng (provider logging).
- Chỉ dùng một hãng lâu dài: OpenRouter không cộng phí vào giá suy luận nhưng có phí khi nạp credit (OpenRouter FAQ).
- Đã có gói ChatGPT và chỉ dùng cá nhân: xem kết nối ChatGPT/Codex với Hermes Agent.
Kết luận
Kết nối Hermes Agent với OpenRouter chỉ gồm vài thao tác: tạo API key, chạy hermes model, chọn model. Từ đó GPT và Claude cùng nằm trong một tài khoản. Hãy bắt đầu bằng một model cân bằng, theo dõi chi phí trên trang Activity của OpenRouter, rồi mới thử model cao cấp khi công việc thật sự cần.
Gặp lỗi thì rà lại API key, số dư và model ID theo bảng lỗi ở trên.
Muốn chạy Hermes Agent 24/7 mà không tự cài? VPS Hermes Agent của Tino cài sẵn Hermes Agent trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.
Bài viết liên quan trong cụm Model & chi phí Hermes:
- Nên chọn LLM nào cho Hermes Agent
- Đổi model LLM cho Hermes Agent
- Tối ưu chi phí API bằng prompt caching
- LLM giá rẻ cho Hermes Agent
- Model AI miễn phí cho Hermes Agent
- Lấy API key trên Nous Portal
Bài khác về Hermes Agent: Hermes Agent Desktop, kết nối Google Workspace với Hermes Agent, cách viết Skill cho Hermes Agent, Hermes Agent nên chạy local hay VPS.
Những câu hỏi thường gặp
GPT hay Claude phù hợp hơn với Hermes Agent?
Cả hai đều có model hỗ trợ suy luận và gọi tool. Lựa chọn phụ thuộc loại việc, chi phí, tốc độ và model cụ thể. Với workflow quan trọng, chạy cùng một nhiệm vụ trên hai model rồi so chất lượng, thời gian và token thực tế.
Vì sao model mới trên OpenRouter chưa xuất hiện trong Hermes Agent?
Danh sách model hiển thị trong Hermes phụ thuộc phiên bản Hermes, danh mục model đã tải về và giao diện quản lý (với VPS Hermes của Tino). Chạy lại hermes model hoặc cập nhật Hermes Agent; không tự nhập model ID chưa xác nhận.
Kết nối Hermes Agent với OpenRouter có mất phí không?
Hermes Agent là phần mềm mã nguồn mở, miễn phí. Bạn trả tiền token cho model GPT hoặc Claude theo bảng giá từng model trên OpenRouter; phí khi nạp credit xem tại trang Pricing của OpenRouter.
Có cần tài khoản OpenAI hoặc Anthropic riêng không?
Với đa số model thì không, một tài khoản OpenRouter là đủ. Một vài model có thể yêu cầu điều kiện truy cập riêng từ nhà cung cấp; trang model trên OpenRouter sẽ ghi rõ.
