Providers

GitHub Copilot

GitHub Copilot هو مساعد البرمجة بالذكاء الاصطناعي من GitHub. وهو يتيح الوصول إلى نماذج Copilot لحسابك وخطتك على GitHub. يمكن لـ OpenClaw استخدام Copilot بوصفه موفّر نماذج أو بيئة تشغيل للوكيل بثلاث طرق مختلفة.

ثلاث طرق لاستخدام Copilot في OpenClaw

الموفّر المضمّن (github-copilot)

استخدم تدفق تسجيل الدخول الأصلي عبر الجهاز للحصول على رمز GitHub، ثم استبدله برموز Copilot API عند تشغيل OpenClaw. هذا هو المسار الافتراضي والأبسط لأنه لا يتطلب VS Code.

  • تشغيل أمر تسجيل الدخول

    bash
    openclaw models auth login-github-copilot

    سيُطلب منك زيارة عنوان URL وإدخال رمز يُستخدم مرة واحدة. أبقِ الطرفية مفتوحة حتى يكتمل الإجراء.

  • تعيين نموذج افتراضي

    bash
    openclaw models set github-copilot/claude-opus-4.7

    أو في الإعدادات:

    json5
    {  agents: {    defaults: { model: { primary: "github-copilot/claude-opus-4.7" } },  },}
  • Plugin لحاضنة Copilot SDK (copilot)

    ثبّت Plugin الخارجي @openclaw/copilot عندما تريد أن تتولى Copilot CLI وSDK من GitHub حلقة الوكيل منخفضة المستوى لنماذج github-copilot/* المحددة.

    bash
    openclaw plugins install @openclaw/copilot

    ثم فعّل بيئة التشغيل لنموذج أو موفّر:

    json5
    {  agents: {    defaults: {      model: "github-copilot/gpt-5.5",      models: {        "github-copilot/gpt-5.5": {          agentRuntime: { id: "copilot" },        },      },    },  },}

    اختر هذا عندما تريد جلسات Copilot CLI الأصلية، وحالة سلاسل المحادثات التي تديرها SDK، وCompaction الذي يديره Copilot لتلك الأدوار التي ينفذها الوكيل. من دون التفعيل الصريح عبر agentRuntime، تستمر نماذج github-copilot/* في استخدام الموفّر المضمّن. راجع حاضنة Copilot SDK للاطلاع على عقد بيئة التشغيل الكامل.

    Plugin وكيل Copilot (copilot-proxy)

    استخدم إضافة VS Code المسماة Copilot Proxy بوصفها جسرًا محليًا. يتصل OpenClaw بنقطة النهاية /v1 للوكيل (الافتراضية http://localhost:3000/v1) ويستخدم قائمة النماذج التي تضبطها.

    يأتي Plugin المسمى copilot-proxy مع OpenClaw ويكون مفعّلًا افتراضيًا. اضبط عنوان URL الأساسي ومعرّفات النماذج باستخدام:

    bash
    openclaw models auth login --provider copilot-proxy --set-default

    GitHub Enterprise (إقامة البيانات)

    إذا كانت مؤسستك تستخدم مستأجر GitHub Enterprise لإقامة البيانات (مضيفًا من نوع *.ghe.com مثل your-org.ghe.com)، فإن Copilot يعمل على نقاط نهاية محلية للمستأجر بدلًا من github.com العام. يوفّر OpenClaw هذا بوصفه خيار مصادقة أصيلًا، فلا تحتاج إلى تعديل عناوين URL يدويًا.

  • اختيار خيار مصادقة Enterprise

    في الإعداد الأولي أو openclaw models auth، اختر GitHub Copilot (Enterprise / data residency). سيُطلب منك إدخال نطاق Enterprise الخاص بك (مثل your-org.ghe.com)، ثم يُنفَّذ تسجيل الدخول عبر الجهاز على ذلك المستأجر.

    أدخل جذر المستأجر فقط (your-org.ghe.com). لا تُقبل مضيفات الخدمات المشتقة مثل api.your-org.ghe.com أو copilot-api.your-org.ghe.com؛ يشتق OpenClaw نقاط النهاية هذه تلقائيًا من جذر المستأجر.

    bash
    openclaw models auth login --provider github-copilot --method device-enterprise
  • حفظ النطاق في الإعدادات

    يُخزَّن المضيف المختار ضمن معاملات الموفّر، بحيث تستهدف عمليات تحديث الرمز والإكمال اللاحقة المستأجر تلقائيًا:

    json5
    {  models: {    providers: {      "github-copilot": { params: { githubDomain: "your-org.ghe.com" } },    },  },}
  • يتم توجيه تدفق الجهاز، واستبدال الرمز، وعمليات الإكمال على الترتيب إلى https://your-org.ghe.com/login/device/code، وhttps://api.your-org.ghe.com/copilot_internal/v2/token، وhttps://copilot-api.your-org.ghe.com. تحمل رموز إقامة البيانات وسمًا للمستأجر ولا تتضمن تلميحًا للوكيل، لذا يعود عنوان URL الأساسي للإكمال إلى مضيف Copilot الخاص بالمستأجر بدلًا من نقطة النهاية العامة.

    العلامات الاختيارية

    الأمر العلامة الوصف
    openclaw models auth login-github-copilot --yes استبدال ملف تعريف مصادقة موجود من دون مطالبة
    openclaw models auth login --provider github-copilot --method device --set-default تطبيق النموذج الافتراضي الموصى به من الموفّر أيضًا
    bash
    # تخطي تأكيد إعادة تسجيل الدخولopenclaw models auth login-github-copilot --yes # تسجيل الدخول وتعيين النموذج الافتراضي في خطوة واحدةopenclaw models auth login --provider github-copilot --method device --set-default

    الإعداد الأولي غير التفاعلي

    يتطلب تدفق تسجيل الدخول عبر الجهاز TTY تفاعليًا. للإعداد دون واجهة تفاعلية، استورد رمز وصول GitHub OAuth موجودًا باستخدام openclaw onboard --non-interactive:

    bash
    openclaw onboard --non-interactive --accept-risk \  --auth-choice github-copilot \  --github-copilot-token "$COPILOT_GITHUB_TOKEN" \  --skip-channels --skip-health

    يمكنك أيضًا حذف --auth-choice؛ إذ يؤدي تمرير --github-copilot-token إلى استنتاج خيار مصادقة موفّر GitHub Copilot. إذا حُذفت العلامة، يعود الإعداد الأولي إلى COPILOT_GITHUB_TOKEN، ثم GH_TOKEN، ثم GITHUB_TOKEN. استخدم --secret-input-mode ref مع تعيين COPILOT_GITHUB_TOKEN لتخزين tokenRef مستند إلى متغير بيئة بدلًا من نص صريح في auth-profiles.json.

    مطلوب TTY تفاعلي

    يتطلب تدفق تسجيل الدخول عبر الجهاز TTY تفاعليًا. شغّله مباشرة في طرفية، وليس في برنامج نصي غير تفاعلي أو مسار CI.

    توفر النماذج يعتمد على خطتك

    يعتمد توفر نماذج Copilot على خطة GitHub الخاصة بك. إذا رُفض نموذج، فجرّب معرّفًا آخر (مثل github-copilot/gpt-5.5). راجع النماذج المدعومة لكل خطة Copilot من GitHub للاطلاع على قائمة النماذج الحالية.

    تحديث الكتالوج المباشر من Copilot API

    بعد أن يحسم مسار المصادقة عبر تسجيل الدخول بالجهاز (أو متغير البيئة) رمز GitHub، يحدّث OpenClaw كتالوج النماذج عند الطلب من ${baseUrl}/models (نقطة النهاية نفسها التي يستخدمها VS Code Copilot)، بحيث تتتبّع بيئة التشغيل استحقاقات كل حساب ونوافذ السياق الدقيقة دون تغييرات متكررة في البيان. تصبح نماذج Copilot المنشورة حديثًا مرئية من دون ترقية OpenClaw، وتعكس نوافذ السياق الحدود الفعلية لكل نموذج (مثل 400 ألف لسلسلة gpt-5.x، ومليون للمتغيرات الداخلية claude-opus-*-1m).

    يظل الكتالوج الثابت المضمّن خيار الرجوع المرئي عند تعطيل الاكتشاف، أو عدم امتلاك المستخدم ملف تعريف مصادقة GitHub، أو فشل استبدال الرمز، أو حدوث خطأ في استدعاء HTTPS إلى /models. لإلغاء الاشتراك والاعتماد كليًا على كتالوج البيان الثابت (في سيناريوهات العمل دون اتصال أو الشبكات المعزولة):

    json5
    {  plugins: {    entries: {      "github-copilot": {        config: { discovery: { enabled: false } },      },    },  },}
    اختيار وسيلة النقل

    تستخدم معرّفات نماذج Claude وسيلة نقل Anthropic Messages تلقائيًا. تستخدم نماذج Gemini وسيلة نقل OpenAI Chat Completions؛ بينما تحتفظ نماذج GPT وسلسلة o بوسيلة نقل OpenAI Responses. يختار OpenClaw وسيلة النقل الصحيحة استنادًا إلى مرجع النموذج.

    توافق الطلبات

    يرسل OpenClaw ترويسات طلبات على نمط Copilot IDE عبر وسائل نقل Copilot (إصدارات محرر/Plugin في VS Code ومعرّف تكامل vscode-chat)، ويضع علامة على أدوار المتابعة لنتائج الأدوات بوصفها منشأة من الوكيل، ويعيّن ترويسة الرؤية الخاصة بـ Copilot عندما يتضمن الدور إدخال صورة.

    ترتيب حسم متغيرات البيئة

    يحسم OpenClaw مصادقة Copilot من متغيرات البيئة وفق ترتيب الأولوية التالي:

    الأولوية المتغير الملاحظات
    1 COPILOT_GITHUB_TOKEN الأولوية الأعلى، خاص بـ Copilot
    2 GH_TOKEN رمز GitHub CLI (خيار رجوع)
    3 GITHUB_TOKEN رمز GitHub القياسي (الأولوية الأدنى)

    عند تعيين عدة متغيرات، يستخدم OpenClaw المتغير الأعلى أولوية. يخزّن تدفق تسجيل الدخول عبر الجهاز (openclaw models auth login-github-copilot) رمزه في مخزن ملفات تعريف المصادقة، وتكون له الأولوية على جميع متغيرات البيئة.

    تخزين الرمز

    يخزّن تسجيل الدخول رمز GitHub في مخزن ملفات تعريف المصادقة (معرّف ملف التعريف github-copilot:github) ويستبدله برمز Copilot API قصير الأجل عند تشغيل OpenClaw. لا تحتاج إلى إدارة الرمز يدويًا.

    تضمينات البحث في الذاكرة

    يمكن أن يعمل GitHub Copilot أيضًا بوصفه موفّر تضمينات من أجل البحث في الذاكرة. إذا كان لديك اشتراك Copilot وسجّلت الدخول، فيمكن لـ OpenClaw استخدامه للتضمينات دون مفتاح API منفصل.

    الإعدادات

    عيّن memorySearch.provider صراحةً لاستخدام تضمينات GitHub Copilot. إذا كان رمز GitHub متاحًا، يكتشف OpenClaw نماذج التضمين المتاحة من Copilot API ويختار أفضلها تلقائيًا.

    json5
    {  agents: {    defaults: {      memorySearch: {        provider: "github-copilot",        // اختياري: تجاوز النموذج المكتشف تلقائيًا        model: "text-embedding-3-small",      },    },  },}

    آلية العمل

    1. يحسم OpenClaw رمز GitHub الخاص بك (من متغيرات البيئة أو ملف تعريف المصادقة).
    2. يستبدله برمز Copilot API قصير الأجل.
    3. يستعلم من نقطة نهاية Copilot المسماة /models لاكتشاف نماذج التضمين المتاحة.
    4. يختار أفضل نموذج (ترتيب التفضيل: text-embedding-3-small، وtext-embedding-3-large، وtext-embedding-ada-002).
    5. يرسل طلبات التضمين إلى نقطة نهاية Copilot المسماة /embeddings.

    يعتمد توفر النماذج على خطة GitHub الخاصة بك. إذا لم تتوفر نماذج تضمين، يتخطى OpenClaw موفّر Copilot ويجرّب الموفّر التالي.

    ذو صلة

    Was this useful?
    On this page

    On this page