close

Hướng dẫn kết nối Hermes Agent với OpenRouter dùng GPT và Claude

Tác giả: Đông Tùng Ngày đăng: 28/09/2026 Chuyên mục: Hermes Agent
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

Để 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:

ModelModel IDGiá input / outputPhù hợp
GPT-6 Astraopenai/gpt-6-astra10 / 50 USDCông việc phức tạp, suy luận, code, nghiên cứu và workflow agent dài
GPT-6 Solopenai/gpt-6-sol2 / 10 USDCân bằng chất lượng và chi phí cho việc hằng ngày
GPT-6 Lunaopenai/gpt-6-luna0,10 / 0,50 USDChat, tác vụ thường xuyên, việc phụ, ưu tiên chi phí
GPT-5.6 Lunaopenai/gpt-5.6-luna0,20 / 1,20 USDBản thế hệ trước dùng trong ảnh minh hoạ
Giá theo danh mục model trên OpenRouter ngày 26/10/2026, USD cho 1 triệu token; giá có thể đổi theo tuyến nhà cung cấp và thời điểm.

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:

ModelModel IDGiá input / outputPhù hợp
Claude Opus 5.5anthropic/claude-opus-5.54 / 20 USDSuy 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.5anthropic/claude-sonnet-5.52 / 10 USDCân bằng hiệu năng, tốc độ và chi phí
Claude Sonnet 5anthropic/claude-sonnet-52 / 10 USDThế hệ liền trước Sonnet 5.5
Claude Haiku 5.5anthropic/claude-haiku-5.50,10 / 0,50 USDViệc phụ, tóm tắt, cron
Giá theo danh mục model trên OpenRouter ngày 26/10/2026, USD cho 1 triệu token; giá có thể đổi theo tuyến nhà cung cấp và thời điểm.

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.

Danh sách provider trong hermes model, OpenRouter (Pay-per-use API aggregator) đang được chọn

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.

Danh sách model OpenRouter trong Hermes Agent kèm giá, chọn openai/gpt-6-astra

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.

Màn hình khởi động Hermes Agent v0.20.4 với model gpt-6-astra, danh sách tool và skill

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.

Model Picker trong phiên chat Hermes: chọn provider OpenRouter

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

Danh sách 53 model OpenRouter trong Model Picker của Hermes Agent, có các model Claude và GPT

Muốn chuyển thẳng sang Claude Opus 5.5, dùng lệnh:

/model anthropic/claude-opus-5.5
Kết quả /model anthropic/claude-opus-5.5: Model switched, provider OpenRouter, context 1.000.000 token, prompt caching enabled

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
Gõ lệnh /model anthropic/claude-opus-5.5 --global trong Hermes Agent

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).

Thông báo Saved to config.yaml sau khi dùng --global trong Hermes Agent

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.

Trang quản lý VPS Hermes của Tino: thẻ Hermes Agent, mục 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.

Quản lý API Key trên VPS Hermes: chọn OpenRouter OPENROUTER_API_KEY, ô API Key, nút Kiểm tra và 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.

Đổi Provider / Model trên VPS Hermes: provider OpenRouter, model anthropic/claude-sonnet-4.6, nút Á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ượngNguyên nhân thường gặpCá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ập
Báo hết credit (402)Số dư hết hoặc key chạm giới hạn credit đã đặtNạp thêm credit hoặc nâng giới hạn của key
Không tìm thấy modelModel ID cũ hoặc gõ saiChọn lại trong danh sách hermes model hoặc trang Models của OpenRouter
Bị 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 toolModel không hỗ trợ tool hoặc context dưới 64KChọ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:

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õ.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan

Xem nhiều