Kết nối Hermes, OpenClaw và các tác nhân AI khác

Hermes Agent, OpenClaw và phần lớn tác nhân bên thứ ba có thể dùng NordRouter như nhà cung cấp OpenAI-compatible. Bạn không cần mua gói riêng của nhà phát triển tác nhân; yêu cầu được trừ từ số dư NordRouter theo mức sử dụng thực tế.

Thông tin kết nối

Trường	Giá trị
Base URL tại Nga	https://nordrouter.com/v1
Ngoài Nga hoặc qua VPN	https://global-api.nordrouter.com/v1
Máy chủ châu Âu	https://europe-api.nordrouter.com/v1
API Key	khóa đầy đủ sk-nr-… trong bảng điều khiển
Model ID	ví dụ anthropic/claude-sonnet-4.6

Giữ /v1 ở cuối Base URL và sao chép đầy đủ ID từ danh mục.

Hermes Agent

Hermes Agent hỗ trợ endpoint OpenAI-compatible tùy chỉnh.

Thiết lập bằng trình hướng dẫn

Thoát phiên Hermes đang mở và chạy:

hermes model

Chọn Custom endpoint (self-hosted / VLLM / etc.) rồi nhập:

• API base URL: https://nordrouter.com/v1
• API key: khóa sk-nr-… của bạn, không thêm tiền tố
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Mở phiên mới sau khi lưu. /model bên trong cuộc trò chuyện chỉ chuyển giữa các nhà cung cấp đã cấu hình; endpoint mới phải được thêm bằng hermes model trong terminal.

Thiết lập thủ công

Cập nhật khối model trong ~/.hermes/config.yaml:

model:
  default: anthropic/claude-sonnet-4.6
  provider: custom
  base_url: https://nordrouter.com/v1
  api_key: sk-nr-YOUR-KEY
  context_length: 1000000

Không dùng biến cũ LLM_MODEL: Hermes hiện dùng config.yaml làm nguồn cấu hình. Các mô hình auxiliary đặt là auto dùng mô hình chính; override riêng cho vision, compression hoặc subagents cũng cần endpoint tương thích.

OpenClaw

OpenClaw thêm nhà cung cấp tùy chỉnh qua models.providers.

1. Lưu khóa riêng

Tạo ~/.openclaw/.env (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Không đặt khóa trong .env của dự án và không commit lên Git.

2. Thêm nhà cung cấp

Hợp nhất đối tượng sau vào ~/.openclaw/openclaw.json hiện có. Không ghi đè kênh, công cụ hay tác nhân đã thiết lập:

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "nordrouter/anthropic/claude-sonnet-4.6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "nordrouter": {
        "baseUrl": "https://nordrouter.com/v1",
        "apiKey": "${NORDROUTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.6",
            "name": "Claude Sonnet 4.6 via NordRouter",
            "contextWindow": 1000000
          }
        ]
      }
    }
  }
}

Để dùng mô hình khác, thêm một đối tượng có ID công khai đầy đủ vào models.

3. Xác thực

openclaw config validate
openclaw models list --provider nordrouter
openclaw models set nordrouter/anthropic/claude-sonnet-4.6

Nếu CLI yêu cầu khởi động lại, chạy openclaw gateway restart --safe. Dùng openclaw logs --follow để chẩn đoán.

Các tác nhân AI khác

Nếu ứng dụng có Custom provider, OpenAI Compatible, Custom OpenAI hoặc Chat Completions, hãy nhập Base URL, khóa và Model ID đầy đủ trong bảng. Ứng dụng phải tự thêm /chat/completions.

Nếu ứng dụng chỉ cho đăng nhập bằng tài khoản OpenAI hoặc Anthropic chính thức và không cho đổi Base URL, ứng dụng không thể kết nối trực tiếp với NordRouter.

Tính năng và an toàn

Hỗ trợ phản hồi thường và streaming, tool/function calling, thông báo hệ thống, ngữ cảnh dài, reasoning trên mô hình tương thích và Vision trên mô hình được đánh dấu trong danh mục. Cả mô hình và ứng dụng đều phải hỗ trợ tính năng.

Hermes và OpenClaw có thể chạy lệnh và sửa tệp. Hãy thử lần đầu trong thư mục không có bí mật, bật sandbox hoặc xác nhận hành động nguy hiểm và không cấp quyền vào máy chủ production.

Lỗi thường gặp

Lỗi	Cách xử lý
401 Invalid API key	Dùng khóa đầy đủ, không lặp sk-nr- và không có khoảng trắng
/v1/v1/chat/completions	Chỉ giữ một /v1
No pricing available for model	Dùng ID đầy đủ, bao gồm phần trước /
Vẫn dùng mô hình cũ	Mở phiên mới; trong OpenClaw chạy /model default
503 Service Unavailable	Thử mô hình khác và xem trạng thái

Trước tiên hãy kiểm tra khóa bằng yêu cầu tối thiểu trong bắt đầu nhanh. Nguồn chính thức: Hermes providers và OpenClaw providers.