اتصال 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 از endpoint سفارشی سازگار با OpenAI پشتیبانی می‌کند.

تنظیم با راهنما

از نشست فعال 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 در ترمینال افزوده می‌شود.

تنظیم دستی

بخش model در ~/.hermes/config.yaml را به‌روزرسانی کنید:

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 از مدل اصلی استفاده می‌کنند؛ override جداگانه برای vision، compression یا subagents نیز به endpoint سازگار نیاز دارد.

OpenClaw

OpenClaw ارائه‌دهندهٔ سفارشی را از طریق models.providers اضافه می‌کند.

۱. کلید را جداگانه نگه دارید

فایل ~/.openclaw/.env را بسازید؛ در Windows مسیر %USERPROFILE%\.openclaw\.env است:

dotenv

NORDROUTER_API_KEY=sk-nr-YOUR-KEY

کلید را در .env پروژه قرار ندهید و آن را به Git نفرستید.

۲. ارائه‌دهنده را اضافه کنید

این شیء را با ~/.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
          }
        ]
      }
    }
  }
}

برای مدل دیگر، شیء تازه‌ای با شناسهٔ عمومی کامل آن به models بیفزایید.

۳. اعتبارسنجی کنید

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 استفاده کنید.

دیگر عامل‌های هوش مصنوعی

اگر برنامه گزینهٔ 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.

اتصال Hermes، OpenClaw و دیگر عامل‌های هوش مصنوعی ​

اطلاعات اتصال ​

Hermes Agent ​

تنظیم با راهنما ​

تنظیم دستی ​

OpenClaw ​

۱. کلید را جداگانه نگه دارید ​

۲. ارائه‌دهنده را اضافه کنید ​

۳. اعتبارسنجی کنید ​

دیگر عامل‌های هوش مصنوعی ​

قابلیت‌ها و امنیت ​

خطاهای رایج ​