ثلاث طرق لاستخدام Copilot في OpenClaw
- الموفّر المضمّن (github-copilot)
- Plugin لحاضنة Copilot SDK (copilot)
- Plugin وكيل Copilot (copilot-proxy)
استخدم تدفق تسجيل الدخول الأصلي عبر الجهاز للحصول على رمز GitHub، ثم استبدله
برموز Copilot API عند تشغيل OpenClaw. هذا هو المسار الافتراضي والأبسط
لأنه لا يتطلب VS Code.سيُطلب منك زيارة عنوان URL وإدخال رمز يُستخدم مرة واحدة. أبقِ
الطرفية مفتوحة حتى يكتمل الإجراء.أو في الإعدادات:
1
تشغيل أمر تسجيل الدخول
2
تعيين نموذج افتراضي
GitHub Enterprise (إقامة البيانات)
إذا كانت مؤسستك تستخدم مستأجر GitHub Enterprise لإقامة البيانات (مضيفًا من نوع*.ghe.com مثل your-org.ghe.com)، فإن Copilot يعمل على نقاط نهاية
محلية للمستأجر بدلًا من github.com العام. يوفّر OpenClaw هذا بوصفه
خيار مصادقة أصيلًا، فلا تحتاج إلى تعديل عناوين URL يدويًا.
1
اختيار خيار مصادقة 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 نقاط النهاية هذه تلقائيًا من جذر المستأجر.2
حفظ النطاق في الإعدادات
يُخزَّن المضيف المختار ضمن معاملات الموفّر، بحيث تستهدف عمليات تحديث الرمز
والإكمال اللاحقة المستأجر تلقائيًا:
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 الخاص بالمستأجر بدلًا من نقطة النهاية العامة.
يؤدي تبديل النطاقات دائمًا إلى إعادة تشغيل تسجيل الدخول عبر الجهاز. إذا كان لديك بالفعل رمز
Copilot مخزّن واخترت نطاقًا مختلفًا (
github.com العام ↔ مستأجر
*.ghe.com، أو من مستأجر إلى آخر)، فلن يعيد OpenClaw استخدام الرمز الحالي —
بل يفرض تسجيل دخول جديدًا كي يقتصر نطاق الرمز على النطاق المكتوب في
الإعدادات. ومع ذلك، تتيح إعادة تسجيل الدخول إلى النطاق نفسه إعادة استخدام
الرمز الحالي. يؤدي الرجوع إلى github.com العام إلى مسح
githubDomain المحفوظ، لتعود الإعدادات إلى الوضع الافتراضي.يتجاوز متغير البيئة
COPILOT_GITHUB_DOMAIN النطاق المحسوم
لكل مسارات Copilot التي تحسمه — تسجيل دخول Enterprise عبر الجهاز
(--method device-enterprise)، والاختصار المستقل
openclaw models auth login-github-copilot، وتحديث الرمز، والتضمينات،
وعمليات الإكمال. عيّنه إلى مضيف *.ghe.com الخاص بك للإعدادات المؤتمتة بالكامل أو إعدادات CI.
اتركه دون تعيين (مع غياب معامل الإعدادات) لاستخدام github.com العام.
تحفظ عمليات تسجيل الدخول النطاق الذي أُصدر الرمز له (وتمسحه عند تسجيل الدخول
إلى github.com العام)، لذا يظل التوجيه صحيحًا حتى بعد إلغاء تعيين
متغير البيئة.العلامات الاختيارية
الإعداد الأولي غير التفاعلي
يتطلب تدفق تسجيل الدخول عبر الجهاز TTY تفاعليًا. للإعداد دون واجهة تفاعلية، استورد رمز وصول GitHub OAuth موجودًا باستخدامopenclaw onboard --non-interactive:
--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 تفاعلي
يتطلب تدفق تسجيل الدخول عبر الجهاز TTY تفاعليًا. شغّله مباشرة في
طرفية، وليس في برنامج نصي غير تفاعلي أو مسار CI.
توفر النماذج يعتمد على خطتك
توفر النماذج يعتمد على خطتك
يعتمد توفر نماذج Copilot على خطة GitHub الخاصة بك. إذا رُفض نموذج،
فجرّب معرّفًا آخر (مثل
github-copilot/gpt-5.5). راجع
النماذج المدعومة لكل خطة Copilot من GitHub
للاطلاع على قائمة النماذج الحالية.تحديث الكتالوج المباشر من Copilot API
تحديث الكتالوج المباشر من Copilot API
بعد أن يحسم مسار المصادقة عبر تسجيل الدخول بالجهاز (أو متغير البيئة) رمز GitHub،
يحدّث OpenClaw كتالوج النماذج عند الطلب من
${baseUrl}/models
(نقطة النهاية نفسها التي يستخدمها VS Code Copilot)، بحيث تتتبّع بيئة التشغيل
استحقاقات كل حساب ونوافذ السياق الدقيقة دون تغييرات متكررة في البيان.
تصبح نماذج Copilot المنشورة حديثًا مرئية من دون ترقية OpenClaw،
وتعكس نوافذ السياق الحدود الفعلية لكل نموذج
(مثل 400 ألف لسلسلة gpt-5.x، ومليون للمتغيرات الداخلية
claude-opus-*-1m).يظل الكتالوج الثابت المضمّن خيار الرجوع المرئي عند تعطيل الاكتشاف،
أو عدم امتلاك المستخدم ملف تعريف مصادقة GitHub، أو فشل استبدال الرمز،
أو حدوث خطأ في استدعاء HTTPS إلى /models. لإلغاء الاشتراك والاعتماد كليًا
على كتالوج البيان الثابت (في سيناريوهات العمل دون اتصال أو الشبكات المعزولة):اختيار وسيلة النقل
اختيار وسيلة النقل
تستخدم معرّفات نماذج Claude وسيلة نقل Anthropic Messages تلقائيًا.
تستخدم نماذج Gemini وسيلة نقل OpenAI Chat Completions؛ بينما تحتفظ نماذج GPT
وسلسلة o بوسيلة نقل OpenAI Responses. يختار OpenClaw وسيلة
النقل الصحيحة استنادًا إلى مرجع النموذج.
توافق الطلبات
توافق الطلبات
يرسل OpenClaw ترويسات طلبات على نمط Copilot IDE عبر وسائل نقل Copilot
(إصدارات محرر/Plugin في VS Code ومعرّف تكامل
vscode-chat)،
ويضع علامة على أدوار المتابعة لنتائج الأدوات بوصفها منشأة من الوكيل، ويعيّن ترويسة
الرؤية الخاصة بـ Copilot عندما يتضمن الدور إدخال صورة.ترتيب حسم متغيرات البيئة
ترتيب حسم متغيرات البيئة
يحسم OpenClaw مصادقة Copilot من متغيرات البيئة وفق ترتيب
الأولوية التالي:
عند تعيين عدة متغيرات، يستخدم 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 ويختار أفضلها تلقائيًا.
آلية العمل
- يحسم OpenClaw رمز GitHub الخاص بك (من متغيرات البيئة أو ملف تعريف المصادقة).
- يستبدله برمز Copilot API قصير الأجل.
- يستعلم من نقطة نهاية Copilot المسماة
/modelsلاكتشاف نماذج التضمين المتاحة. - يختار أفضل نموذج (ترتيب التفضيل:
text-embedding-3-small، وtext-embedding-3-large، وtext-embedding-ada-002). - يرسل طلبات التضمين إلى نقطة نهاية Copilot المسماة
/embeddings.
ذو صلة
اختيار النموذج
اختيار المزوّدين ومراجع النماذج وسلوك التحويل عند الفشل.
OAuth والمصادقة
تفاصيل المصادقة وقواعد إعادة استخدام بيانات الاعتماد.