Menghubungkan Hermes, OpenClaw, dan agen AI lainnya

Hermes Agent, OpenClaw, dan sebagian besar agen pihak ketiga dapat memakai NordRouter sebagai penyedia OpenAI-compatible. Anda tidak memerlukan langganan terpisah dari pengembang agen; permintaan dibebankan ke saldo NordRouter sesuai pemakaian nyata.

Data koneksi

Kolom	Nilai
Base URL di Rusia	https://nordrouter.com/v1
Di luar Rusia atau melalui VPN	https://global-api.nordrouter.com/v1
Server Eropa	https://europe-api.nordrouter.com/v1
API Key	kunci lengkap sk-nr-… dari dasbor
Model ID	misalnya anthropic/claude-sonnet-4.6

Pertahankan /v1 di akhir Base URL dan salin ID lengkap dari katalog.

Hermes Agent

Hermes Agent mendukung endpoint OpenAI-compatible khusus.

Pengaturan dengan wizard

Keluar dari sesi Hermes yang aktif lalu jalankan:

hermes model

Pilih Custom endpoint (self-hosted / VLLM / etc.) dan isi:

• API base URL: https://nordrouter.com/v1
• API key: kunci sk-nr-… Anda tanpa awalan tambahan
• Model name: anthropic/claude-sonnet-4.6
• Context window: 1000000

Mulai sesi baru setelah menyimpan. /model di dalam chat hanya berpindah antara penyedia yang sudah dikonfigurasi; tambahkan endpoint baru dengan hermes model di terminal.

Pengaturan manual

Perbarui blok model di ~/.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

Jangan gunakan variabel lama LLM_MODEL: Hermes saat ini memakai config.yaml sebagai sumber konfigurasi. Model auxiliary dengan auto memakai model utama; override khusus untuk vision, compression, atau subagents juga memerlukan endpoint yang kompatibel.

OpenClaw

OpenClaw menambahkan penyedia khusus melalui models.providers.

1. Simpan kunci secara terpisah

Buat ~/.openclaw/.env (Windows: %USERPROFILE%\.openclaw\.env):

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

Jangan simpan kunci di .env proyek dan jangan commit ke Git.

2. Tambahkan penyedia

Gabungkan objek berikut dengan ~/.openclaw/openclaw.json yang ada. Jangan menimpa channel, tool, atau agen yang sudah dikonfigurasi:

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

Untuk model lain, tambahkan objek dengan ID publik lengkap ke dalam models.

3. Validasi

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

Jika CLI meminta restart, jalankan openclaw gateway restart --safe. Gunakan openclaw logs --follow untuk diagnosis.

Agen AI lainnya

Jika aplikasi menawarkan Custom provider, OpenAI Compatible, Custom OpenAI, atau Chat Completions, masukkan Base URL, kunci, dan Model ID lengkap dari tabel. Aplikasi harus menambahkan /chat/completions secara otomatis.

Jika aplikasi hanya menerima login akun resmi OpenAI atau Anthropic dan tidak mengizinkan perubahan Base URL, aplikasi tersebut tidak dapat terhubung langsung ke NordRouter.

Fitur dan keamanan

Respons biasa dan streaming, tool/function calling, pesan sistem, konteks panjang, reasoning pada model yang kompatibel, dan Vision pada model yang ditandai di katalog didukung. Fitur harus didukung oleh model dan klien.

Hermes dan OpenClaw dapat menjalankan perintah serta mengubah file. Lakukan uji pertama di folder tanpa rahasia, aktifkan sandbox atau persetujuan tindakan berbahaya, dan jangan berikan akses ke server production.

Kesalahan umum

Kesalahan	Solusi
401 Invalid API key	Gunakan kunci lengkap tanpa mengulang sk-nr- atau menambah spasi
/v1/v1/chat/completions	Sisakan tepat satu /v1
No pricing available for model	Gunakan ID lengkap termasuk bagian sebelum /
Model lama masih aktif	Buka sesi baru; di OpenClaw jalankan /model default
503 Service Unavailable	Coba model lain dan periksa status

Validasi kunci terlebih dahulu dengan permintaan minimal di mulai cepat. Sumber resmi: Hermes providers dan OpenClaw providers.