Chuyển tới nội dung chính

Điều hành đặc vụ Hermes với Nous Portal

Hướng dẫn này hướng dẫn bạn cách chạy Hermes Agent trên đăng ký Nous Portal từ đầu đến cuối - từ đăng ký đến xác minh rằng mọi công cụ đều định tuyến chính xác. Nếu bạn chỉ muốn biết tổng quan về Cổng thông tin là gì và những gì có trong đăng ký, hãy xem Nous Portal integration page. Trang này là kịch bản nhiệm vụ.

Điều kiện tiên quyết​

  • Đã cài đặt Đại lý Hermes (Quickstart)
  • Trình duyệt web trên máy bạn đang thiết lập (hoặc chuyển tiếp cổng SSH — xem OAuth over SSH)
  • Khoảng 5 phút

Bạn không cần: khóa OpenAI, khóa Anthropic, tài khoản Firecrawl, tài khoản FAL, tài khoản Sử dụng trình duyệt hoặc bất kỳ thông tin xác thực nào khác của mỗi nhà cung cấp. Đó là toàn bộ vấn đề.

1. Nhận đăng ký​

Mở portal.NousResearch.com/manage-subscription, đăng ký và chọn gói.

Bạn đã đăng ký chưa? Chuyển sang bước 2.

2. Chạy thiết lập một lần​

Hermes setup --portal

`
``Lệnh duy nhất này thực hiện năm điều:
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 
`model.provider: nous
` trong 

~/.Hermes/config.yaml

4. Chọn mô hình tác nhân mặc định (
`Anthropic/Claude-sonnet-4.6
` hoặc tương tự)
5. Bật Cổng công cụ để tìm kiếm trên web, tạo hình ảnh, TTS và tự động hóa trình duyệt

Khi quá trình kết thúc, bạn quay lại terminal của mình để sẵn sàng trò chuyện.

### Điều gì sẽ xảy ra nếu tôi truy cập SSH vào máy chủ?

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. Hai lựa chọn:

``` bash

# Option A: SSH port forwarding (preferred)
SSH -N -L 8642:127.0.0.1:8642 user@remote-host    # in a local terminal
Hermes setup --portal                              # on the remote, open the printed URL in your local browser

# Option B: manual paste (for Cloud Shell, Codespaces, EC2 Instance Connect)
Hermes auth add nous --type OAuth --manual-paste
# Then re-run 
`Hermes setup --portal
` to wire the provider + gateway

`
``Xem [OAuth over SSH / Remote Hosts](/docs/guides/OAuth-over-SSH) để biết hướng dẫn đầy đủ bao gồm chuỗi ProxyJump, mosh/tmux và các gotcha của ControlMaster.

## 3. Xác minh nó hoạt động

``` bash
Hermes portal status

`
``Bạn nên xem:

`
  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

`
``Nếu bất kỳ dòng nào hiển thị nội dung khác ngoài "via Nous Portal" hoặc dòng xác thực cho biết "chưa đăng nhập", hãy chuyển đến [Troubleshooting](#troubleshooting) bên dưới.

## 4. Bắt đầu cuộc trò chuyện đầu tiên của bạn

`bash
Hermes chat

`
``Hãy thử điều gì đó thực hiện cả mô hình và Cổng công cụ:

`
Hey, search the web for "Hermes Agent release notes" and summarize the top 3 hits.

`
``Bạn sẽ thấy Hermes gọi 
`web_search
` (Được hỗ trợ bởi Firecrawl, thông qua cổng) và phản hồi bằng một bản tóm tắt. Nếu quá trình tìm kiếm diễn ra và phản hồi hợp lý thì bạn đã hoàn tất — Cổng thông tin được kết nối từ đầu đến cuối.

## 5. Chọn mẫu bạn thực sự muốn

Mặc định sau 
`Hermes setup --portal
` là một mô hình có mục đích chung hợp lý, nhưng mục đích chung của việc đăng ký là quyền truy cập vào danh mục đầy đủ. Chuyển đổi bằng 

/model
` giữa phiên:

`bash
/model Anthropic/Claude-sonnet-4.6     # best general-purpose agentic
/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 Anthropic/Claude-opus-4.6       # heavyweight for hard problems

`
``Hoặc bật bộ chọn để duyệt:

`bash
/model

`
``Chọn một mặc định khác vĩnh viễn:

`bash

# in your terminal, outside any session
Hermes config set model.default Anthropic/Claude-sonnet-4.6

`

### Đừng chọn Hermes-4 để làm đại lý

