Yadak AI Gateway پورتال توسعه‌دهندگان

۱. قبل از شروع

سه چیز لازم دارید: آدرس درگاه، کلید شخصی، و لیست مدل‌های مجاز کلیدتان.

۲. Endpointهای درگاه (تست‌شده)

این درگاه چند protocol مختلف را هم‌زمان ارائه می‌دهد؛ هر ابزاری با یکی از این‌ها صحبت می‌کند.

۳. Cursor محدودیت شبکه دارد

Cursor تنها ابزاری است که درخواست را از سرورهای خود Cursor می‌فرستد، نه از ماشین شما.

رویه تنظیم (وقتی آدرس عمومی در دسترس بود)

• مسیر: Cursor Settings → Models → API Keys
• کلید را در فیلد OpenAI API Key بگذارید
• گزینه Override OpenAI Base URL را روشن کنید
• مدل دلخواه را با + Add Custom Model اضافه کنید (نام دقیق مدل درگاه، مثل gpt-4o)

Override OpenAI Base URL : https://<دامنه-عمومی-درگاه>/cursor
OpenAI API Key           : sk-<کلید-شخصی-شما>
Add Custom Model         : gpt-4o

نکته: نسخه درگاه 1.106.2 است، پس مسیر /cursor و GET /cursor/models فعال است (تأیید شد). اگر خطای نام تکراری دیدید، نام مدل با مدل داخلی Cursor برخورد کرده — نام دیگری انتخاب کنید. تب Tab همیشه با مدل‌های خود Cursor کار می‌کند و قابل تغییر نیست.

۴. Cline (VS Code) روی LAN کار می‌کند

Cline مستقیم از VS Code شما درخواست می‌فرستد؛ پس آدرس داخلی LAN بدون مشکل کار می‌کند.

• پنل Cline → آیکون تنظیمات
• API Provider را روی OpenAI Compatible بگذارید
• فیلدها را پر کنید و دکمه Verify را بزنید

Cline فقط /v1/chat/completions را صدا می‌زند (نه /v1/responses و نه /v1/messages). مدل‌های wildcard با پیشوند openai/ هم مجازند، مثلاً openai/gpt-4.1.

۵. Claude Code پروتکل Anthropic تست شد

Claude Code با فرمت Anthropic (/v1/messages) صحبت می‌کند و درگاه این فرمت را به مدل‌های OpenAI ترجمه می‌کند. به همین دلیل آدرس را بدون /v1 می‌دهند.

macOS / Linux / WSL (bash)

export ANTHROPIC_BASE_URL="http://localhost:4000"
export ANTHROPIC_AUTH_TOKEN="sk-<کلید-شخصی>"
export ANTHROPIC_MODEL="gpt-4o"
unset ANTHROPIC_API_KEY

claude

ویندوز (PowerShell)

$env:ANTHROPIC_BASE_URL  = "http://localhost:4000"
$env:ANTHROPIC_AUTH_TOKEN = "sk-<کلید-شخصی>"
$env:ANTHROPIC_MODEL      = "gpt-4o"
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue

claude

دائمی‌کردن تنظیمات (همه پلتفرم‌ها)

