Hermes, OpenClaw 및 기타 AI 에이전트 연결

Hermes Agent, OpenClaw 및 대부분의 타사 AI 에이전트는 NordRouter를 OpenAI-compatible 공급자로 사용할 수 있습니다. 에이전트 개발자의 별도 구독은 필요하지 않으며 실제 사용량에 따라 NordRouter 잔액에서 과금됩니다.

연결 정보

필드	값
러시아 Base URL	`https://nordrouter.com/v1`
러시아 외부 또는 VPN 사용	`https://global-api.nordrouter.com/v1`
유럽 서버	`https://europe-api.nordrouter.com/v1`
API Key	대시보드의 전체 `sk-nr-…` 키
Model ID	예: `anthropic/claude-sonnet-4.6`

Base URL 끝에 /v1을 유지하고 모델 카탈로그에서 전체 ID를 복사하세요.

Hermes Agent

Hermes Agent는 사용자 지정 OpenAI-compatible endpoint를 지원합니다.

마법사로 설정

현재 Hermes 세션을 종료하고 실행합니다.

bash

hermes model

**Custom endpoint (self-hosted / VLLM / etc.)**를 선택하고 다음을 입력합니다.

API base URL: https://nordrouter.com/v1
API key: 추가 접두사 없는 sk-nr-… 키
Model name: anthropic/claude-sonnet-4.6
Context window: 1000000

저장한 뒤 새 세션을 시작하세요. 채팅 안의 /model은 이미 설정된 공급자만 전환합니다. 새 endpoint는 터미널에서 hermes model로 추가해야 합니다.

수동 설정

~/.hermes/config.yaml의 model 블록을 수정합니다.

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

이전 LLM_MODEL 변수는 사용하지 마세요. 최신 Hermes는 config.yaml을 설정 원본으로 사용합니다. auto인 auxiliary 모델은 주 모델을 사용하며 vision, compression 또는 subagents를 별도로 지정했다면 해당 항목에도 호환 endpoint가 필요합니다.

OpenClaw

OpenClaw는 models.providers를 통해 사용자 지정 공급자를 추가합니다.

1. 키를 별도로 저장

~/.openclaw/.env를 만드세요. Windows에서는 %USERPROFILE%\.openclaw\.env입니다.

dotenv

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

키를 프로젝트 .env에 넣거나 Git에 커밋하지 마세요.

2. 공급자 추가

아래 객체를 기존 ~/.openclaw/openclaw.json에 병합합니다. 기존 채널, 도구 또는 에이전트 설정을 덮어쓰지 마세요.

json

{
  "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
          }
        ]
      }
    }
  }
}

다른 모델을 사용하려면 전체 공개 ID를 가진 객체를 models에 추가합니다.

3. 검증

bash

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

CLI가 재시작을 요구하면 openclaw gateway restart --safe를 실행하세요. 진단에는 openclaw logs --follow를 사용합니다.

기타 AI 에이전트

앱에 Custom provider, OpenAI Compatible, Custom OpenAI 또는 Chat Completions 옵션이 있다면 표의 Base URL, 키, 전체 Model ID를 입력하세요. /chat/completions는 앱이 직접 추가해야 합니다.

공식 OpenAI 또는 Anthropic 계정 로그인만 지원하고 Base URL을 바꿀 수 없는 앱은 NordRouter에 직접 연결할 수 없습니다.

기능과 보안

일반 및 streaming 응답, tool/function calling, 시스템 메시지, 긴 컨텍스트, 호환 모델의 reasoning, 카탈로그에 표시된 모델의 Vision을 지원합니다. 기능은 모델과 클라이언트 양쪽에서 지원되어야 합니다.

Hermes와 OpenClaw는 명령을 실행하고 파일을 수정할 수 있습니다. 첫 테스트는 비밀 정보가 없는 폴더에서 진행하고 sandbox 또는 위험 작업 승인을 켜며 production 서버 접근 권한을 주지 마세요.

자주 발생하는 오류

오류	해결 방법
`401 Invalid API key`	`sk-nr-` 중복과 공백 없이 전체 키를 사용
`/v1/v1/chat/completions`	`/v1`을 정확히 하나만 유지
`No pricing available for model`	`/` 앞부분을 포함한 전체 모델 ID를 사용
이전 모델이 계속 사용됨	새 세션을 열고 OpenClaw에서 `/model default` 실행
`503 Service Unavailable`	다른 모델을 시도하고 상태 확인

먼저 빠른 시작의 최소 요청으로 키를 확인하세요. 공식 자료: Hermes providers, OpenClaw providers.

Hermes, OpenClaw 및 기타 AI 에이전트 연결 ​

연결 정보 ​

Hermes Agent ​

마법사로 설정 ​

수동 설정 ​

OpenClaw ​

1. 키를 별도로 저장 ​

2. 공급자 추가 ​

3. 검증 ​

기타 AI 에이전트 ​

기능과 보안 ​

자주 발생하는 오류 ​