الانتقال إلى المحتوى الرئيسي
هذا الدليل مخصّص لمستخدمي OpenClaw المستضاف محليًا (self-hosted) الذين يرغبون في ربط AI Sonar كمزوِّد AI خاص بهم.

​
نظرة عامة

للإصدارات الحالية من OpenClaw، النهج الموصى به هو تكوين AI Sonar عبر models.providers. إذا كنت ترغب فقط في البدء بسرعة، فتكفي تكوين aisonar بمفردها. أضف الموفرين الآخرين فقط عندما تحتاج صراحةً إلى سلوك Responses API أو Claude native أو Gemini native أو MiniMax native.
المزوّدOpenClaw apiالأفضل لـbaseUrl
aisonaropenai-completionsGPT وDeepSeek وQwen ومعظم الاستدعاءات المتوافقة مع OpenAIhttps://api.aisonar.dev/v1
aisonar-responsesopenai-responsesتدفقات عمل OpenAI Responses التي تتوقع دلالات /v1/responseshttps://api.aisonar.dev/v1
aisonar-claudeanthropic-messagesواجهة Claude Messages الأصليةhttps://api.aisonar.dev
aisonar-geminigoogle-generative-aiصيغة Gemini الأصليةhttps://api.aisonar.dev
aisonar-minimaxanthropic-messagesتوجيه MiniMax الأصليhttps://api.aisonar.dev
استخدم اللاحقة /v1 فقط مع openai-completions وopenai-responses.يجب أن تستخدم الموفرات الأصلية مثل anthropic-messages وgoogle-generative-ai https://api.aisonar.dev بدون /v1، وإلا فقد ينشئ OpenClaw مسارًا علويًا غير صحيح.

​
المتطلبات المسبقة

  • مثيل OpenClaw مستضاف محليًا (self-hosted)
  • مفتاح API من AI Sonar — Get one here

​
التكوين

حرّر تهيئة OpenClaw الخاصة بك:
  • مستضاف ذاتيًا: ~/.openclaw/openclaw.json
أضف موفري AI Sonar تحت models.providers: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      aisonar: {
        api: "openai-completions",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "aisonar-responses": {
        api: "openai-responses",
        baseUrl: "https://api.aisonar.dev/v1",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "aisonar-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "aisonar-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "aisonar-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.aisonar.dev",
        apiKey: "sk-your-api-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
جميع الموفرين الخمسة يستخدمون نفس مفتاح API. تحتاج لحساب AI Sonar واحد فقط.
قوائم models أعلاه تعرض أمثلة شائعة فقط. أضف المزيد من معرفات النماذج لكل موفر حسب الحاجة.

​
استخدام النماذج

لا يزال OpenClaw يشير إلى النماذج بصيغة provider/model: 
{
  agents: {
    defaults: {
      model: {
        primary: "aisonar-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
أمثلة على النماذج

المزوّدمرجع النموذجالوصف
aisonaraisonar/gpt-4oمسار متوافق مع OpenAI
aisonaraisonar/deepseek-r1نموذج استدلال DeepSeek
aisonar-responsesaisonar-responses/gpt-4oمسار Responses API
aisonar-claudeaisonar-claude/claude-sonnet-4-6مسار Claude Messages الأصلي
aisonar-geminiaisonar-gemini/gemini-2.5-flashمسار Gemini الأصلي
aisonar-minimaxaisonar-minimax/minimax-m1مسار MiniMax الأصلي
تصفّح جميع النماذج المتاحة على aisonar.dev/models.

​
متى تستخدم أي موفر

  • aisonar: الخيار الافتراضي لمعظم حالات استخدام الوكلاء والدردشة العامة.
  • aisonar-responses: استخدمه عندما يعتمد سير عمل OpenClaw صراحةً على دلالات OpenAI Responses.
  • aisonar-claude: استخدمه عندما تريد سلوك Messages الأصلي الخاص بـ Claude.
  • aisonar-gemini: استخدمه عندما تريد تنسيق طلب/استجابة أصلي لـ Gemini أو تكاملات بصيغة Gemini الموجودة مسبقًا.
  • aisonar-minimax: استخدمه عندما تريد MiniMax عبر مساره الأصلي.
إذا لم تكن بحاجة إلى سلوك Gemini الأصلي، فلا يزال بإمكانك استدعاء نماذج Gemini عبر aisonar/gemini-* على المسار المتوافق مع OpenAI.

​
الأخطاء الشائعة

تستخدم وثائق OpenClaw الحالية models.providers. إذا احتفظت بالتنسيق القديم لمصفوفة providers على المستوى العلوي، فقد يتجاهل OpenClaw التهيئة أو يفشل في حل بادئات الموفر كما هو متوقع.
تقوم openai-responses بالتوجيه إلى مسار /v1/responses الخاص بـ AI Sonar، لذلك يجب أن يستخدم aisonar-responses https://api.aisonar.dev/v1.
يجب أن تستخدم anthropic-messages وgoogle-generative-ai https://api.aisonar.dev بدون /v1. إضافة /v1 يمكن أن تُنتج مسارات طلب غير صحيحة.
نعم. لا تزال وثائق OpenClaw الحالية تتضمن الموفر المدمج google وتدعم أيضًا الموفرات المخصصة باستخدام api: "google-generative-ai". لذا يظل aisonar-gemini مسار Gemini أصليًا صالحًا لمستخدمي OpenClaw.

​
التحقق من الإعداد

بعد حفظ التهيئة، أعد تشغيل مثيل OpenClaw الخاص بك واختبر برسالة بسيطة. إذا رأيت استجابة، فالمزوّد مكوّن بشكل صحيح. 
# مستضاف ذاتيًا: أعد تشغيل الخدمة
systemctl --user restart openclaw    # Linux
launchctl stop cc.aisonar.openclaw && launchctl start cc.aisonar.openclaw  # macOS

​
الخطوات التالية

بمجرد اتصال OpenClaw، تساعدك هذه الأدلة على استخدام AI Sonar بشكل أكثر فعالية: