Bộ cài đặt offline native HermesAgent cho Windows: dùng Hermes trên Windows không cần VPN hay WSL

Hướng dẫn cài đặt HermesAgent cho người dùng Windows. Không cần WSL, không cần VPN, cũng không cần cấu hình rắc rối. Chỉ cần làm theo các bước để cài Hermes, cấu hình API và kết nối WeChat trên Windows native.

Bộ cài đặt offline native HermesAgent cho Windows: dùng Hermes trên Windows không cần VPN hay WSL

**Đây là hướng dẫn cài đặt HermesAgent dành cho người dùng Windows.** Không cần WSL, không cần VPN, cũng không cần thêm bước thiết lập rắc rối. Chỉ cần làm theo các bước dưới đây để cài Hermes, cấu hình API và kết nối WeChat trên Windows native.

**Ai nên đọc bài này**
Những ai muốn chạy Hermes trực tiếp trên máy Windows với ít rắc rối nhất có thể.

**Bạn sẽ hoàn thành những gì**
Cài Hermes, xác minh lệnh hoạt động, cấu hình API, khởi động TUI và kết nối gateway WeChat nếu cần.

# Tổng Quan Các Cách Cài Đặt

| Tình huống | Cách khuyến nghị | Ghi chú |
|-|-|-|
| Máy tính có proxy / VPN | Cài đặt online | Dán trực tiếp lệnh cài đặt vào PowerShell. Đây thường là cách nhanh nhất. |
| Máy tính không có proxy / VPN | Gói offline | Tải gói cài đặt offline dựng sẵn và nhấp đúp vào script để triển khai. |

---

# Cách 1: Cài Đặt Online Khi Có Proxy / VPN

Nếu máy Windows của bạn có proxy / VPN thì nên dùng cách này trước. Ít bước hơn và cài nhanh hơn.

1. Sao chép lệnh cài đặt Windows vào PowerShell và chạy.
2. Hoặc chạy trực tiếp lệnh cài đặt sau:

```powershell
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDcyNmVhODFmODIyOTk5YjIwNDk2ZWVjNWQxOTI0YTVfOTkzMGFkNmRkNTlhZTQ5MTE3NDA4NjY2MWZlZTg5ODJfSUQ6NzYzOTcwODEwOTI3MTA1OTQyMl8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

Chờ quá trình cài đặt hoàn tất và làm theo hướng dẫn hiển thị.

---

# Cách 2: Dùng Gói Offline Khi Không Có Proxy / VPN

**Liên kết tải gói offline**
- Baidu Netdisk: [https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq](https://pan.baidu.com/s/1zG2dReq6SkMs-Fh7c5YUmA?pwd=f2uq) (mã: f2uq)
- Quark Drive: [https://pan.quark.cn/s/aee345d1864b](https://pan.quark.cn/s/aee345d1864b)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=MGE5NTRhYjZmNzhmYzljYTdmMjNhOTg1MzEyYTUyMDVfNzc4NWU0YTFjMTY5NDE3ZWNmZDBhNGRhNDI1Y2QwNjZfSUQ6NzYzOTcwODExMjExNjQ4NTA5M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

1. Tải về và giải nén gói cài đặt offline của Hermes.
2. Nhấp đúp vào `安装 hermes.cmd`. Gói này đã kèm source code mới nhất và các dependency cần thiết, vì vậy thông thường không cần cấu hình thêm.

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=OWJmYWFjNDVkZmY0ZGY1ODE4MjE0MDQxM2NlMjViMzNfYjk3NGJlMmM5NjVkNmRhMWEwNTc1NTNiODA5MjRhMzJfSUQ6NzYzOTcwODExMTk4OTIxNDE1M18xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=YWZhNTQ1MWQ1MzgwMGRmNDNkODA1MDljNmQ0YzQ0MTRfNGI3NmMyMzI2ZTg1YjNhYTIyNDZmNGVlNGE4NjI1ZTZfSUQ6NzYzOTcwODExNDMxNzAyMDA5Ml8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=NDY1MTdkYjYyODllYWU0ODVhMTkyZDA0ZTRmNjgyMGFfOGQ3ODI1NGVhYTc4MGU2OTBlYTdkOTQxN2Y0ODI0NjVfSUQ6NzYzOTcwODExODc3MTEwODgwOV8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

Quá trình cài đặt thường mất khoảng 2 đến 3 phút. Sau khi xong, nhấn phím bất kỳ để thoát.

---

# Kiểm Tra Việc Cài Đặt Có Thành Công Hay Không

1. Mở PowerShell hoặc CMD.
2. Chạy `hermes --version`.
3. Nếu terminal hiển thị số phiên bản, Hermes đã được cài thành công.

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=M2FlYzA1Y2FjY2M3NjFkYWVhNGIwY2FiZjkxMmE5YzRfZjZjMjhiZjRjZTcwNDA4OTIwZDJlNjZlOThjOTk3YzNfSUQ6NzYzOTcwODEyMjY0NjM2NzE4OF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)

---

# Cấu Hình Dịch Vụ Hermes API

**Lỗi dễ gặp nhất ở bước này là cách dán API Key.** Trong terminal Windows, đừng dùng `Ctrl + V`. Chỉ dùng chuột phải để dán một lần. Nhấp chuột phải nhiều lần có thể dán lặp và làm sai key.

1. Chạy `hermes model` để vào trình hướng dẫn cấu hình model.
2. Nếu bạn dùng nhà cung cấp tùy chỉnh, hãy chọn đúng số tương ứng. Trong tài liệu này, số được dùng là 36.

![](https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/authcode/?code=ODc0M2UyNTBkYjUyZTg3ZDk1ZjYyMDM3MGZhYmRmMzdfZGU3MjA4Yzc1MjFjNjE0M2JhZGQ3OWIyNjdhNGJiYWFfSUQ6NzYzOTcwODEyNDk1NzQ5NDIwMF8xNzc4NzYwNDY5OjE3Nzg3NjQwNjlfVjM)