اتصال OpenClaw به چابکان

OpenClaw دستیار قابل اجرا روی سیستم شماست که مدل، ابزارها و کانال‌های ارتباطی را به یکدیگر متصل می‌کند. چابکان را می‌توانید به‌عنوان provider سفارشی مدل تعریف کنید.

نصب و پیش‌نیاز

آماده‌سازی سرویس چابکان را انجام دهید و برای عامل، مدلی با ابزارخوانی انتخاب کنید. سپس نصب و راه‌اندازی اولیهٔ OpenClaw را طبق راهنمای رسمی نصب انجام دهید؛ نسخهٔ Node.js و روش نصب را از همان راهنما بردارید.

برای تنظیم اولیه، openclaw onboard در دسترس است. پیش از تغییر فایل، تنظیمات فعلی را نگه دارید و نمونهٔ زیر را با آن ادغام کنید. راهنمای پیکربندی

تعریف provider

کلید را در محیط ترمینالی که OpenClaw را اجرا می‌کند قرار دهید:

export CHABOKAN_AI_API_KEY='sk-chbk-REPLACE_WITH_YOUR_KEY'

در Windows PowerShell:

$env:CHABOKAN_AI_API_KEY = "sk-chbk-REPLACE_WITH_YOUR_KEY"

در ~/.openclaw/openclaw.json، بخش‌های زیر را اضافه کنید و YOUR_MODEL_ID را در هر دو محل جایگزین کنید:

{
  "models": {
    "mode": "merge",
    "providers": {
      "chabokan": {
        "baseUrl": "https://ai.chabokan.net/v1",
        "apiKey": "${CHABOKAN_AI_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "YOUR_MODEL_ID", "name": "Chabokan model" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "chabokan/YOUR_MODEL_ID" }
    }
  }
}

نام openai-completions در تنظیم OpenClaw برای مسیر سازگار با Chat Completions است. نام کامل انتخاب مدل، chabokan/ به‌اضافهٔ Model ID است؛ اگر خود Model ID اسلش دارد آن را حفظ کنید. ساختار provider در راهنمای رسمی providerهای سفارشی آمده است.

اگر Gateway را به‌صورت سرویس پس‌زمینه اجرا می‌کنید، متغیر کلید باید در محیط همان سرویس هم موجود باشد؛ تنظیم متغیر در یک ترمینال دیگر کافی نیست.

بررسی اتصال

openclaw models list --provider chabokan
openclaw models status

این خروجی برای بررسی تنظیم و مدل است و به‌تنهایی پاسخ موفق API را تضمین نمی‌کند. پس از اجرای Gateway، با openclaw dashboard رابط آن را باز کنید و یک پیام کوتاه بفرستید. فرمان‌های بررسی مدل در مرجع CLI و راه‌اندازی رابط در شروع سریع مستند شده‌اند.

پاسخ و مدل استفاده‌شده را در لاگ درخواست‌های چابکان بررسی کنید. سپس خواندن یک فایل آزمایشی را با مجوز مناسب امتحان کنید؛ افزودن کانال پیام‌رسان برای این آزمون لازم نیست.

خطاهای رایج

• مدل ناشناخته: نام provider، پیشوند chabokan/ و Model ID را بررسی کنید.
• کلید پیدا نمی‌شود: محیط پردازش Gateway یا سرویس پس‌زمینه را بررسی کنید.
• 400 هنگام درخواست: پارامترهای ارسال‌شده و قابلیت مدل را بررسی کنید؛ ابزارخوانی یا reasoning برای همهٔ مدل‌ها یکسان نیست.
• پیکربندی نامعتبر: با openclaw doctor علت را بخوانید؛ نمونه را جایگزین کامل تنظیمات کانال‌ها و سایر بخش‌ها نکنید.

مجوز ابزارها و اتصال افراد به Gateway را در OpenClaw مدیریت کنید. برای بررسی عمومی اتصال، عیب‌یابی AI را ببینید.