Hermes, OpenClaw ve diğer AI ajanlarını bağlama

Hermes Agent, OpenClaw ve çoğu üçüncü taraf AI ajanı NordRouter'ı OpenAI-compatible sağlayıcı olarak kullanabilir. Ajan geliştiricisinden ayrı abonelik gerekmez; istekler gerçek kullanıma göre NordRouter bakiyesinden ücretlendirilir.

Bağlantı bilgileri

Alan	Değer
Rusya Base URL	https://nordrouter.com/v1
Rusya dışı veya VPN	https://global-api.nordrouter.com/v1
Avrupa sunucusu	https://europe-api.nordrouter.com/v1
API Key	paneldeki tam sk-nr-… anahtarı
Model ID	örneğin anthropic/claude-sonnet-4.6

Base URL sonunda /v1 kalmalıdır. Model kimliğini katalogdan eksiksiz kopyalayın.

Hermes Agent

Hermes Agent özel OpenAI-compatible endpoint kullanımını destekler.

Sihirbazla ayarlama

Aktif Hermes oturumundan çıkın ve çalıştırın:

hermes model

Custom endpoint (self-hosted / VLLM / etc.) seçeneğini seçip şunları girin:

• API base URL: https://nordrouter.com/v1
• API key: ek önek olmadan sk-nr-… anahtarınız
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Kaydettikten sonra yeni bir oturum açın. Sohbet içindeki /model yalnızca önceden tanımlanmış sağlayıcılar arasında geçiş yapar; yeni endpoint normal terminalde hermes model ile eklenir.

Elle ayarlama

~/.hermes/config.yaml içindeki model bloğunu güncelleyin:

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

Eski LLM_MODEL değişkenini kullanmayın; güncel Hermes için kaynak config.yaml dosyasıdır. auto olan auxiliary modeller ana modeli kullanır. Vision, compression veya subagents için açık bir override varsa ona da uyumlu endpoint girilmelidir.

OpenClaw

OpenClaw özel sağlayıcıları models.providers altında tanımlar.

1. Anahtarı ayrı saklayın

~/.openclaw/.env dosyasını oluşturun (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Anahtarı proje .env dosyasına koymayın ve Git'e göndermeyin.

2. Sağlayıcıyı ekleyin

Aşağıdaki nesneyi mevcut ~/.openclaw/openclaw.json ile birleştirin. Var olan kanal, araç ve ajan ayarlarını silmeyin:

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

Başka bir model için tam genel kimliğiyle models dizisine yeni bir nesne ekleyin.

3. Doğrulayın

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

CLI yeniden başlatma isterse openclaw gateway restart --safe çalıştırın. Tanılama için openclaw logs --follow kullanın.

Diğer AI ajanları

Uygulamada Custom provider, OpenAI Compatible, Custom OpenAI veya Chat Completions seçeneği varsa tablodaki Base URL, anahtar ve tam Model ID değerlerini girin. /chat/completions yolunu uygulama kendisi eklemelidir.

Uygulama yalnızca resmi OpenAI veya Anthropic hesabıyla girişe izin veriyor ve Base URL değiştirilemiyorsa NordRouter doğrudan bağlanamaz.

Özellikler ve güvenlik

Normal ve streaming yanıtlar, tool/function calling, sistem mesajları, uzun bağlam, uyumlu modellerde reasoning ve katalogda işaretli modellerde Vision çalışır. Özelliğin hem model hem istemci tarafından desteklenmesi gerekir.

Hermes ve OpenClaw komut çalıştırabilir ve dosya değiştirebilir. İlk testi sır içermeyen bir klasörde yapın, sandbox veya tehlikeli eylem onayını açın ve production sunucusuna erişim vermeyin.

Yaygın hatalar

Hata	Çözüm
401 Invalid API key	Tam anahtarı kullanın; sk-nr- bölümünü tekrarlamayın ve boşluk eklemeyin
/v1/v1/chat/completions	Yalnızca bir /v1 bırakın
No pricing available for model	/ öncesindeki bölüm dahil tam model kimliğini kullanın
Eski model kullanılmaya devam ediyor	Yeni oturum açın; OpenClaw içinde /model default çalıştırın
503 Service Unavailable	Başka model deneyin ve durumu kontrol edin

Önce hızlı başlangıçtaki en küçük istekle anahtarı doğrulayın. Resmi kaynaklar: Hermes providers ve OpenClaw providers.