در فایل ~/.claude/settings.json (ویندوز: %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:4000",
    "ANTHROPIC_AUTH_TOKEN": "sk-<کلید-شخصی>",
    "ANTHROPIC_MODEL": "gpt-4o",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-4o-mini",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

• ANTHROPIC_AUTH_TOKEN با هدر Authorization: Bearer فرستاده می‌شود؛ ANTHROPIC_API_KEY با x-api-key. یکی را استفاده کنید و آن یکی را unset کنید.
• انتخاب‌گر مدل داخل جلسه (/model) هنوز شناسه‌های Anthropic را نشان می‌دهد؛ اگر آن‌ها را در درگاه تعریف نکرده باشید خطای Invalid model name passed in می‌گیرید. پس بهتر است مدل را با ANTHROPIC_MODEL ثابت کنید.
• ANTHROPIC_SMALL_FAST_MODEL منسوخ شده؛ جایش ANTHROPIC_DEFAULT_HAIKU_MODEL را بگذارید.

۶. OpenAI Codex CLI /v1/responses تست شد

کدکس در نسخه‌های جدید فقط پروتکل responses را پشتیبانی می‌کند (گزینه wire_api = "chat" حذف شده). درگاه ما /v1/responses را ارائه می‌دهد — تأیید شد.

فایل پیکربندی

مسیر: ~/.codex/config.toml (ویندوز: %USERPROFILE%\.codex\config.toml)

model          = "gpt-4o"
model_provider = "yadak"

[model_providers.yadak]
name      = "Yadak AI Gateway"
base_url  = "http://localhost:4000/v1"
env_key   = "YADAK_API_KEY"
wire_api  = "responses"

ست کردن کلید

export YADAK_API_KEY="sk-<کلید-شخصی>"
codex "یک تابع بزن که فایل لاگ را بچرخاند"

# برای همین جلسه:
$env:YADAK_API_KEY = "sk-<کلید-شخصی>"

# برای همه جلسات آینده (یک‌بار):
setx YADAK_API_KEY "sk-<کلید-شخصی>"

codex "باگ را در main.py پیدا کن"

کلید در فایل TOML ذخیره نمی‌شود؛ کدکس آن را از متغیر محیطی خوانده‌شده در env_key می‌گیرد — امن‌تر است.

۷. Hermes Agent طبق مستندات سازنده

Hermes Agent (project: NousResearch/hermes-agent) یک ایجنت self-hosted با CLI و gateway چت است. تنظیمات غیرمحرمانه در ~/.hermes/config.yaml و کلیدها در ~/.hermes/.env.

providers:
  yadak:
    api: http://localhost:4000/v1   # Hermes خودش /chat/completions را اضافه می‌کند
    transport: chat_completions
    key_env: YADAK_API_KEY

model:
  default: gpt-4o
  provider: custom:yadak

YADAK_API_KEY=sk-<کلید-شخصی>

• راه جایگزین: دستور hermes model و انتخاب Custom endpoint.
• OPENAI_BASE_URL فقط برای provider با نام openai-api اعتبار دارد؛ برای provider سفارشی از همان بلوک بالا استفاده کنید.
• متغیر قدیمی LLM_MODEL حذف شده است.

۸. OpenClaw طبق مستندات سازنده

OpenClaw یک ایجنت/assistant self-hosted است که چت (WhatsApp/Telegram/Discord) را به مدل‌ها وصل می‌کند. تنظیمات در فایل JSON5 به مسیر ~/.openclaw/openclaw.json (hot-reload می‌شود).

{
  models: {
    providers: {
      yadak: {
        baseUrl: "http://localhost:4000/v1",
        apiKey:  "${YADAK_API_KEY}",
        api:     "openai-completions",
        models: [
          { id: "gpt-4o",     name: "GPT-4o (Yadak)" },
          { id: "gpt-4o-mini", name: "GPT-4o mini (Yadak)" }
        ]
      }
    }
  },
  agents: {
    defaults: { model: { primary: "yadak/gpt-4o" } }
  }
}

openclaw onboard --auth-choice litellm-api-key \
  --litellm-api-key "$YADAK_API_KEY" \
  --custom-base-url "http://localhost:4000/v1"

openclaw models set litellm/gpt-4o
openclaw models list --provider yadak --refresh --json   # صحت اتصال را نشان می‌دهد

نام مدل‌ها در OpenClaw با پیشوند provider صدا زده می‌شود (yadak/gpt-4o)؛ شناسه بعد از / باید دقیقاً همان model_name درگاه باشد.

۹. مدل‌ها و نکته‌های مهم

۱۰. معنی خطاها

۱۱. عیب‌یابی سریع

curl http://localhost:4000/v1/chat/completions \
  -H "Authorization: Bearer sk-<کلید-شخصی>" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o-mini","messages":[{"role":"user","content":"say OK"}],"max_tokens":5}'

curl -s http://localhost:4000/v1/models \
  -H "Authorization: Bearer sk-<کلید-شخصی>" | python -c "import sys,json;print('\n'.join(m['id'] for m in json.load(sys.stdin)['data']))"