OpenClaw تكوين Claude بطريقتين: وضع التوافق مع OpenAI مقابل التنسيق الأصلي لـ Claude – دليل كامل

description: دليل شامل لتكوين OpenClaw مع وضع التوافق مع OpenAI والتنسيق الأصلي لـ Claude، يتضمن أكواد JSON كاملة، قائمة النماذج المناسبة، ومقارنة الفروق الرئيسية

ملاحظة المؤلف: دليل تفصيلي خطوة بخطوة لتكوين OpenClaw مع وضع التوافق مع OpenAI والتنسيق الأصلي لـ Claude، يتضمن أكواد JSON كاملة، قائمة النماذج المناسبة، ومقارنة الفروق الرئيسية

في OpenClaw (Open WebUI)، هناك طريقتان لربط نماذج اللغة الكبيرة: وضع التوافق مع OpenAI (openai-completions) والتنسيق الأصلي لـ Claude (anthropic-messages). كثير من المستخدمين لا يدركون الفرق بينهما، مما يؤدي إما إلى استخدام التنسيق الخاطئ مع نماذج Claude، أو تفويت الميزات المتقدمة مثل Prompt Caching التي يوفرها التنسيق الأصلي.

القيمة الأساسية: بعد قراءة هذه المقالة، ستتمكن من إتقان طرق التكوين الكاملة لكلا الوضعين في OpenClaw، وتحديد التنسيق المناسب لكل نموذج، وستكون قادرًا على نسخ أكواد التكوين واستخدامها مباشرة.

مقارنة أساسية بين طريقتين للوصول إلى OpenClaw

ملخص سريع للطريقتين للوصول إلى OpenClaw

تذكر قاعدة بسيطة: استخدم anthropic-messages لنماذج سلسلة Claude، واستخدم openai-completions لجميع النماذج الأخرى. الفرق الأكثر وضوحًا بينهما هو baseUrl – وضع التوافق مع OpenAI ينتهي بـ /v1، بينما تنسيق Claude الأصلي لا ينتهي به.

برنامج تعليمي لتكوين وضع التوافق مع OpenAI في OpenClaw

حالات الاستخدام لوضع التوافق مع OpenAI

وضع التوافق مع OpenAI (openai-completions) هو أكثر طرق الوصول شيوعًا في OpenClaw، وهو مناسب لجميع نماذج اللغة الكبيرة غير Claude. معظم خدمات وكيل API تستخدم هذا التنسيق الموحد من OpenAI.

كود التكوين الكامل لوضع التوافق مع OpenAI

فيما يلي التكوين الكامل للوصول إلى GPT-5.4 عبر APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

نقاط مهمة في تكوين وضع التوافق مع OpenAI

🎯 تذكير بالتكوين: لا يمكن حذف /v1 في نهاية baseUrl، فهذا هو المسار القياسي لبروتوكول التوافق مع OpenAI. قم بالتسجيل على APIYI apiyi.com للحصول على مفتاح API والرصيد المجاني.

حالات استخدام تنسيق Claude الأصلي

تنسيق Claude الأصلي (anthropic-messages) هو طريقة الوصول الحصرية لنماذج Claude. باستخدام التنسيق الأصلي، يمكنك الحصول على ميزات متقدمة فريدة من نوعها في Claude مثل:

• تخزين الموجهات مؤقتًا (Prompt Caching)
• التفكير الممتد (Extended Thinking)
• معالجة ملفات PDF

كود التكوين الكامل لتنسيق Claude الأصلي

إليك التكوين الكامل للوصول إلى نموذج Claude عبر APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

نقاط مهمة في تكوين تنسيق Claude الأصلي

🎯 الفرق الرئيسي: عنوان URL الأساسي لتنسيق Claude الأصلي بدون /v1. هذا هو الخطأ الأكثر شيوعًا للمبتدئين – إذا واجهت خطأً في الوصول إلى Claude، تحقق أولاً مما إذا كان قد تمت إضافة /v1 عن طريق الخطأ في نهاية عنوان URL.

