← All applications · Connect apps section on /docs
Anthropic + OpenAIManual setup
Hermes Agent
Also known as: Nous Hermes · hermes
Tác tử Nous Research Hermes — cấu hình qua ~/.hermes/config.yaml và secrets trong ~/.hermes/.env.
Base URL to paste
Paste exactly one of two formats — wrong URL yields 404 (not 401).
https://vietrouter.com.vn/v1Prerequisites
- Đã cài Hermes Agent (`hermes`)
- API key Vietrouter
- Không dùng OAuth Anthropic Max nếu muốn tính phí qua Vietrouter
Recommended model: claude-fable-5
Quick way — command / config
# ~/.hermes/config.yaml
model:
default: "claude-fable-5"
provider: "custom"
base_url: "https://vietrouter.com.vn/v1"
api_key: "sk-mtm-..."
# Hoặc tách secret sang ~/.hermes/.env:
# OPENAI_API_KEY=sk-mtm-...Where to place file / fill Settings
Filemacos
~/.hermes/config.yaml
Provider custom + base_url OpenAI-compatible Vietrouter. Không commit api_key.
Filelinux
~/.hermes/config.yaml
Giống macOS.
Filewindows
%USERPROFILE%\.hermes\config.yaml
Tạo thư mục .hermes; secrets trong .hermes\.env.
Fileany
~/.hermes/.env
Chỉ chứa key/token. chmod 600 trên Unix.
Verify connection
- `hermes chat` một câu ngắn với model Vietrouter.
- Dashboard → Sử dụng.
Troubleshooting
| Symptom | Reason | How to handle |
|---|---|---|
| Vẫn gọi OpenRouter / Nous | provider còn auto/openrouter. | Đặt provider: custom (hoặc anthropic) và base_url Vietrouter. |
| 404 | base_url thiếu /v1 với provider OpenAI-compatible. | base_url: "https://vietrouter.com.vn/v1" |
Notes
- API CLI chưa có `api-cli configure hermes` — cấu hình tay theo trang này.
- Ưu tiên custom OpenAI-compatible hoặc anthropic + ANTHROPIC_BASE_URL; tránh OAuth Claude Max nếu muốn trừ ví Vietrouter.