Hermes Agent là gì?
Hermes Agent là một tác nhân cá nhân nguồn mở của Nous Research với bộ nhớ, khả năng sử dụng công cụ và kỹ năng bền bỉ.
Thiết lập Hermes Agent này sử dụng nhà cung cấp Tencent TokenHub tích hợp sẵn và lưu trữ TOKENHUB_API_KEY trong tệp môi trường được ghi lại. Chọn một mô hình có sẵn từ danh mục trực tiếp trước khi thử nghiệm một tác vụ an toàn. Hermes Agent có thể kết hợp bộ nhớ liên tục, kỹ năng, công cụ và giao diện người dùng khác nhau, nhưng những giao diện đó không thay thế cấu hình nhà cung cấp cơ bản. Cài đặt từ dự án Nous Research chính thức, bảo vệ tệp môi trường và đánh giá mức độ thành công của công cụ, nhu cầu ngữ cảnh, độ trễ và chi phí vận hành đối với một nhiệm vụ thực tế nhưng có rủi ro thấp.
Hermes Agent có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Endpoint TokenHub dùng trong hướng dẫn này là https://us-api.tokenhub.com/v1/chat/completions.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Hermes Agent để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
hermes --versionChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
| Trường | Giá trị |
|---|---|
| Nhà cung cấp | OpenAI Compatible hoặc Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Giá trị của TOKENHUB_API_KEY |
| Mô hình | gpt-4.1 hoặc model ID TokenHub khác |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| Secret | ~/.hermes/.env |
| Provider and model config | ~/.hermes/config.yaml |
| Named custom provider | tokenhub-custom |
TOKENHUB_API_KEY=sk-...custom_providers:
- name: tokenhub-custom
base_url: '__API_BASE_URL__/v1'
key_env: TOKENHUB_API_KEY
api_mode: chat_completions
model:
provider: 'custom:tokenhub-custom'
default: 'gpt-4.1'This follows Hermes' current named custom provider schema: base_url is the OpenAI-compatible Base URL, key_env reads the secret without writing it into YAML, and api_mode: chat_completions selects /v1/chat/completions.
Always keep the custom: prefix. Hermes treats bare tokenhub as a built-in provider alias; custom:tokenhub-custom unambiguously selects this self-hosted endpoint.
/model custom:tokenhub-custom:gpt-4.1hermes chatHermes stores the named custom provider, Base URL, API mode, and default model in ~/.hermes/config.yaml. The API key remains in ~/.hermes/.env. You can also run hermes model, select Custom Endpoint, and enter the same values interactively.
Nếu công cụ tách chat, edit, apply và fast models, hãy dùng cùng một mô hình TokenHub cho lần thử đầu tiên. Sau đó mới tách theo chi phí, độ trễ và năng lực suy luận.
Biến môi trường tạm thời chỉ để debug
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
export TOKENHUB_API_KEY="sk-..."Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Thiết lập Hermes Agent FAQ
Tôi nên chọn nhà cung cấp nào trong Hermes Agent?
Chọn Tencent TokenHub trong mô hình hermes. ID nhà cung cấp được ghi lại của nó là tencent-tokenhub, với tokenhub là bí danh.
Phím TokenHub API nên để ở đâu?
Lưu trữ TOKENHUB_API_KEY=... trong ~/.hermes/.env, đây là tệp thông tin xác thực tài liệu Hermes Agent dành cho nhà cung cấp này.
Tại sao tôi không nên mã hóa mô hình từ hướng dẫn này?
Danh mục Tencent TokenHub đang có sẵn và các mẫu có sẵn có thể thay đổi. Chọn một mẫu được hiển thị bởi mô hình Hermes hoặc nhập ID chính xác hiện có.
Hermes Agent và Nous Research có liên quan như thế nào?
Hermes Agent là một dự án đại lý nguồn mở từ Nous Research. Company tìm kiếm tài trợ hoặc định giá đều nằm ngoài hướng dẫn tích hợp này.
Tôi nên sử dụng compare Hermes Agent với OpenClaw như thế nào?
Sử dụng cùng một tác vụ thực tế để triển khai, bộ nhớ, kỹ năng, tích hợp kênh, độ tin cậy của công cụ, chi phí mô hình và bảo trì complexity.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。