الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

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

نظرة عامة

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

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

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

التكوين

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

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

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

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

المزوّدمرجع النموذجالوصف
lemondatalemondata/gpt-4oمسار متوافق مع OpenAI
lemondatalemondata/deepseek-r1نموذج استدلال DeepSeek
lemondata-responseslemondata-responses/gpt-4oمسار Responses API
lemondata-claudelemondata-claude/claude-sonnet-4-6مسار Claude Messages الأصلي
lemondata-geminilemondata-gemini/gemini-2.5-flashمسار Gemini الأصلي
lemondata-minimaxlemondata-minimax/minimax-m1مسار MiniMax الأصلي
تصفّح جميع النماذج المتاحة على lemondata.cc/models.

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

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

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

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

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

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

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

بمجرد اتصال OpenClaw، تساعدك هذه الأدلة على استخدام LemonData بشكل أكثر فعالية:
  • API Formats — فهم الفروقات بين مسارات OpenAI وResponses وAnthropic وGemini
  • IDE / SDK Compatibility — متى يكون /v1/responses الخيار الأنسب
  • Error Handling — تعرّف على أنماط الفشل الشائعة واستراتيجيات التعافي
  • Models Overview — تصفّح معرفات النماذج قبل توصيلها بالوكلاء