OpenClaw با Muapi

Muapi را به‌عنوان provider سفارشی سازگار با OpenAI به OpenClaw وصل کنید تا agentها و کانال‌های متصل از مدل‌های متنی Muapi استفاده کنند.

۱. ساخت کلید و انتخاب مدل

در داشبورد Muapi کلید بسازید و مدل‌های متنی را فهرست کنید:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

برای استفاده OpenClaw از ابزارها، مدلی با capabilities.tools: true انتخاب کنید.

۲. پیکربندی provider سفارشی

MUAPI_API_KEY را در محیط اجرای OpenClaw gateway تنظیم کنید. provider و مدل پیش‌فرض را معمولاً در ~/.openclaw/openclaw.json اضافه کنید:

{
  models: {
    mode: "merge",
    providers: {
      muapi: {
        baseUrl: "https://api.muapi.ai/v1",
        apiKey: "${MUAPI_API_KEY}",
        api: "openai-completions",
        models: [{ id: "YOUR_MODEL_ID", name: "Muapi text model" }],
      },
    },
  },
  agents: { defaults: { model: { primary: "muapi/YOUR_MODEL_ID" } } },
}

هر دو YOUR_MODEL_ID را با شناسه دقیق Muapi جایگزین کنید. کلید را در فایل مشترک پروژه قرار ندهید. اگر OpenClaw سرویس است، متغیر را در محیط سرویس در دسترس بگذارید.

۳. اجرای OpenClaw و بررسی مدل

openclaw models list
openclaw tui

یک کار کوچک مبتنی بر ابزار، مانند خلاصه‌کردن فایل workspace را امتحان کنید. پس از کارکرد مدل در terminal، کانال‌های پیام‌رسان را وصل کنید.

عیب‌یابی

  • اگر مدل دیده نمی‌شود، شناسه provider و مدل و syntax ‏JSON5 را بررسی کنید.
  • برای خطای احراز هویت، مطمئن شوید gateway به MUAPI_API_KEY دسترسی دارد.
  • اگر ابزارها اجرا نمی‌شوند، مدلی با capabilities.tools: true انتخاب کنید.
  • با کار کوچک شروع کنید و مصرف را در داشبورد Muapi ببینید.

راهنمای provider سفارشی OpenClaw و پیکربندی مدل را ببینید.