Hermes-4-70B và Hermes-4-405B có sẵn trên Cổng thông tin với mức giảm giá sâu, nhưng chúng là **mô hình trò chuyện/lý luận**, không được điều chỉnh bằng công cụ. Họ sẽ phải vật lộn với các vòng lặp tác nhân gồm nhiều bước. Sử dụng chúng qua [Nous Chat](https://chat.NousResearch.com) cho công việc nghiên cứu/trò chuyện hoặc thông qua [subscription proxy](/docs/user-guide/features/subscription-proxy) từ các công cụ không phải tác nhân. Đối với chính Đại lý Hermes, hãy bám sát các mô hình đại lý biên cương ở trên.

[info page](https://portal.NousResearch.com/info) của Portal cũng đưa ra cảnh báo này - đó là hướng dẫn chính thức của Nous, không chỉ là ý kiến ​​​​của phía Hermes.

## 6. (Tùy chọn) Tùy chỉnh định tuyến Cổng công cụ

Cổng được chọn tham gia cho mỗi công cụ, không phải tất cả hoặc không có gì. Nếu bạn đã có tài khoản Browserbase và muốn tiếp tục sử dụng 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ợ:

``` bash
Hermes tools

# → Web search       → "Nous Subscription"     (recommended)
# → Image generation → "Nous Subscription"     (recommended)
# → Browser          → "Browserbase"           (your existing key)
# → TTS              → "Nous Subscription"     (recommended)

`
``Xác minh kết hợp của bạn với:

``` bash
Hermes portal tools

`
``Bạn sẽ thấy định tuyến theo từng công cụ — 
`via Nous Portal
` cho những công cụ được định tuyến thông qua đăng ký và tên đối tác (
`browserbase

, 
`firecrawl

, v.v.) cho những công cụ sử dụng khóa riêng của bạn.

## 7. (Tùy chọn) Bật chế độ giọng nói

Vì Tool Gateway bao gồm OpenAI TTS nên [voice mode](/docs/user-guide/features/voice-mode) hoạt động mà không cần khóa OpenAI riêng:

`bash
Hermes setup voice

# → pick "Nous Subscription" for TTS
# → pick a speech-to-text backend (local faster-whisper is free, no setup)

`
``Sau đó, trong bất kỳ phiên nền tảng nhắn tin nào (Telegram, Discord, Signal, v.v.), hãy gửi một tin nhắn thoại và Hermes sẽ chép lại tin nhắn đó, trả lời và trả lời bằng giọng nói tổng hợp - tất cả đều có trên đăng ký Cổng thông tin của bạn.

## 8. (Tùy chọn) Cron + quy trình làm việc luôn bật

Đăng ký Cổng thông tin hoạt động cho [cron jobs](/docs/user-guide/features/cron) và [batch processing](/docs/user-guide/features/batch-processing) giống như cách hoạt động cho trò chuyện tương tác — mã thông báo làm mới OAuth được sử dụng lại tự động. Không cần thiết lập bổ sung; chỉ cần lên lịch các công việc định kỳ và họ sẽ lập hóa đơn cho đăng ký của bạn.

``` bash
Hermes cron add "Daily AI news summary" "every day at 9am" \
  "Search the web for top AI news and summarize the 5 most important stories"

`
``Công việc định kỳ chạy không cần giám sát, gọi mô hình + tìm kiếm trên web + tóm tắt tất cả thông qua đăng ký Cổng thông tin của bạn.

## Cấu hình và thiết lập nhiều người dùngNếu bạn sử dụng [Hermes profiles](/docs/user-guide/profiles) (ví dụ: một cấu hình riêng cho mỗi dự án), 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 cấu hình thông qua kho lưu trữ mã thông báo được chia sẻ. Đă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ơ.

Đối với các thiết lập nhóm trong đó nhiều người dùng chung một máy, mỗi người có tài khoản Cổng thông tin riêng → mỗi thư mục chính chứa 

~/.Hermes/auth.JSON
` riêng → không chia sẻ mã thông báo giữa những người dùng. Đây là ranh giới phù hợp.

## Khắc phục sự cố

### 
`Hermes portal status
` hiển thị "chưa đăng nhập" sau 
`Hermes setup --portal
``Luồng OAuth chưa hoàn tất. Chạy lại nó:

`bash
Hermes auth add nous --type OAuth

`
``Nếu trình duyệt của bạn không mở hoặc gọi lại không thành công, có thể bạn đang sử dụng máy chủ từ xa/không có đầu — hãy xem [OAuth over SSH](/docs/guides/OAuth-over-SSH) để biết cách giải quyết chuyển tiếp cổng và dán thủ công.

### "Model: OpenRouter hiện tại" (hoặc một số nhà cung cấp khác) thay vì "dùng Nous làm nhà cung cấp suy luận"

Cấu hình cục bộ của bạn bị trôi. OAuth đã hoạt động nhưng 
`model.provider
` vẫn trỏ đến một nhà cung cấp khác. Sửa:

`bash
Hermes config set model.provider nous

`
``Hoặc tương tác:

`bash
Hermes model

# pick Nous Portal

`
``Xác minh lại bằng 
`Hermes portal status

.

### Công cụ Tool Gateway hiển thị tên đối tác thay vì "via Nous Portal"

Cấu hình mỗi công cụ đang ghi đè cổng. Chạy:

``` bash
Hermes tools

# pick "Nous Subscription" for any tool you want gateway-routed

`
``Một số người dùng cố tình trộn lẫn - ví dụ: định tuyến web thông qua Nous nhưng sử dụng khóa Browserbase riêng cho trình duyệt. Nếu đó là cố ý, hãy để nó yên. Nếu không, lệnh này sẽ sửa nó.

### "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, hết hạn phiên). Mã thông báo hiện đã được cách ly cục bộ nên Hermes không phát lại nó liên tục. Chỉ cần đăng nhập lại:

``` bash
Hermes auth add nous

`
``Việc cách ly sẽ tự động xóa khi đăng nhập lại thành công.

### Model tôi muốn không có trong bộ chọn 

/model
``Danh mục Cổng thông tin phản ánh danh sách mô hình của OpenRouter (300+). Nếu thiếu một mô hình, hãy thử nhập trực tiếp slug kiểu OpenRouter:

`bash
/model Anthropic/Claude-opus-4.6
/model OpenAI/o1-2025-12-17

`
``Nếu một kiểu máy thực sự không có sẵn, [open an issue](https://GitHub.com/NousResearch/Hermes-agent/issues) - hầu hết các lỗ hổng đều là cấu hình định tuyến mà chúng tôi có thể cập nhật.

### Thanh toán không xuất hiện trên tài khoản Cổng thông tin của tôi``Hermes portal status
` sẽ cho bạn biết liệu bạn có thực sự định tuyến qua Cổng thông tin hay một số nhà cung cấp khác hay không. Nguyên nhân phổ biến:
- 
`model.provider
` được đặt thành 
`OpenRouter

/
`Anthropic

/vv. thay vì 
`nous

`
- Lỗi làm mới OAuth do nhà cung cấp được định cấu hình khác
- Nhiều hồ sơ Hermes mà bạn đang sử dụng sai hồ sơ (kiểm tra 
`Hermes profile current

)

### Muốn thu hồi và bắt đầu lại

``` bash
Hermes auth remove nous       # wipes the local refresh token

# Then re-run setup or remove the subscription from the Portal web UI

`

## Điều này mang lại cho bạn điều gì, bằng những con số đơn giản

| Không có cổng thông tin | Với Cổng thông tin |
|-------|-------------|
| 1× Khóa OpenRouter / Anthropic / OpenAI trong 

.env
` | Mã thông báo làm mới 1× OAuth, không có khóa 

.env
` |
| 1× Khóa Firecrawl cho web | Định tuyến web qua cổng |
| Khóa 1× FAL cho gen hình ảnh | Gen hình ảnh được định tuyến qua cổng |
| 1× Sử dụng trình duyệt / Khóa cơ sở trình duyệt cho trình duyệt | Trình duyệt được định tuyến qua cổng |
| 1× Phím OpenAI cho chế độ TTS / giọng nói | TTS định tuyến qua cổng |
| 5 bảng điều khiển, nạp tiền, hóa đơn riêng biệt | 1 thuê bao, 1 hóa đơn |
| Cross-machine: sao chép cả 5 phím | Máy chéo: OAuth lại một lần |

Đó là thỏa thuận. Nếu bạn vẫn đang sử dụng nhiều hơn hai trong số các chương trình phụ trợ đó thì đăng ký sẽ tự trả tiền.

## Xem thêm
- **[Nous Portal integration page](/docs/integrations/nous-portal)** — Tổng quan về những gì có trong gói đăng ký
- **[Tool Gateway](/docs/user-guide/features/tool-gateway)** — Chi tiết đầy đủ về mọi công cụ định tuyến cổng
- **[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
- **[Voice mode](/docs/user-guide/features/voice-mode)** — Thiết lập cuộc trò chuyện thoại trên đăng ký Cổng thông tin
- **[OAuth over SSH](/docs/guides/OAuth-over-SSH)** — Mẫu đăng nhập từ xa / không đầu
- **[Profiles](/docs/user-guide/profiles)** — Chia sẻ một thông tin đăng nhập Cổng thông tin trên nhiều cấu hình Hermes