تكوين OpenClaw لاستخدام التنسيقين معًا

في الاستخدام العملي، من المحتمل أن تحتاج إلى استخدام النماذج العامة ونماذج Claude معًا. في هذه الحالة، تحتاج إلى تكوين مزودين (provider) في OpenClaw:

كود التكوين المدمج للمزودين المزدوجين

اكتب مزودي التنسيقين في ملف تكوين واحد، وستتمكن من التبديل بحرية بين النماذج في OpenClaw:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-مفتاح API الخاص بك",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 ملاحظة مهمة: يمكن للمزودين استخدام نفس مفتاح API. مفتاح APIYI الواحد يدعم تنسيق OpenAI المتوافق وتنسيق Claude الأصلي معًا، ولا حاجة لطلب مفاتيح متعددة.

استكشاف الأخطاء الشائعة في تنسيقي OpenClaw

أكثر الأخطاء شيوعًا أثناء التهيئة هي عدم تطابق baseUrl مع نوع API. فيما يلي الأخطاء الشائعة وحلولها:

🎯 قاعدة استكشاف الأخطاء السريعة: تنسيق OpenAI يحتوي على /v1، تنسيق Claude لا يحتوي على /v1. تذكر هذه القاعدة لتجنب 80% من أخطاء التهيئة. إذا واجهت مشكلات أخرى، يمكنك زيارة مركز الوثائق في APIYI على apiyi.com لعرض دليل التكامل الكامل.

الأسئلة الشائعة

الخلاصة

النقاط الأساسية لطريقتين للاتصال بـ OpenClaw:

1. النماذج العامة تستخدم openai-completions: جميع النماذج غير Claude مثل GPT و Gemini و DeepSeek و GLM و Kimi و Grok و Minimax، حيث يكون baseUrl يحتوي على /v1
2. سلسلة Claude تستخدم anthropic-messages: مثل claude-sonnet-4-6 و claude-opus-4-6 و claude-haiku، حيث يكون baseUrl بدون /v1، ويتطلب رأس anthropic-version
3. وجود مزودين (Provider) معًا هو أفضل ممارسة: تكوين مفتاح API واحد مع مزودين، والتبديل بحرية بين جميع النماذج في OpenClaw

يوصى بالحصول على مفتاح API من خلال APIYI على apiyi.com، حيث يمكن لمفتاح واحد الوصول إلى جميع النماذج الرئيسية مثل GPT و Claude و Gemini و DeepSeek، مع دعم كل من تنسيق OpenAI المتوافق وتنسيق Claude الأصلي.

📚 المراجع

1. مركز مساعدة APIYI: برنامج تعليمي كامل لتهيئة اتصال OpenClaw

   • الرابط: help.apiyi.com
   • الوصف: يحتوي على وثائق اتصال مفصلة لكل موقع وقائمة أحدث النماذج

2. وثائق Anthropic API: مواصفات تنسيق API الأصلي لـ Claude

   • الرابط: platform.claude.com/docs/en/api/messages
   • الوصف: المعلمات الكاملة وتنسيق الاستجابة لـ Messages API

3. وثائق توافق OpenAI SDK: المعلمات التي يتم تجاهلها على Claude

   • الرابط: platform.claude.com/docs/en/api/openai-sdk
   • الوصف: القائمة الكاملة للمعلمات المدعومة وغير المدعومة

4. وثائق Open WebUI: دليل تكوين متعدد المزودين لـ OpenClaw

   • الرابط: docs.openwebui.com
   • الوصف: تكوين المزود، إدارة النماذج، وإعدادات الوكيل (Agent)

المؤلف: فريق APIYI التقني
التواصل التقني: نرحب بالنقاش في قسم التعليقات، للمزيد من المواد يمكن زيارة مركز وثائق APIYI على docs.apiyi.com