توصيل Hermes وOpenClaw ووكلاء الذكاء الاصطناعي الآخرين

يمكن توصيل Hermes Agent وOpenClaw ومعظم الوكلاء من الجهات الخارجية بـ NordRouter كمزوّد متوافق مع OpenAI. لا تحتاج إلى اشتراك منفصل لدى مطوّر الوكيل؛ تُخصم تكلفة الطلبات من رصيد 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

احتفظ بـ /v1 في نهاية Base URL وانسخ معرّف النموذج كاملاً من الدليل.

Hermes Agent

يدعم Hermes Agent نقاط نهاية OpenAI-compatible المخصصة.

الإعداد بواسطة المعالج

اخرج من جلسة Hermes الحالية ثم نفّذ:

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 في الطرفية.

الإعداد اليدوي

حدّث قسم model في ~/.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

لا تستخدم المتغير القديم LLM_MODEL؛ تعتمد إصدارات Hermes الحديثة على config.yaml. تستخدم نماذج auxiliary ذات القيمة auto النموذج الرئيسي، أما إعدادات vision أو compression أو subagents الصريحة فتحتاج أيضاً إلى endpoint متوافق.

OpenClaw

يضيف OpenClaw المزوّدين المخصصين عبر models.providers.

1. خزّن المفتاح بصورة منفصلة

أنشئ ~/.openclaw/.env، وفي Windows استخدم %USERPROFILE%\.openclaw\.env:

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

لا تضع المفتاح في ملف .env خاص بمشروع ولا ترفعه إلى Git.

2. أضف المزوّد

ادمج هذا الكائن مع ~/.openclaw/openclaw.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
          }
        ]
      }
    }
  }
}

لنموذج آخر، أضف كائناً إلى models يحمل معرّفه العام الكامل.

3. تحقّق

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 للتشخيص.

وكلاء الذكاء الاصطناعي الآخرون

إذا كان التطبيق يوفّر 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	استخدم المعرّف الكامل بما في ذلك الجزء السابق لـ /
ما زال النموذج القديم مستخدماً	افتح جلسة جديدة؛ في OpenClaw نفّذ /model default
503 Service Unavailable	جرّب نموذجاً آخر وتحقق من الحالة

تحقق أولاً من المفتاح بالطلب الصغير في البدء السريع. المصادر الرسمية: Hermes providers وOpenClaw providers.