استخدام Muapi مع OpenClaw

اربط OpenClaw بـ Muapi كمزوّد مخصص متوافق مع OpenAI لاستخدام النماذج النصية في الوكلاء والقنوات المتصلة.

1. أنشئ مفتاحًا واختر نموذجًا

أنشئ مفتاح API من لوحة تحكم Muapi واعرض النماذج النصية:

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

اختر نموذجًا يتضمن capabilities.tools: true كي يتمكن OpenClaw من استخدام الأدوات.

2. إعداد المزوّد المخصص

عيّن MUAPI_API_KEY في بيئة تشغيل بوابة OpenClaw. أضف المزوّد والنموذج الافتراضي إلى الإعداد، عادةً ~/.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 كخدمة، فوفّر المتغير في بيئة الخدمة.

3. شغّل OpenClaw وتحقق من النموذج

openclaw models list
openclaw tui

اختبر مهمة صغيرة تستخدم أداة، مثل تلخيص ملف في مساحة العمل. اربط قنوات المراسلة بعد التأكد من عمل النموذج في الطرفية.

استكشاف الأخطاء وإصلاحها

• إذا لم يظهر النموذج، فتحقق من معرّف المزوّد والنموذج وصياغة JSON5.
• عند فشل المصادقة، تأكد من قدرة عملية البوابة على قراءة MUAPI_API_KEY.
• إذا لم يستخدم النموذج الأدوات، فاختر نموذجًا يدعم capabilities.tools: true.
• ابدأ بمهمة صغيرة وراقب الاستخدام في لوحة Muapi.

راجع توثيق المزوّدات المخصصة في OpenClaw ودليل إعداد النماذج.