Nous Portal`Nous Portal là cổng đăng ký hợp nhất của Nous Research và cách được đề xuất để chạy Đại lý Hermes. Một thông tin đăng nhập OAuth thay thế hành động xử lý của các tài khoản, khóa API và mối quan hệ thanh toán riêng biệt trên mọi phòng thí nghiệm mô hình, API tìm kiếm, trình tạo hình ảnh và nhà cung cấp trình duyệt mà bạn cần phải kết nối thủ công.
Nếu bạn chỉ có thời gian để thiết lập một thứ, hãy thiết lập cái này. Con đường nhanh nhất:
Hermes setup --portal
`
``Lệnh duy nhất đó chạy Cổng thông tin OAuth, đặt Nous làm nhà cung cấp suy luận của bạn trong
`config.yaml
` và bật Cổng công cụ. Bạn đã sẵn sàng
`Hermes chat
` ngay sau đó.
Bạn chưa có đăng ký? [portal.NousResearch.com/manage-subscription](https://portal.NousResearch.com/manage-subscription) - đăng ký, sau đó quay lại và chạy lệnh trên.
## Có gì trong đăng ký
### Hơn 300 mẫu biên giới, một hóa đơn
Cổng thông tin cung cấp một danh mục được tuyển chọn gồm các mô hình tác nhân từ khắp hệ sinh thái — được tính phí theo đăng ký Nous của bạn thay vì một số dư tín dụng cho mỗi phòng thí nghiệm.
| Gia Đình | Người mẫu |
|--------|--------|
| **Claude nhân loại** | Opus, Sonnet, Haiku (loạt 4.x) |
| **OpenAI** | GPT-5.4, mô hình lý luận o-series |
| **Google Song Tử** | 2.5 Pro, 2.5 Flash |
| **DeepSeek** | DeepSeek V3.2, DeepSeek-R1 |
| **Qwen** | Gia đình Qwen3, Lập trình viên Qwen |
| **Kimi / Moonshot** | Kimi-K2, Kimi-Mới nhất |
| **GLM / Zhipu** | GLM-4.6, GLM-4-Plus |
| **MiniMax** | M2.7, M1 |
| **xAI** | Grok-4, Grok-3 |
| **Hermes** | Hermes-4-70B, Hermes-4-405B (trò chuyện, xem [note below](#a-note-on-Hermes-4)) |
| *** mọi thứ khác** | Hơn 240 mô hình bổ sung - biên giới đại lý đầy đủ |
Việc định tuyến diễn ra thông qua OpenRouter, do đó, tính khả dụng của mô hình và hành vi chuyển đổi dự phòng khớp với những gì bạn nhận được với khóa OpenRouter — thay vào đó, bạn chỉ được tính phí theo đăng ký Nous của mình. Chuyển đổi giữa Claude Sonnet 4.6 để lấy mã và Gemini 2.5 Pro để có bối cảnh dài với
/model
` giữa phiên — không có thông tin xác thực mới, không cần nạp tiền, không có lỗi cân bằng 0 bất ngờ.
### Cổng công cụ Nous
Đăng ký tương tự sẽ mở khóa [Tool Gateway](/docs/user-guide/features/tool-gateway), định tuyến các cuộc gọi công cụ của Đại lý Hermes thông qua cơ sở hạ tầng do Nous quản lý. Năm phụ trợ, một lần đăng nhập:
| Công cụ | Đối tác | Nó làm gì |
|------|----------|--------------|
| **Tìm kiếm và trích xuất trên web** | Pháo | Tìm kiếm cấp đại lý và trích xuất toàn trang. Không có khóa API Firecrawl, không giới hạn tỷ lệ trông trẻ. |
| **Tạo hình ảnh** | SAI | Chín mô hình dưới một điểm cuối: FLUX 2 Klein 9B, FLUX 2 Pro, Z-Image Turbo, Nano Banana Pro (Gemini 3 Pro Image), GPT Image 1.5, GPT Image 2, Ideogram V3, Recraft V4 Pro, Qwen Image. |
| **Chuyển văn bản thành giọng nói** | OpenAI TTS | TTS chất lượng cao không có khóa OpenAI riêng. Kích hoạt [voice mode](/docs/user-guide/features/voice-mode) trên các nền tảng nhắn tin. |
| **Tự động hóa trình duyệt đám mây** | Sử dụng trình duyệt | Phiên Chrome không đầu dành cho
`browser_navigate
,
`browser_CLIck
,
`browser_type
,
`browser_vision
. Không cần tài khoản Browserbase. |
| **Hộp cát terminal đám mây** | Phương thức | Hộp cát terminal không có máy chủ để thực thi mã (tiện ích bổ sung tùy chọn). |
Nếu không có cổng, việc kết nối từng cổng đó có nghĩa là tài khoản Firecrawl, tài khoản FAL, tài khoản Sử dụng trình duyệt, khóa OpenAI và tài khoản Modal - năm đăng ký riêng biệt, năm trang tổng quan riêng biệt, năm luồng nạp tiền riêng biệt. Với cổng, tất cả đều định tuyến thông qua một thuê bao.
Bạn cũng có thể chỉ bật các công cụ cổng cụ thể (ví dụ: tìm kiếm trên web chứ không phải tạo hình ảnh) - xem [Mixing the gateway with your own backends](#mixing-the-gateway-with-your-own-backends) bên dưới.
### Trò chuyện Nous
Tài khoản Cổng thông tin của bạn cũng bao gồm [chat.NousResearch.com](https://chat.NousResearch.com) - giao diện trò chuyện trên web của Nous Research với cùng một danh mục mô hình. Hữu ích khi bạn ở xa terminal của mình hoặc khi làm việc mà không cần tổng đài viên.
### Không có thông tin xác thực nào trong dotfiles của bạn
Vì mọi thứ đều định tuyến thông qua một phiên Cổng thông tin được xác thực OAuth nên bạn không tích lũy tệp
.env
` với hàng tá khóa API tồn tại lâu dài. Mã thông báo làm mới tại
~/.Hermes/auth.JSON
` là thông tin xác thực duy nhất trên đĩa và Hermes tạo ra JWT tồn tại trong thời gian ngắn từ nó theo yêu cầu - xem [Token handling](#token-handling) bên dưới.
### Tính chẵn lẻ đa nền tảng`[Native Windows](/docs/user-guide/Windows-native) vẫn là phiên bản beta sớm và thiết lập khóa API cho mỗi công cụ là phần khó khăn của nó - cài đặt tài khoản Firecrawl, tài khoản FAL, tài khoản Sử dụng trình duyệt, khóa OpenAI từ Windows là phần phức tạp nhất để có được một tác nhân hữu ích. Đăng ký Cổng thông tin sẽ giải quyết vấn đề đó: một OAuth bao gồm mô hình và mọi công cụ cổng, do đó, người dùng Windows có được trải nghiệm tương tự như macOS/Linux mà không cần định cấu hình bốn chương trình phụ trợ theo cách thủ công.
## Một lưu ý về Hermes 4Dòng **Hermes 4** (Hermes-4-70B, Hermes-4-405B) của Nous Research hiện có sẵn thông qua Cổng thông tin với mức giá chiết khấu cao. Đây là **mô hình trò chuyện lý luận lai biên giới** — giỏi toán, khoa học, tuân thủ hướng dẫn, tuân thủ lược đồ, nhập vai và viết dài.
Tuy nhiên, chúng **không được khuyến khích sử dụng bên trong Đại lý Hermes**. Hermes 4 được điều chỉnh để trò chuyện và lý luận chứ không phải vòng lặp gọi công cụ nhanh chóng mà nhân viên dựa vào. Sử dụng chúng cho [Nous Chat](https://chat.NousResearch.com), cho quy trình nghiên cứu hoặc thông qua [subscription proxy](/docs/user-guide/features/subscription-proxy) từ công cụ khác — nhưng đối với công việc của đại lý, thay vào đó hãy chọn mô hình đại lý biên giới từ danh mục:
`bash
/model Anthropic/Claude-sonnet-4.6 # best general-purpose agentic model
/model OpenAI/GPT-5.4 # strong reasoning + tool calling
/model Google/Gemini-2.5-pro # huge context window
/model DeepSeek/DeepSeek-v3.2 # cost-effective coder
`
``[model info page](https://portal.NousResearch.com/info) của Cổng thông tin cũng đưa ra cảnh báo tương tự, vì vậy đây không phải là ý kiến của phía Hermes - đây là hướng dẫn chính thức từ Nous Research.
## Thiết lập
### Cài đặt mới — một lệnh
`bash
Hermes setup --portal
`
``Điều này chạy thiết lập đầy đủ trong một lần chụp:
1. Mở trình duyệt của bạn tới Portal.NousResearch.com để đăng nhập OAuth
2. Lưu trữ mã thông báo làm mới tại
~/.Hermes/auth.JSON
3. Đặt Nous làm nhà cung cấp suy luận của bạn trong
~/.Hermes/config.yaml
4. Bật Cổng công cụ (web, hình ảnh, TTS, định tuyến trình duyệt)
5. Đưa bạn trở lại terminal sẵn sàng cho
`Hermes chat
``Nếu bạn chưa đăng ký, trước tiên hãy đăng ký tại [portal.NousResearch.com/manage-subscription](https://portal.NousResearch.com/manage-subscription).
### Cài đặt hiện có — thêm Cổng thông tin cùng với các nhà cung cấp khác
Nếu bạn đã định cấu hình Hermes với OpenRouter, Anthropic hoặc bất kỳ nhà cung cấp nào khác và bạn muốn thêm Cổng thông tin cùng với họ:
``` bash
Hermes model
# pick "Nous Portal" from the provider list
# browser opens, sign in, done
`
``Các nhà cung cấp hiện tại của bạn vẫn được cấu hình. Bạn có thể chuyển đổi giữa chúng bằng
/model
` giữa phiên hoặc
`Hermes model
` giữa các phiên — Cổng thông tin sẽ trở thành một trong những nhà cung cấp sẵn có của bạn chứ không phải là nhà cung cấp duy nhất của bạn.
### Không đầu / SSH / thiết lập từ xa
OAuth cần có trình duyệt nhưng lệnh gọi lại vòng lặp lại chạy trên máy mà Hermes đang chạy. Đối với các máy chủ từ xa, hãy xem [OAuth over SSH / Remote Hosts](/docs/guides/OAuth-over-SSH) — các mẫu tương tự hoạt động cho Cổng thông tin như đối với bất kỳ nhà cung cấp dựa trên OAuth nào khác (chuyển tiếp cổng
`SSH -L
,
--manual-paste
` dành cho các môi trường chỉ dành cho trình duyệt như Cloud Shell / Codespaces).
### Thiết lập hồ sơ
Nếu bạn sử dụng [Hermes profiles](/docs/user-guide/profiles), mã thông báo làm mới Cổng thông tin sẽ tự động được chia sẻ trên tất cả các hồ sơ thông qua kho lưu trữ mã thông báo dùng chung. Đăng nhập một lần trên bất kỳ hồ sơ nào và phần còn lại sẽ tự động nhận hồ sơ — không cần lặp lại quy trình OAuth cho mỗi hồ sơ.
## Sử dụng Cổng thông tin hàng ngày
### Kiểm tra những gì được kết nối
``` bash
Hermes portal status # login status, subscription info, model + gateway routing
Hermes portal tools # detailed Tool Gateway catalog with per-tool routing
Hermes portal open # open the subscription management page in your browser
`
```Hermes portal status
` (hoặc chỉ
`Hermes portal
) cung cấp cho bạn cái nhìn tổng quan cấp cao:
`
Nous Portal
───────────
Auth: ✓ logged in
Portal: https://portal.NousResearch.com
Model: ✓ using Nous as inference provider
Tool Gateway
────────────
Web search & extract via Nous Portal
Image generation via Nous Portal
Text-to-speech via Nous Portal
Browser automation via Nous Portal
Cloud terminal not configured
`
### Chuyển đổi mô hình
Bên trong một phiên:
`bash
/model Anthropic/Claude-sonnet-4.6
/model OpenAI/GPT-5.4
/model Google/Gemini-2.5-pro
`
``Hoặc mở bộ chọn:
`bash
/model
# arrow keys, enter to select
`
``Bên ngoài phiên (trình hướng dẫn thiết lập đầy đủ, hữu ích khi thêm nhà cung cấp mới):
``` bash
Hermes model
`
### Trộn cổng với phần phụ trợ của riêng bạn
Ví dụ: nếu bạn đã có tài khoản Browserbase và muốn tiếp tục sử dụng tài khoản đó trong khi định tuyến tìm kiếm trên web và tạo hình ảnh thông qua Nous, điều đó được hỗ trợ. Sử dụng
`Hermes tools
` để chọn phần phụ trợ cho mỗi công cụ:
`bash
Hermes tools
# → Web search → "Nous Subscription"
# → Image generation → "Nous Subscription"
# → Browser → "Browserbase" (your existing key)
# → TTS → "Nous Subscription"
`
``Cổng công cụ được chọn tham gia cho mỗi công cụ, không phải tất cả hoặc không có gì. Xem [Tool Gateway docs](/docs/user-guide/features/tool-gateway) để biết ma trận cấu hình đầy đủ cho mỗi công cụ.
### Quản lý đăng ký
Quản lý gói của bạn, xem mức sử dụng hoặc nâng cấp/hủy bất kỳ lúc nào:
- **Web:** [portal.NousResearch.com/manage-subscription](https://portal.NousResearch.com/manage-subscription)
- **Phím tắt CLI:**
`Hermes portal open
` (mở cùng một trang trong trình duyệt mặc định của bạn)
## Tham khảo cấu hình
Sau
`Hermes setup --portal
,
~/.Hermes/config.yaml
` sẽ có dạng:
``` yaml
model:
provider: nous
default: Anthropic/Claude-sonnet-4.6 # or whatever model you picked
base_url: https://inference.NousResearch.com/v1
`
``Cài đặt Cổng công cụ nằm trong phần công cụ tương ứng:
`YAML
web:
backend: nous # web search/extract routes through Tool Gateway`image_gen:
provider: nous`tts:
provider: nous`browser:
backend: nous
`
``Mã thông báo làm mới OAuth được lưu trữ riêng tại
~/.Hermes/auth.JSON
` (không phải trong
`config.yaml
` — thông tin xác thực và cấu hình được giữ riêng biệt theo thiết kế).
## Xử lý mã thông báo
Hermes tạo ra JWT tồn tại trong thời gian ngắn từ mã thông báo làm mới Cổng thông tin được lưu trữ của bạn trên mỗi lệnh gọi suy luận thay vì sử dụng lại khóa API tồn tại lâu dài. Vòng đời của mã thông báo hoàn toàn tự động — làm mới, đúc, thử lại trên 401 tạm thời — và bạn không bao giờ nhìn thấy nó.
Nếu Cổng thông tin vô hiệu hóa mã thông báo làm mới (thay đổi mật khẩu, thu hồi thủ công, hết hạn phiên), mã thông báo làm mới không hợp lệ sẽ bị **cách ly cục bộ** nên Hermes ngừng phát lại mã đó và bạn không thấy luồng 401 giống hệt nhau. Cuộc gọi tiếp theo sẽ hiển thị thông báo "yêu cầu xác thực lại" rõ ràng. Chạy
`Hermes auth add nous
` để đăng nhập lại; việc kiểm dịch sẽ được xóa vào lần đăng nhập thành công tiếp theo.
## Khắc phục sự cố
###
`Hermes portal status
` hiển thị "chưa đăng nhập"Bạn chưa hoàn thành quy trình OAuth hoặc mã thông báo làm mới của bạn đã bị xóa. Chạy:
`bash
Hermes auth add nous --type OAuth
`
``hoặc sử dụng
`Hermes model
` và chọn lại Nous Portal.
### Nhận được thông báo "yêu cầu xác thực lại" giữa phiên
Mã thông báo làm mới Cổng thông tin của bạn đã bị vô hiệu (thay đổi mật khẩu, thu hồi thủ công hoặc hết hạn phiên). Chạy
`Hermes auth add nous
` và yêu cầu tiếp theo của bạn sẽ sử dụng thông tin đăng nhập mới. Mọi vùng cách ly trên mã thông báo cũ sẽ tự động bị xóa khi đăng nhập lại thành công.
### Muốn sử dụng mô hình nhà cung cấp cụ thể mà Cổng thông tin không hiển thị
Cổng thông tin ủy quyền thông qua OpenRouter, vì vậy mọi mô hình mà OpenRouter hỗ trợ thường có sẵn. Nếu một kiểu máy cụ thể không xuất hiện trong
/model
, hãy thử trực tiếp sên kiểu OpenRouter:
`bash
/model Anthropic/Claude-opus-4.6
`
``Nếu một mô hình thực sự bị thiếu, [open an issue](https://GitHub.com/NousResearch/Hermes-agent/issues) - chúng tôi sẽ hiển thị danh mục của Cổng thông tin cho Hermes và các khoảng trống thường có nghĩa là cấu hình định tuyến mà chúng tôi có thể cập nhật.
### Hóa đơn không xuất hiện trên tài khoản Portal của tôi
Trước tiên hãy kiểm tra
`Hermes portal status
` — nếu nó hiển thị bạn đang sử dụng một nhà cung cấp khác (
`Model: currently OpenRouter
` thay vì
`using Nous as inference provider
), cấu hình cục bộ của bạn đã bị lệch. Chạy
`Hermes model
, chọn Nous Portal và yêu cầu tiếp theo sẽ chuyển qua đăng ký của bạn.
## Xem thêm
- **[Tool Gateway](/docs/user-guide/features/tool-gateway)** — Chi tiết đầy đủ về mọi công cụ cổng, cấu hình từng công cụ và giá cả
- **[Subscription proxy](/docs/user-guide/features/subscription-proxy)** — Sử dụng đăng ký Cổng thông tin của bạn từ các công cụ không phải của Hermes (các tác nhân, tập lệnh, ứng dụng khách bên thứ ba khác)
- **[Voice mode](/docs/user-guide/features/voice-mode)** — Cuộc trò chuyện bằng giọng nói sử dụng OpenAI TTS của Cổng thông tin
- **[AI Providers](/docs/integrations/providers)** — Danh mục nhà cung cấp đầy đủ nếu bạn muốn so sánh các lựa chọn thay thế
- **[OAuth over SSH](/docs/guides/OAuth-over-SSH)** — Đăng nhập từ máy chủ từ xa hoặc môi trường chỉ có trình duyệt
- **[Profiles](/docs/user-guide/profiles)** — Nhiều cấu hình Hermes chia sẻ một lần đăng nhập Cổng thông tin